Follow the full quickstart guide
Install the Mintlify CLI to preview your documentation changes locally. To install it alongside the necessary dependencies, use the following command:
npm ci
To start a local preview, run the following command at the root of your documentation, where your docs.json
is located:
npm start
View your local preview at http://localhost:3000
.
Note
Automatic spelling checks are performed for changed files in each Pull Request.
To check spelling of all files, run:
npm run check:spell
# or simply:
npm run spell
To check spelling of some selected files, run:
npm run spell:some <FILES...>
The dictionaries (or vocabularies) for custom words are placed under resources/dictionaries
. There, each dictionary describes additional allowed or invalid entries.
The primary dictionary is resources/dictionaries/custom.txt
— extend it in case a word exists but was flagged by CSpell as invalid, or in cases where the word does not exist and shall be prohibited. For the latter, use the !
prefix when adding words.
See more: CSpell docs on custom dictionaries.
Note
Automatic formatting checks are performed for changed files in each Pull Request.
To check formatting of all files, run:
npm run check:fmt
To fix formatting of all files, run:
npm run fmt
To check and fix formatting of some selected files, run:
npm run fmt:some <FILES...>
See the snippets/
directory and the corresponding docs in contribute/snippets/
MDX files.
Mintlify's GitHub app is connected to this repository. Thus, changes are deployed to production automatically after pushing to the default branch (main
).
- If your dev environment is not running: Run
mint update
to ensure you have the most recent version of the CLI. - If a page loads as a 404: Make sure you are running in a folder with a valid
docs.json
.