Deploy

Deploy Process

Phase 1: Pre-Deploy Checks

Required before any deployment:

1. Clean worktree:

   git status --porcelain
   

2. On correct branch:

   • Staging: main or feature branch
   • Production: main only

3. All quality checks pass:

   make quality  # or equivalent from prd/00_technology.md
   

4. Up to date with remote:

   git fetch origin
   git diff HEAD origin/main --stat
   

5. Environment variables configured for target environment

Phase 2: Detect Platform

Auto-detect from project files:

Phase 3: Deploy

Web — Vercel

# Staging (preview)
vercel --yes

# Production
vercel --prod --yes

Web — Docker

# Build and tag
docker build -t {registry}/{app}:{version} .

# Push to registry
docker push {registry}/{app}:{version}

# Deploy (platform-specific)
# Fly.io:
fly deploy --image {registry}/{app}:{version}
# Docker Compose (remote):
docker compose -f docker-compose.prod.yml up -d

Web — Fly.io

# Staging
fly deploy --config fly.staging.toml

# Production
fly deploy

iOS — TestFlight

# Build and upload
bundle exec fastlane beta
# This typically:
# 1. Increments build number
# 2. Builds archive
# 3. Uploads to App Store Connect
# 4. Submits to TestFlight

Android — Play Console

# Build and upload
bundle exec fastlane beta
# This typically:
# 1. Increments version code
# 2. Builds AAB
# 3. Uploads to Play Console
# 4. Submits to internal testing track

Mobile — Expo / EAS

# Build
eas build --platform all --profile {environment}

# Submit (after build)
eas submit --platform ios --profile {environment}
eas submit --platform android --profile {environment}

Phase 4: Post-Deploy Verification

1. Health check:

   curl -f https://{deploy_url}/health || echo "Health check failed"
   

2. Smoke test key endpoints or screens

3. Monitor logs for errors:

   # Platform-specific log tailing
   vercel logs --follow
   fly logs
   docker compose logs -f
   

4. Tag deployment (if not already tagged):

   git tag -a deploy/{environment}/$(date +%Y%m%d-%H%M) -m "Deployed to {environment}"
   

Rollback

If issues are detected after deployment:

# Vercel
vercel rollback

# Fly.io
fly releases
fly deploy --image {previous_image}

# Docker
docker compose -f docker-compose.prod.yml up -d --force-recreate

# iOS — Cannot rollback TestFlight, submit new build
# Android — Rollback via Play Console halt rollout

Deploy Checklist

• Worktree is clean
• On correct branch
• All tests pass
• Lint and type check pass
• Environment variables set for target
• Deployed to staging first
• Health check passes
• Smoke tests pass
• Deployment tagged in git

Example Output

$ /deploy staging

Pre-deploy checks...
  Branch: main
  Worktree: clean
  Tests: passing (142/142)
  Lint: clean

Detected platform: Vercel

Deploying to staging...
  Building: 12s
  Deploying: 8s
  URL: https://my-app-staging-abc123.vercel.app

Post-deploy verification...
  Health check: 200 OK (45ms)
  API /users: 200 OK
  API /health: 200 OK

Staging deployment successful!
Preview: https://my-app-staging-abc123.vercel.app

To deploy to production:
  /deploy production