Domains, Pages projects, and auth cookies

Canonical reference for production URLs, Cloudflare Pages project names, and what shares auth cookies with the API worker.

Source of truth in code: packages/seo/src/constants.ts, apps/worker/src/lib/config.ts.

---

Production surfaces

Surface	App	Custom domain	Pages project	*.pages.dev default	Auth cookies
Marketing	apps/landing	cepatedge.com	cepatedge	cepatedge.pages.dev	No
Product demo SPA	apps/web	app.cepatedge.com	app-cepatedge	app-cepatedge.pages.dev	Yes (.cepatedge.com)
API	apps/worker	api.cepatedge.com	— (Worker)	*.workers.dev	Sets auth cookie
Docs	apps/docs	docs.cepatedge.com	docs-cepatedge	docs-cepatedge.pages.dev	No
Git analytics	apps/git	git.cepatedge.com	git-cepatedge	git-cepatedge.pages.dev	No

Naming convention: Pages apps use <app>-cepatedge except the main marketing site, which uses project cepatedge so the default hostname is cepatedge.pages.dev.

Cloudflare redirects *.pages.dev → custom domain when configured. Do not add *.pages.dev or legacy *.zamdev.dev hosts to cookie or CORS allowlists — production auth uses cepatedge.com only.

---

Auth cookies (app + API only)

• Cookie domain: .cepatedge.com (parent domain).
• Applies to: app.cepatedge.com SPA and api.cepatedge.com worker.
• Does not apply to: docs.cepatedge.com, git.cepatedge.com, cepatedge.com (landing is static; no worker session).

Local dev: localhost cookies without a parent domain.

---

R2 storage

• Binding: CEPATEDGE_STORAGE in apps/worker/wrangler.jsonc
• Bucket name: cepatedge (single bucket; keys namespaced avatars/, attachments/, etc.)

---

Deploy commands (from repo root)

pnpm landing:deploy   # cepatedge.com  (project cepatedge)
pnpm web:deploy       # app.cepatedge.com (project app-cepatedge)
pnpm worker:deploy    # api.cepatedge.com
pnpm docs:deploy      # docs.cepatedge.com
pnpm git:deploy       # git.cepatedge.com

---

Local development

pnpm dev              # worker + web (8787 + vite)
pnpm docs:dev         # VitePress docs
pnpm landing:dev      # marketing site

Service	Local URL
API	http://localhost:8787
Web SPA	http://localhost:5173 (or 3000 per app)
Docs	http://localhost:8282

---

DNS checklist (Cloudflare)

1. cepatedge.com → Pages project cepatedge
2. app.cepatedge.com → Pages project app-cepatedge
3. docs.cepatedge.com → Pages project docs-cepatedge
4. git.cepatedge.com → Pages project git-cepatedge
5. api.cepatedge.com → Worker custom domain
6. Optional: redirect old *.dev / *.pages.dev bookmarks to .com (Pages/Workers dashboard)