Despliegue en Cloudflare

Runbook de build estático, Workers Static Assets y supuestos de dominio para el sitio Fumadocs.

El sitio de documentación vive aislado en apps/docs para no contaminar el runtime TanStack Start de apps/web. Usa Fumadocs sobre Next.js con output: "export", por lo que el artefacto de despliegue es estático.

Build local

pnpm --filter @curia/docs build
pnpm --filter @curia/docs typecheck
pnpm --filter @curia/docs lint:eslint

El build genera apps/docs/out.

Workers Static Assets

Cloudflare recomienda Workers Static Assets para nuevos sitios estáticos. El wrangler.jsonc de este workspace apunta a:

{
  "name": "curia-docs",
  "assets": {
    "directory": "./out"
  }
}

Deploy propuesto:

pnpm --filter @curia/docs build
cd apps/docs
pnpm exec wrangler deploy

Dominio

Antes de seleccionar hostname, descubrir zonas administradas por CLI/API. Preferencia: docs.<curia-domain> si Curia ya tiene zona propia; si no, usar subdominio administrado por Agentic Engineering o URL temporal workers.dev/pages.dev y dejar blocker explícito.

Checklist de operación

Build local correcto.
Typecheck y lint del workspace docs correctos.
pnpm exec biome check . desde raíz sin nuevos errores.
URL de despliegue reachable.
Dominio custom reachable si fue configurado.
Linear CUR-230 y GitHub PR actualizados con URL, commit y comandos.

Seguridad documental

No incluir secretos en docs. Variables y bindings deben vivir en .env.example, Wrangler secrets o el sistema de Cloudflare correspondiente. No documentar prompts, OCR text, RFC, CURP, R2 keys ni datos reales de cliente.