stack/docs-mintlify
2026-04-07 09:26:04 -07:00
..
api Move docs from /docs into /guides 2026-04-06 17:21:49 -07:00
guides Fix docs icon size 2026-04-06 22:41:39 -07:00
images App icons in Mintlify docs sidebar 2026-04-06 19:23:10 -07:00
sdk Move docs from /docs into /guides 2026-04-06 17:21:49 -07:00
snippets Update to support deprecation 2026-04-03 13:16:59 -05:00
docs.json Fix docs icon size 2026-04-06 22:41:39 -07:00
index.mdx Move docs from /docs into /guides 2026-04-06 17:21:49 -07:00
package.json Remove mintlify build 2026-04-07 09:26:04 -07:00
README.md Add Mintlify docs to pnpm run dev 2026-04-06 13:47:53 -07:00
style.css Fix docs icon size 2026-04-06 22:41:39 -07:00

docs-mintlify

How to run the Mintlify docs preview locally from this repository.

Prerequisites

  • Node.js >=20.17.0
  • pnpm
  • Repository dependencies installed (pnpm install from repo root)

Run locally

From the repository root:

pnpm -C docs-mintlify run dev

This starts Mintlify in docs-mintlify on http://localhost:${NEXT_PUBLIC_STACK_PORT_PREFIX:-81}04 (for example, http://localhost:8104 with the default prefix).

From inside docs-mintlify, you can also run:

pnpm dev

Useful variants:

# Override the default port
pnpm -C docs-mintlify run dev -- --port 3333

# Skip OpenAPI processing for faster iteration
pnpm -C docs-mintlify run dev -- --disable-openapi

Search + assistant in local preview

If you want local search and the Mintlify assistant:

pnpm -C docs-mintlify run login
pnpm -C docs-mintlify run status

Then re-run pnpm -C docs-mintlify run dev.

Package scripts

From repo root:

pnpm -C docs-mintlify run lint
pnpm -C docs-mintlify run typecheck
pnpm -C docs-mintlify run build
pnpm -C docs-mintlify run clean

lint runs both mint validate and mint broken-links.