Prerequisites:
- Node.js version 19 or higher
- Access to the docs.clarivo.co repository
Run the docs locally
Custom ports
By default the preview runs on port 3000. Use--port to change it:
Validate links
Before opening a PR, check for broken links:Deployment
Changes merged tomain are deployed automatically. A successful deployment shows:

Code formatting
For VSCode users, install:- MDX VSCode extension — MDX syntax highlighting
- Prettier — consistent formatting
Troubleshooting
Error: Could not load the "sharp" module using the darwin-arm64 runtime
Error: Could not load the "sharp" module using the darwin-arm64 runtime
This is usually caused by an outdated Node version:
- Remove the CLI:
npm remove -g mint - Upgrade to Node v19 or higher
- Reinstall:
npm i -g mint
Issue: Encountering an unknown error
Issue: Encountering an unknown error
Delete the local Mintlify cache and restart:
