docs/README.md
Welcome to the home of Mastra's documentation! Everything you see on mastra.ai/docs is sourced from this directory.
Want to contribute? Check out our contribution guidelines for details on how to get started.
Here's a quick start to run the docs locally
Install dependencies:
pnpm install
Start the development server:
pnpm run dev
To lint markdown files according to remark rules (e.g. enforcing consistent heading levels, list markers, etc.), you can use remark:
pnpm run lint:remark
Vale is a syntax-aware linter for prose that can help enforce style and grammar rules. We use it to maintain consistency across our documentation.
Run the Vale download script to fetch a binary:
pnpm run vale:download
Install mdx2vast globally, which is a dependency for Vale to lint MDX files:
npm install -g mdx2vast
Then you can run the Vale linter:
pnpm run lint:vale