Deploy the Manual

The manual is a separate static app in the monorepo:

apps/docs

It builds Markdown into static HTML with VitePress.

Local Development

pnpm dev:docs

The docs dev server runs on:

http://127.0.0.1:5174/

Production Build

pnpm build:docs

Output:

apps/docs/.vitepress/dist

The build also generates:

• sitemap.xml
• robots.txt

Configure the Public URL

Set MIAO_DOCS_URL when building:

MIAO_DOCS_URL=https://docs.example.com pnpm build:docs

If the variable is not set, the manual uses:

https://docs.miao.app

Cloudflare Pages

Recommended Cloudflare Pages settings:

Setting	Value
Framework preset	None
Build command	pnpm build:docs
Build output directory	apps/docs/.vitepress/dist
Node version	Same as repo, Node 25.x

After deploy, add the site to Google Search Console and submit:

https://your-docs-domain/sitemap.xml