This repo is a starter template for new white-label apps.

Architecture:

• apps/web: SvelteKit frontend (Cloudflare Pages)
• apps/worker: Hono API + Better Auth + D1 (Cloudflare Worker)

Follow this exact order for a new project:

1. Install deps

pnpm install

2. Configure local env files

cp apps/worker/.dev.vars.example apps/worker/.dev.vars
cp apps/web/.env.example apps/web/.env.local

3. Create D1 DB and set database_id in apps/worker/wrangler.jsonc

pnpm --filter worker exec wrangler d1 create <new-db-name>

4. Apply migrations (local + remote)

pnpm --filter worker run db:migrate
pnpm --filter worker run db:migrate:remote

5. Run local dev

pnpm --filter worker dev
pnpm --filter web dev

For a fresh white-label project, update these values:

• apps/worker/wrangler.jsonc:
  • name
  • d1_databases[0].database_name
  • d1_databases[0].database_id
  • vars.CORS_ORIGIN
• Cloudflare app names:
  • Pages project name
  • Worker name
• PUBLIC_API_BASE_URL in Pages env vars

Set in Cloudflare dashboard for deployed environments.

Pages (apps/web):

• PUBLIC_API_BASE_URL = deployed Worker URL (https://...workers.dev or custom domain)

Worker (apps/worker):

• BETTER_AUTH_URL
• BETTER_AUTH_SECRET
• RESEND_API_KEY
• RESEND_FROM
• CORS_ORIGIN = deployed Pages origin (no trailing slash)

This template assumes Cloudflare Git-connected deploys:

• Pages project root: apps/web
• Worker project root: apps/worker

Push to configured production branch to deploy.

• Frontend calls /undefined/api/...:
  • PUBLIC_API_BASE_URL is missing in Pages env vars for that environment.
• Browser calls localhost:8787 in production:
  • old deployment artifact; redeploy Pages from latest commit.
• Worker error Cannot read properties of undefined (reading 'prepare'):
  • D1 binding mismatch; code expects binding name DB.