Mintfree CLI

Build a static docs site from a Mintlify docs source directory.

Requires Node.js 20+.

What it does

1. Copies your Mintlify docs source into a temp workspace.
2. Runs @mintlify/prebuild against that workspace.
3. Converts prebuild output (src/_props) into a rich static page manifest with navigation, search index, and heading metadata.
4. Renders pages using a swappable theme system (default: mintlike) and reuses Mintlify components where practical.
5. Generates precomputed text files:
   • robots.txt
   • sitemap.xml
   • llms.txt
   • llms-full.txt
6. Renders HTML through a prebundled standalone Next runtime and writes static output to out/.

Usage

cd mintfree-cli
npm install
npx mintfree build ../docstest

Optional base URL for sitemap/llms links:

npx mintfree build ../docstest --base-url https://docs.example.com

Optional theme override:

npx mintfree build ../docstest --theme mintlike

The static output is written to:

• out/

Dev mode (watch + auto-reload)

cd mintfree-cli
npm install
npx mintfree dev ../docstest --port 3333

This starts a local static server and rebuilds when docs/theme files change.

Rollup bundle

cd mintfree-cli
npm install
npm run bundle

This generates:

• a minified publishable CLI entry at bin/mintfree.cjs
• a prebuilt standalone Next runtime at runtime/client/

The published package uses the standalone runtime, so Next app source folders are not required at runtime.