Deployment Targets
One codebase, multiple deployment targets: Cloudflare Workers, Vercel, and Docker.
MuseMVP keeps all business logic in shared Next.js/Node modules. Platform differences live only in deployment config.
Core Philosophy
One codebase, multi-platform deployment: Not only can you deploy to multiple platforms simultaneously, but no separate branches are needed for different environments, significantly reducing maintenance overhead.
Target Comparison Matrix
Cloudflare Worker
Edge-first delivery + Hyperdrive. Uses HYPERDRIVE_FIRST database config.
Vercel
Fast managed SaaS releases via Serverless Functions. Uses DATABASE_URL_FIRST database config.
Docker
Self-hosting & custom infra via Node container. Uses DATABASE_URL_FIRST database config.
Production Readiness Checklist
Before Cutting Traffic
Confirm all items below before routing any production traffic to your domain.
Env vars configured: Ensure all required variables are set in the target platform's vault/dashboard.
Site URL correct: Verify NEXT_PUBLIC_SITE_URL and all OAuth/Webhook callbacks exactly match the production HTTPS domain.
Migrations applied: Run pnpm drizzle:migrate against your production PostgreSQL instance.
Smoke tests pass: Manually test auth flows, billing checkouts, image uploads, and documentation loading.