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

# Development

> Run the docs site locally

<Info>
  Requires Node.js 19+ and the Mintlify CLI.
</Info>

## Install the CLI

```bash theme={}
npm i -g mint
```

## Preview locally

From the repository root (where `docs.json` lives):

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

The site is served at `http://localhost:3000` with hot reload.

To pick a different port:

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

## Pull in project docs

The Guides/Knowledge tabs are committed to this repo; project tabs (marchyo, jotain, jstack) are pulled at build time. To preview them locally, enter the devenv shell and run:

```bash theme={}
aggregate-docs
```

This clones each project repo, copies its `docs/` directory into this tree, and merges its navigation into `docs.json`. The script is defined in `devenv.nix`.

## Validate links

```bash theme={}
mint broken-links
```

## Deployment

CI builds the `docs` branch from `main` daily and on push. Mintlify's GitHub app deploys from the `docs` branch automatically. See `.github/workflows/multirepo-docs.yml`.

## Updating the CLI

```bash theme={}
npm i -g mint
```

If a preview misbehaves after an update, clear the cache:

```bash theme={}
rm -rf ~/.mintlify
```