mint

$3

Download the Mint CLI using the following command

``
npm i -g mint
`

$3

#### mint dev

Run this command at the root of your Mintlify project to preview changes locally.

Notes

- mint dev requires Node v19 or higher.

#### Custom Ports

Mintlify uses port 3000 by default. You can use the --port flag to customize the port Mintlify runs on. For example, use this command to run in port 3333:

`
mint dev --port 3333
`

You will see an error like this if you try to run Mintlify in a port that's already taken:

`
Error: listen EADDRINUSE: address already in use :::3000
`

#### Troubleshooting

Steps you can take if the dev CLI is not working (After each step try to run mint dev again):

- Make sure you are running in a folder with a docs.json file.
- Run mint update to ensure you have the most recent version of the CLI.
- Make sure you are using Node v19 or higher.
- Navigate to the .mintlify folder in your home directory and delete its contents.

$3

#### mint broken-links

Check for broken internal links in your Mintlify project.

#### mint rename

Rename a file in a Mintlify project and update all internal link references.

#### mint openapi-check

Check your OpenAPI file for errors. You can pass in a filename (e.g. ./openapi.yaml) or a URL (e.g. https://petstore3.swagger.io/api/v3/openapi.json).

#### mint update

Updates to the most recent version of the Mint CLI.

#### mint upgrade

Upgrade from mint.json to docs.json. This command creates a docs.json from your existing mint.json`.

$3

Create an account to start using Mintlify for your documentation.