Quickstart

Deploy your documentation site and make your first change.

Deploy your site

Go to mintlify.com/start to create your documentation site. You’ll connect your GitHub account and create a repository for your docs.

Your site deploys to https://<your-project-name>.mintlify.app. Find your URL on the dashboard.

Make your first change

CLI

1. Install the CLI

   npm

   npm i -g mint
   
2. Edit a page

   Open index.mdx and update the description:

   ---
   title: "Introduction"
   description: "Your custom description here"
   ---
   
3. Preview locally

   mint dev
   

   View at http://localhost:3000.

4. Push changes

   git add .
   git commit -m "Update description"
   git push
   

Web editor

1. Open the editor

   Go to the web editor.

2. Edit a page

   Open index.mdx and update the description:

   ---
   title: "Introduction"
   description: "Your custom description here"
   ---
   
3. Publish

   Click Publish in the toolbar.

Next steps

Use the web editor

Edit documentation in your browser.

Explore CLI commands

Find broken links, validate specs, and more.

Add a custom domain

Use your own domain.