Deploy OpenCut Web to Vercel

OpenCut’s web front-end is a standard Next.js app that Vercel handles well once dependencies and env vars are configured.

Steps

  1. vercel init or import the GitHub repo in the Vercel dashboard.
  2. Set Framework Preset to Next.js.
  3. Under Settings → General → Root Directory, point to apps/web.
  4. Under Settings → Build & Development, set Package Manager to Bun.
  5. Add env vars:
    • DATABASE_URL
    • BETTER_AUTH_SECRET
    • NEXT_PUBLIC_BETTER_AUTH_URL
    • UPSTASH_REDIS_REST_URL
    • UPSTASH_REDIS_REST_TOKEN
  6. Deploy.

Build command

bun install
bun run build

Post-deploy checks

  • vercel logs for runtime errors.
  • Run vercel env pull .env.production locally for debugging.
  • Ensure background worker endpoints point to production services.

Diagram

  flowchart LR
    A[GitHub push] --> B[Vercel build]
    B --> C[Next.js static assets]
    B --> D[Edge functions]

Add a custom domain and configure NEXT_PUBLIC_BASE_URL if your analytics rely on absolute URLs.