cloudflare-better-auth-d1 (copier template)

Copier template for a Cloudflare Worker that serves Better Auth + a shadcn/ui login SPA, backed by Cloudflare D1.

Generated projects contain:

• Hono Worker with Better Auth mounted at /api/auth/*, drizzle-orm/d1 adapter
• Vite React SPA (shadcn preset buFznsW, radix-lyra, phosphor icons) served via the Worker's assets binding
• Generated drizzle schema + SQL migration for the four better-auth tables (user, session, account, verification)
• wrangler.jsonc with D1 binding, SPA fallback, and run_worker_first: ["/api/*"]

Usage

uvx copier copy gh:<owner>/<this-repo> ./my-auth-app
# or from a local checkout:
uvx copier copy path/to/this-template ./my-auth-app

You'll be asked for:

• project_slug — kebab-case name for the Worker and package
• app_title / app_tagline — text shown in the login card
• worker_name / d1_database_name — defaults derived from project_slug

Post-generation, copier runs bun install, cd web && bun install && bun run build, and wrangler types. Follow the message printed afterwards to create the D1 database and deploy.

Self-hosting strategy

The default rendered project is vanilla Cloudflare + D1 — right for ~90% of projects. When it isn't, a rendered project can move selected pieces (DB, object storage, runtime) onto your own infra without a rewrite. docs/ documents each escape hatch:

• docs/self-hosted-database.md — swap D1 for self-hosted Postgres reached by the Worker via Hyperdrive + a Cloudflare Tunnel (Worker stays).
• docs/self-hosted-runtime.md — swap the Worker for a Bun + Hono container on Dokploy serving both /api/* and the SPA.
• docs/self-hosted-object-storage.md — add an S3-compatible gateway (versitygw) reached by the Worker over a Workers VPC vpc_services binding on the same tunnel.

Each doc describes the pattern, trade-offs, and order of operations, and links to the working reference in knowsuchagency/vpc-test for the drop-in files. See docs/README.md for the decision framework (when to reach for each).

Developing this template

The template source lives under template/. Files ending in .jinja are rendered; everything else is copied verbatim.

Regenerate into a scratch dir to smoke-test:

uvx copier copy --trust . /tmp/smoke-test --data project_slug=smoke-test