Deployment And Environments

Production Shape

app.<domain>      apps/web
api.<domain>      apps/api
gateway.<domain>  apps/gateway
worker            apps/worker
docs.<domain>     apps/docs static export

Deployment Rules

• Each app owns build, start, healthz, readyz, and env validation.
• Railway deployment must not rely on one shared production .env file.
• Browser-facing values stay public; service-to-service traffic can use private networking later.
• Docs deploy as static files and do not require runtime secrets.
• apps/docs uses Next output export, trailing slashes, and unoptimized images so Cloudflare can serve the generated out/ directory as static assets.