Deployment

Operator Reference

Cloudflare deployment targets, custom domains, Access boundaries, API docs exposure, and AI/MCP safety rules live in cloudflare-deploy-and-access.md.

This runbook keeps only the short command surface.

Root Deploy Commands

pnpm deploy          # deploy all configured production Cloudflare surfaces
pnpm deploy:all      # alias for pnpm deploy:prod
pnpm deploy:prod     # OS Shell, docs, UI workshop, API, esmadrider.me
pnpm deploy:os       # apps/os-shell -> Pages project prox-os, including homepage and owner runtime routes
pnpm deploy:docs     # apps/docs -> Pages project prox-os-docs
pnpm deploy:ui       # apps/ui-workshop Storybook -> prox-os-ui-workshop
pnpm deploy:api      # apps/api-worker -> Worker prox-os-api-worker
pnpm deploy:esmadrider-me

Do not run these commands from automation until the target Cloudflare projects, custom domains, Access policies, and secrets have been reviewed by a human.

apps/os-shell is the canonical public surface. pnpm deploy:os updates the public homepage at /, Launchpad at /launchpad, and owner-scoped runtime routes such as /@esmadrider/runtime/os. The older apps/website project is retained only as a reference layer and is no longer a production deploy target.

pnpm deploy:os builds apps/os-shell locally and then uploads dist with Wrangler. Build-time public variables such as PUBLIC_WEB3FORMS_ACCESS_KEY must exist locally before running the command, either in apps/os-shell/.env.local or the shell environment. Cloudflare Pages Dashboard variables only affect Cloudflare-managed builds and Pages Functions; they do not mutate a static bundle that was already built locally.

Domain Plan