> ## Documentation Index
> Fetch the complete documentation index at: https://labs.prompthon.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Local Debugging

<div className="not-prose my-4 rounded-md border border-gray-200 bg-gray-50 p-2 text-sm dark:border-gray-800 dark:bg-gray-900/40">
  <div className="mb-2 px-1 text-xs font-semibold uppercase tracking-wide text-gray-500 dark:text-gray-400">Need help?</div>

  <div className="flex flex-wrap gap-2">
    <a className="inline-flex items-center gap-2 rounded-md border border-gray-200 bg-white px-3 py-1.5 font-medium text-gray-700 no-underline shadow-sm hover:border-gray-300 hover:bg-gray-50 dark:border-gray-800 dark:bg-gray-950/60 dark:text-gray-200 dark:hover:bg-gray-900" href="https://discord.gg/sDE2HhGTg4" target="_blank" rel="noreferrer">
      <Icon icon="discord" iconType="brands" size={14} />

      <span>Ask in Discord</span>
    </a>

    <a className="inline-flex items-center gap-2 rounded-md border border-gray-200 bg-white px-3 py-1.5 font-medium text-gray-700 no-underline shadow-sm hover:border-gray-300 hover:bg-gray-50 dark:border-gray-800 dark:bg-gray-950/60 dark:text-gray-200 dark:hover:bg-gray-900" href="https://github.com/Prompthon-IO/agent-systems-handbook/issues/new/choose" target="_blank" rel="noreferrer">
      <Icon icon="github" iconType="brands" size={14} />

      <span>Open a GitHub issue</span>
    </a>

    <a className="inline-flex items-center gap-2 rounded-md border border-gray-200 bg-white px-3 py-1.5 font-medium text-gray-700 no-underline shadow-sm hover:border-gray-300 hover:bg-gray-50 dark:border-gray-800 dark:bg-gray-950/60 dark:text-gray-200 dark:hover:bg-gray-900" href="https://github.com/Prompthon-IO/agent-systems-handbook/blob/main/SUPPORT.md" target="_blank" rel="noreferrer">
      <Icon icon="life-ring" size={14} />

      <span>Support guide</span>
    </a>
  </div>
</div>

Use this workflow to preview and validate the public documentation site before
opening a pull request.

## Where the site lives

The Mintlify site is configured from the repository root. There is no nested
frontend app and no required `package.json`.

Key files:

* `docs.json` controls the Mintlify navigation and site settings.
* `index.mdx` is the Mintlify homepage.
* `*.mdx` files are the single source for published documentation pages.
* `.mintignore` keeps local-only and raw source material out of the published
  documentation site.

## Start the preview

Install Node.js 20.17.0 or newer. The repository includes `.nvmrc` and
`.node-version` with the minimum supported version.

If you use `nvm`, run:

```bash theme={null}
nvm install
nvm use
```

Then run from the repository root:

```bash theme={null}
npx mint dev --port 3333
```

Open `http://localhost:3333`.

## Validate before review

Run the same checks from the repository root:

```bash theme={null}
npx mint validate
npx mint broken-links
```

`mint broken-links` may print parser warnings from ignored raw reference
material. The check should still finish with no broken links for the published
site.

## When adding or moving pages

1. Edit or create the `.mdx` page.
2. Add or update the route in `docs.json`.
3. Preview the exact route locally.
4. Run `npx mint validate` before committing.

Use extensionless internal routes in Mintlify navigation and cards, such as
`/reading-paths/explorer`, not `/reading-paths/explorer.mdx`.