To preview the Mintlify documentation locally, follow these steps:
From the mintlify-docs directory:
cd mintlify-docs
npx mintlify devThis will start the preview server at http://localhost:3000 without needing to install anything globally.
If you prefer to install it globally:
npm install -g mintlify
# or
npm install -g mintThen run:
cd mintlify-docs
mintlify dev
# or
mint devOnce the server starts, you can:
- View the documentation at
http://localhost:3000 - See live reload as you edit the
.mdxfiles - Navigate through all the pages:
- Overview
- Installation
- Configuration
- Connecting Wallets
- Transactions
- ERC20
- Staking
- Troubleshooting
- API Reference
If you encounter issues:
-
Port already in use: Use a different port
mintlify dev --port 3001
-
Configuration errors: Make sure
mint.jsonis in themintlify-docsdirectory -
Missing files: Ensure all
.mdxfiles are inbuild/consumer-app-sdk/
After previewing, you can:
- Copy the
build/consumer-app-sdk/directory to the starknet-docs repository - Update the navigation in starknet-docs to include the new section
- Test the integration in the full docs site