These docs are not Mintlify-hosted. Source .mdx lives in docs-site/; a Python build script compiles it to static HTML in client/public/docs/, which Express serves at /docs. (mint.json is retained for reference but does not drive the build.)

Build the docs

Install the one dependency (once)

```bash
pip install markdown
```

Build

From the repo root:
```bash
python scripts/build-docs.py
```
This reads `docs-site/**/*.mdx` and writes static HTML to `client/public/docs/`.

Preview

Serve `client/public/` and open `/docs/` — e.g.:
```bash
python -m http.server 4599 --directory client/public
# http://localhost:4599/docs/
```
In production the running app serves the same files at `/docs`.

Add or edit a page

Edit the source

Create or edit the `.mdx` under `docs-site/` (e.g. `docs-site/process/my-new-sop.mdx`).

Register it in the nav

Add the page to the `NAV` array in `scripts/build-docs.py` (the build script's nav is
the source of truth — not `mint.json`). Mark its group `"internal": True` if it should be
gated to platform staff.

Rebuild and commit BOTH

```bash
python scripts/build-docs.py
```
Commit the edited `.mdx` **and** the regenerated `client/public/docs/*.html`. The HTML is
the deployed artifact — if you commit only the `.mdx`, the live site stays stale.

Access tiers