HOST

Production host: Cloudflare Pages

Stack: fumapress (Waku + Vite) → static dist/public → Cloudflare Pages (assets only). No Next.js. No Pages Functions / Worker script.

Pages project name: rocket-docs. Production branch: main. Live URL: https://docs.rocket.new.

How prod updates (normal path)

Merge (or push) to main on kalpesh1202/mintlify-docs. Cloudflare Pages builds and publishes. No local Wrangler for day-to-day deploys.

Trigger	Result
Push / merge to main	Production build → docs.rocket.new
Other branches / PRs	Preview on *.pages.dev (staging / noindex)

One-time Cloudflare Pages settings

Dashboard → Workers & Pages → rocket-docs (create if missing), Git connected to this repo:

Setting	Value
Production branch	main
Build command	npm ci && npm run build:prod
Build output directory	dist/public
Root	/
NODE_VERSION (env)	24 (also pinned in .node-version)
Production env	DOCS_ENV=production
Custom domain	docs.rocket.new

Git connect installs Cloudflare’s GitHub app on the repo owner account (kalpesh1202) and must grant mintlify-docs. Collaborators with Cloudflare access can configure the Pages project after the app can see the repo. Branch protection on main needs GitHub Admin.

Create project via CLI if needed: npx wrangler pages project create rocket-docs --production-branch main.

Built-ins (prefer these)

Feature	Source
Docs layout, MDX, Mintlify docs.json	Explicit in press.config.tsx
FlexSearch (/api/search)	Explicit flexsearchPlugin (lean index)
Robots (DOCS_ENV)	Explicit robotsPlugin
Sitemap, llms.txt, RSS, Takumi OG	fumapress recommended preset (auto)
Link validation	Explicit linkValidationPlugin (fails build on broken internal links)

Do not reimplement sitemap/llms/rss. Do not add blog, Orama, or OpenAPI plugins for this site.

Manual / emergency deploy (Wrangler)

Optional override for people with Cloudflare/Wrangler access—not the normal path.

npx wrangler login   # once
npm run deploy:staging   # or: npm run deploy
npm run deploy:prod

Script	Env	Effect
deploy / deploy:staging	DOCS_ENV=staging	noindex + robots.txt Disallow; *.pages.dev
deploy:prod	DOCS_ENV=production	crawl/index allowed; use with custom domain

Staging sets:

• robots.txt → Disallow: /
• X-Robots-Tag: noindex, nofollow, noarchive on all paths

Optional stronger lock on previews: Pages → Settings → Access policy (Cloudflare Access).

Caps (Free)

Static bandwidth/requests unlimited. File cap 20,000 (asserted at publish). Max file 25 MB. Stay static-only so Workers Functions quotas never apply.