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 installEnvironment Variables
Key environment variables required:
| Variable | Description |
|---|---|
DATABASE_URL | Supabase connection string (pooled) |
DIRECT_URL | Supabase direct connection (for migrations) |
SUPABASE_SERVICE_ROLE_KEY | Supabase admin key |
NEXTAUTH_SECRET | Session encryption key |
RESEND_API_KEY | Email service API key |
CI/CD
GitHub Actions runs on every push:
- Lint: ESLint checks
- Type Check: TypeScript compilation
- Build: Full production build
- Deploy: Vercel deployment (main branch only)
Database Migrations
Migrations are applied manually before deployment:
pnpm --filter @workspace/database db:migrateMonitoring
- Vercel Analytics for web performance
- Supabase dashboard for database monitoring
- Error tracking via Vercel (built-in)