Path B (Full Stack)

Path B is the full-stack runtime:

• Auth: better-auth
• Backend: Hono on Cloudflare Workers
• DB: Cloudflare D1 (SQLite edge) via Drizzle
• Rate limiting: fixed-window limiter on AI proxy routes (RATE_LIMIT_KV when bound, in-memory fallback otherwise)
• Deploy: Wrangler or Alchemy

When to pick Path B

Pick it if you need:

• custom API endpoints
• server-side auth/session management
• AI proxy + rate limiting + usage logging
• a clean path to multi-platform later

Local dev

cd backend
npm install
npm run dev

backend/src/index.ts mounts:

/api/auth/*
/api/ai/chat
/api/chat/*
/api/user/profile
/api/user/settings
/api/feedback
/api/health, /api/info, /api/me, /api/users*

Database schema

Drizzle schema lives in:

• backend/src/db/schema.ts

Key route files:

• backend/src/routes/auth.ts
• backend/src/routes/ai-proxy.ts
• backend/src/routes/chat.ts
• backend/src/routes/profile.ts
• backend/src/routes/settings.ts
• backend/src/routes/feedback.ts
• backend/src/routes/api.ts