Deployment Guide

# 1. Run type checking
pnpm turbo typecheck
 
# 2. Run linting
pnpm turbo lint
 
# 3. Build all projects
pnpm turbo build
 
# 4. Test production build locally
pnpm turbo start

# Pull current production variables
vercel env pull .env.production
 
# Verify all required variables exist
cat .env.production | grep -E "^[A-Z]"

# Create and switch to feature branch
git checkout -b feature/your-feature-name
 
# Make changes
# ... edit files ...
 
# Test locally
pnpm turbo dev --filter=affected

# Stage changes
git add .
 
# Commit with conventional commit message
git commit -m "feat(console): add new dashboard widget"
 
# Push to GitHub
git push -u origin feature/your-feature-name

# Using GitHub CLI
gh pr create --title "feat: Add dashboard widget" \
  --body "## Summary
  - Added new dashboard widget
  - Updated API endpoints
 
  ## Test Plan
  - [ ] Widget renders correctly
  - [ ] API returns expected data"

https://console-[hash]-earna-ai.vercel.app

# Merge via GitHub UI or CLI
gh pr merge --squash
 
# Or merge locally
git checkout main
git pull origin main
git merge --squash feature/your-feature-name
git push origin main

# Check deployment status
vercel ls --prod
 
# Monitor logs
vercel logs --prod
 
# Check production site
curl -I https://console.earna.sh

# Environment variables required
NEXT_PUBLIC_SUPABASE_URL
NEXT_PUBLIC_SUPABASE_ANON_KEY
OPENAI_API_KEY
ANTHROPIC_API_KEY
 
# Build command
pnpm turbo build --filter=console
 
# Start command
pnpm --filter console start

# Environment variables required
DATABASE_URL
NEXT_PUBLIC_FIREBASE_API_KEY
ANTHROPIC_API_KEY
 
# Build command
pnpm turbo build --filter=apps
 
# Start command
pnpm --filter apps start

# No special environment variables required
 
# Build command
pnpm turbo build --filter=docs-nextra
 
# Start command
pnpm --filter docs-nextra start

# Environment variables required
DATABASE_URL
ANTHROPIC_API_KEY
NEXTAUTH_SECRET
 
# Build command
pnpm turbo build --filter=credit-engine
 
# Start command
pnpm --filter credit-engine start

# Install Vercel CLI
pnpm add -g vercel
 
# Login to Vercel
vercel login
 
# Deploy to preview
vercel
 
# Deploy to production
vercel --prod
 
# Deploy specific project
cd apps && vercel --prod

# Bypass cache and redeploy
vercel --prod --force
 
# With specific environment
vercel --prod --env NODE_ENV=production

# Via Vercel Dashboard
1. Go to project deployments
2. Find last working deployment
3. Click "..." → "Promote to Production"
 
# Via CLI
vercel rollback
vercel rollback [deployment-url]

# 1. Immediate revert via Git
git revert HEAD
git push origin main
 
# 2. Or reset to previous commit
git reset --hard HEAD~1
git push --force origin main  # Use with caution!

# Console health check
curl https://console.earna.sh/api/health
 
# Apps health check
curl https://earna.sh/api/health
 
# Credit Engine health check
curl https://credit.earna.sh/api/health

# Lighthouse CI
pnpm add -D @lhci/cli
lhci autorun --collect.url=https://console.earna.sh
 
# Load testing
pnpm add -D autocannon
autocannon -c 10 -d 30 https://console.earna.sh/api/health

# Local development
pnpm turbo dev
 
# Environment: .env.local
# URL: http://localhost:3000

# Automatic on PR/branch push
# Environment: Preview env vars in Vercel
# URL: https://[project]-[hash].vercel.app

# Automatic on main branch push
# Environment: Production env vars in Vercel
# URLs:
# - https://earna.sh
# - https://console.earna.sh
# - https://docs.earna.sh
# - https://credit.earna.sh

# Via Vercel Dashboard
Settings → Environment Variables → Add
 
# Via CLI
vercel env add SECRET_NAME
 
# Specify environment
vercel env add SECRET_NAME production

# 1. Add new secret with temporary name
vercel env add NEW_API_KEY production
 
# 2. Update code to use new secret
# 3. Deploy and verify
# 4. Remove old secret
vercel env rm OLD_API_KEY production
 
# 5. Rename new secret
vercel env add API_KEY production
vercel env rm NEW_API_KEY production

# 1. Backup database
pg_dump $DATABASE_URL > backup.sql
 
# 2. Run migration
DATABASE_URL=$PROD_DATABASE_URL pnpm db:migrate
 
# 3. Verify migration
DATABASE_URL=$PROD_DATABASE_URL pnpm db:studio

# Rollback last migration
DATABASE_URL=$PROD_DATABASE_URL pnpm db:migrate:rollback
 
# Restore from backup if needed
psql $DATABASE_URL < backup.sql

# Check build logs
vercel logs --since 1h
 
# Common fixes:
# 1. Clear cache
rm -rf .turbo .next
 
# 2. Update dependencies
pnpm update
 
# 3. Check environment variables
vercel env ls

# Check function logs
vercel logs --prod --since 1h
 
# Common issues:
# - Missing environment variables
# - Database connection errors
# - API rate limits
# - Memory/timeout limits

# Check function metrics
vercel inspect [deployment-url]
 
# Optimize:
# - Reduce bundle size
# - Enable caching
# - Optimize images
# - Use ISR/SSG where possible

// api/deploy-webhook.ts
export async function POST(req: Request) {
  const { deployment, project } = await req.json()
 
  await fetch(process.env.SLACK_WEBHOOK_URL, {
    method: 'POST',
    body: JSON.stringify({
      text: `🚀 ${project} deployed to ${deployment.environment}`,
      attachments: [{
        color: deployment.ready ? 'good' : 'danger',
        fields: [
          { title: 'URL', value: deployment.url },
          { title: 'Commit', value: deployment.meta.githubCommitSha }
        ]
      }]
    })
  })
}

pnpm turbo build
pnpm turbo start

# Watch logs for 5 minutes post-deploy
vercel logs --prod --follow

git tag -a v1.0.0 -m "Release version 1.0.0"
git push origin v1.0.0