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 ciTo start a local preview, run the following command at the root of your documentation, where your docs.json is located:
npm startView 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 spellTo 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:fmtTo fix formatting of all files, run:
npm run fmtTo 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 updateto 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.