# Local development

Preview and edit the Hostraha docs on your own machine.

Run these docs locally to preview changes before you publish them. Edits to `.mdx` files and `docs.json` reload in the browser as you save.

## Prerequisites

- Node.js version 19 or higher, up to the current LTS. Mintlify does not support Node 25 or later, so use an LTS release such as Node 22.
- The Mintlify CLI installed globally.

<Info>
  Check your version with `node --version`. If you run a newer release, use a version manager such as `nvm` to switch to Node 22.
</Info>

## Install the CLI

```bash
npm i -g mint
```

## Preview locally

Run the dev server from the directory that contains `docs.json`:

```bash
mint dev
```

The preview is available at `http://localhost:3000`. To use a different port:

```bash
mint dev --port 3333
```

## Validate before publishing

<Steps>
  <Step title="Check for broken links">
    ```bash
    mint broken-links
    ```
  </Step>
  <Step title="Check accessibility">
    ```bash
    mint a11y
    ```
  </Step>
</Steps>

## Troubleshooting

<AccordionGroup>
  <Accordion title="The CLI reports an unsupported Node version">
    Mintlify does not run on Node 25 or later. Switch to an LTS release:

    ```bash
    nvm install 22
    nvm use 22
    ```
  </Accordion>
  <Accordion title="Changes are not showing up">
    Reinstall the CLI to get the latest version, then restart the dev server:

    ```bash
    npm i -g mint@latest
    ```
  </Accordion>
</AccordionGroup>