Before you begin, make sure you have Node.js 20–24 installed (Mintlify does not support Node 25+).
Install Node.js (includes npm)
macOS (via Homebrew):
brew install node@22Windows (via winget):
winget install OpenJS.NodeJS.LTSAfter installing, verify with:
node -v
npm -v1. Install the Mintlify CLI:
npm i -g mint2. Navigate to the docs directory (where docs.json is located) and start the local preview:
mint devAlternatively, without installing the CLI globally :
npx mint devA local preview of your documentation will be available at http://localhost:3000.
Please note that the rendering behavior in the local preview may differ from the deployed version. The deployed result should be considered as the final reference.