watasu docs

Deploy the docs site

This page is for the product owner setting up the public docs site.

Use Cloudflare Pages for the first docs deployment.

Why:

  • static site hosting is enough
  • free tier is enough to start
  • custom domain support fits docs.watasu.ai
  • build output is just static files
  • no database or runtime secrets are required

Build settings

Use these settings in Cloudflare Pages:

SettingValue
Project namewatasu-docs
Production branchmain
Build commandpnpm install --frozen-lockfile && pnpm docs:build
Build output directorydoc_build
Node.js version22 or newer
Custom domaindocs.watasu.ai

Local verification

pnpm docs:build
pnpm docs:preview

After build, check these files exist:

doc_build/index.html
doc_build/llms.txt
doc_build/llms-full.txt

Owner checklist

[ ] Create a Cloudflare Pages project connected to the GitHub repo.
[ ] Set build command to `pnpm install --frozen-lockfile && pnpm docs:build`.
[ ] Set output directory to `doc_build`.
[ ] Add custom domain `docs.watasu.ai`.
[ ] Verify DNS and TLS in Cloudflare.
[ ] Open `/llms.txt` and `/llms-full.txt` after deploy.
[ ] Add the public docs URL to product-facing materials.

No production watasu secrets are required for the docs site.