> ## Documentation Index
> Fetch the complete documentation index at: https://docs.silo-software.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Development

> Learn how to preview changes locally

<Info>
  **Prerequisite** You should have installed Node.js (version 20.17.0 or
  higher).
</Info>

Step 1. Install the Mint CLI:

<CodeGroup>
  ```bash npm theme={"system"}
  npm i -g mint
  ```

  ```bash pnpm theme={"system"}
  pnpm add -g mint
  ```
</CodeGroup>

Step 2. Go to the root of your docs app (where `docs.json` lives) and run:

```bash theme={"system"}
mint dev
```

The documentation website is now available at `http://localhost:3000`.

### Custom Ports

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

```bash theme={"system"}
mint dev --port 3333
```

If the port is already taken, Mint falls back to the next available port:

```md theme={"system"}
Port 3000 is already in use. Trying 3001 instead.
```

If you do not want to install the CLI globally, you can also run:

```bash theme={"system"}
npx mint dev
```

## CLI Versions

Each CLI is linked to a specific version of Mintlify. Please update the CLI if your local website looks different than production.

<CodeGroup>
  ```bash npm theme={"system"}
  mint update
  ```

  ```bash npm theme={"system"}
  npm i -g mint@latest
  ```
</CodeGroup>

## Deployment

<Tip>
  Unlimited editors available under the [Startup
  Plan](https://mintlify.com/pricing)
</Tip>

You should see the following if the deploy successfully went through:

<Frame>
  <img src="https://mintcdn.com/silo/fmtjZmpExwWhBGhp/images/checks-passed.png?fit=max&auto=format&n=fmtjZmpExwWhBGhp&q=85&s=73a8b008a4f06db2b292bd9052386076" style={{ borderRadius: '0.5rem' }} width="1100" height="346" data-path="images/checks-passed.png" />
</Frame>

## Troubleshooting

Here's how to solve some common problems when working with the CLI.

<AccordionGroup>
  <Accordion title="Mint is not loading">
    Verify that you are on Node.js v20.17.0 or newer. Then run `mint update`
    and try `mint dev` again.
  </Accordion>

  <Accordion title="Getting an unknown error">
    Try navigating to the root of your device and delete the \~/.mintlify folder.
    Then run `mint dev` again.
  </Accordion>
</AccordionGroup>

Curious about what changed recently? [Check the Mintlify product updates](https://mintlify.com/docs/changelog).