Deploy Helper

Guides safe deployment to production.

When to Use

• "Deploy to production"
• "Release this"
• "Push to main"
• "Is this ready to deploy?"
• "Pre-deploy checklist"

Deployment Flow

1. PR merged to main
   ↓
2. deploy.yml runs
   ↓
3. Typecheck + Lint + Build
   ↓
4. Preflight check (DB connection)
   ↓
5. Apply migrations to production
   ↓
6. Trigger Vercel deploy hook
   ↓
7. Vercel builds and deploys

Pre-Deploy Checklist

Code Quality

• [ ] pnpm typecheck passes
• [ ] pnpm lint passes
• [ ] pnpm -C apps/web build succeeds
• [ ] No console.log statements in production code
• [ ] No hardcoded secrets

Tests

• [ ] All integration tests pass: pnpm test:integration
• [ ] Mobile tests pass: pnpm -C apps/mobile test
• [ ] New features have test coverage

Database

• [ ] Migration generated: pnpm -C packages/db migrate:generate
• [ ] Migration applied locally: pnpm -C packages/db migrate:apply
• [ ] No destructive migrations without data backup plan
• [ ] Migration reviewed for safety

Environment

• [ ] All required env vars set in Vercel
• [ ] No new env vars without updating Vercel config
• [ ] Secrets rotated if needed

Dependencies

• [ ] No security vulnerabilities: pnpm audit
• [ ] Dependencies up to date
• [ ] Lock file committed

Procedure

Step 1: Run Quality Checks

pnpm typecheck
pnpm lint
pnpm -C apps/web build

Step 2: Run Tests

pnpm test:integration
pnpm -C apps/mobile test

Step 3: Check Migrations

# List pending migrations
ls packages/db/drizzle/*.sql

# Apply locally to verify
pnpm -C packages/db migrate:apply

Step 4: Review Changes

git log main..HEAD --oneline
git diff main...HEAD --stat

Step 5: Verify Readiness

Generate deploy readiness report:

## Deploy Readiness Report

### Quality Checks

- [ ] TypeScript: {PASS|FAIL}
- [ ] ESLint: {PASS|FAIL}
- [ ] Build: {PASS|FAIL}

### Tests

- [ ] Integration: {PASS|FAIL}
- [ ] Mobile: {PASS|FAIL}

### Migrations

- Pending: {count}
- Reviewed: {YES|NO}

### Changes

- Commits: {count}
- Files changed: {count}

### Risk Level

{LOW|MEDIUM|HIGH}

### Recommendation

{READY TO DEPLOY | NEEDS ATTENTION}

Step 6: Deploy

If all checks pass:

git push origin main

Monitor deploy.yml workflow in GitHub Actions.

Rollback Procedure

If deployment fails:

1. Revert commit:

   git revert HEAD
   git push origin main
   

2. Check Vercel:

   • Go to Vercel dashboard
   • Redeploy previous working version

3. Database rollback (if needed):

   • Migrations are forward-only
   • Manual intervention required for rollback
   • Contact database admin

Guardrails

• NEVER force push to main
• NEVER skip migration review
• NEVER deploy with failing tests
• NEVER deploy on Friday afternoon
• Always monitor deployment after push
• Have rollback plan ready