Deploy Mintlify docs

The Mintlify project lives in:

pinter-fe/docs

Run Mintlify commands from that directory.

Run locally

Install the CLI once:

npm i -g mint

Start the docs server:

cd pinter-fe/docs
mint dev --port 3001

Use 3001 because the Pinter frontend commonly uses 3000.

cd pinter-fe/docs
mint validate
mint broken-links

From the repository root:

bun run --cwd pinter-fe docs:validate
bun run --cwd pinter-fe docs:links

For local preview with scripts:

bun run --cwd pinter-fe docs:dev

If the Git repository root is pinter-fe, set the docs directory path to:

/docs

If the Git repository root is PINTER_ADK, set the docs directory path to:

/pinter-fe/docs

The API reference tab generates endpoint pages from docs/openapi.json. When backend routes change, regenerate the schema:

cd pinter-be
python scripts/export_openapi.py

Copy it into the docs project:

cp docs/openapi.json ../pinter-fe/docs/openapi.json

The endpoint pages rebuild from the new schema automatically.