Start building awesome documentation in under 5 minutes
Learn how to update your docs locally and deploy them to the public.
Clone your docs locally
During the onboarding process, we created a repository on your Github with your docs content. You can find this repository on our dashboard. To clone the repository locally, follow these instructions in your terminal.
Preview changes
Previewing helps you make sure your changes look as intended. We built a
command line interface to render these changes locally. 1. Install the
Mintlify CLI to preview the
documentation changes locally with this command: npm i -g mintlify
2. Run the following command at the root of your documentation (where
mint.json
is): mintlify dev
Install our Github app
Our Github app automatically deploys your changes to your docs site, so you don’t need to manage deployments yourself. You can find the link to install on your dashboard. Once the bot has been successfully installed, there should be a check mark next to the commit hash of the repo.
Push your changes
Commit and push your changes to Git for your changes to update in your docs site. If you push and don’t see that the Github app successfully deployed your changes, you can also manually update your docs through our dashboard.
Add content directly in your files with MDX syntax and React components. You can use any of our components, or even build your own.
Add flair to your docs with personalized branding.
Implement your OpenAPI spec and enable API user interaction.
Draw insights from user interactions with your documentation.
Keep your docs on your own website’s subdomain.
Start building awesome documentation in under 5 minutes
Learn how to update your docs locally and deploy them to the public.
Clone your docs locally
During the onboarding process, we created a repository on your Github with your docs content. You can find this repository on our dashboard. To clone the repository locally, follow these instructions in your terminal.
Preview changes
Previewing helps you make sure your changes look as intended. We built a
command line interface to render these changes locally. 1. Install the
Mintlify CLI to preview the
documentation changes locally with this command: npm i -g mintlify
2. Run the following command at the root of your documentation (where
mint.json
is): mintlify dev
Install our Github app
Our Github app automatically deploys your changes to your docs site, so you don’t need to manage deployments yourself. You can find the link to install on your dashboard. Once the bot has been successfully installed, there should be a check mark next to the commit hash of the repo.
Push your changes
Commit and push your changes to Git for your changes to update in your docs site. If you push and don’t see that the Github app successfully deployed your changes, you can also manually update your docs through our dashboard.
Add content directly in your files with MDX syntax and React components. You can use any of our components, or even build your own.
Add flair to your docs with personalized branding.
Implement your OpenAPI spec and enable API user interaction.
Draw insights from user interactions with your documentation.
Keep your docs on your own website’s subdomain.