Hopshift
Developer Docs

Deployment

Deploy and operate Hopshift

Hosting

Hopshift is deployed on Vercel with Supabase as the backend.

Vercel Setup

The web app deploys automatically from the main branch. Each PR gets a preview deployment.

# Vercel project settings
Framework: Next.js
Root Directory: apps/web
Build Command: cd ../.. && pnpm turbo build --filter=@workspace/web
Install Command: pnpm install

Environment Variables

Key environment variables required:

VariableDescription
DATABASE_URLSupabase connection string (pooled)
DIRECT_URLSupabase direct connection (for migrations)
SUPABASE_SERVICE_ROLE_KEYSupabase admin key
NEXTAUTH_SECRETSession encryption key
RESEND_API_KEYEmail service API key

CI/CD

GitHub Actions runs on every push:

  1. Lint: ESLint checks
  2. Type Check: TypeScript compilation
  3. Build: Full production build
  4. Deploy: Vercel deployment (main branch only)

Database Migrations

Migrations are applied manually before deployment:

pnpm --filter @workspace/database db:migrate

Monitoring

  • Vercel Analytics for web performance
  • Supabase dashboard for database monitoring
  • Error tracking via Vercel (built-in)

On this page