deploy

Deploy

Complete deployment workflow for staging and production environments. Includes pre-flight checks, build steps, deployment, and post-deployment verification.

---

Usage

/deploy [environment] [options]

Quick Examples

/deploy                     # Deploy to staging (default)
/deploy staging             # Explicit staging deploy
/deploy production          # Deploy to production
/deploy production --force  # Skip confirmations
/deploy --dry-run           # Preview deployment steps

---

Actions

1. Deploy to Staging (Default)

When invoked without arguments or with staging, deploys to staging environment.

Usage:

/deploy
/deploy staging

Process:

Step 1: Pre-Flight Checks

1. Verify on correct branch (main or release/*)
2. Check for uncommitted changes
3. Verify all tests pass
4. Check build succeeds

Step 2: Prepare Deployment

1. Create deployment tag: staging-YYYYMMDD-HHMMSS
2. Update version in application files
3. Generate changelog since last deployment

Step 3: Build

1. Run production build:
   • npm run build (frontend)
   • composer install --no-dev (backend)
2. Optimize assets
3. Clear and rebuild caches

Step 4: Deploy

1. SSH to staging server
2. Pull latest code
3. Run migrations
4. Clear application caches
5. Restart workers/services

Step 5: Verify

1. Run smoke tests against staging
2. Check application health endpoint
3. Verify key features work

Example Output:

🚀 Deploying to STAGING

Pre-flight checks:
  ✅ On branch: main
  ✅ No uncommitted changes
  ✅ Tests pass (42 passed)
  ✅ Build succeeds

Preparing deployment:
  ✅ Created tag: staging-20260104-143022
  ✅ Updated version: 1.5.3

Building:
  ✅ Frontend built (32s)
  ✅ Backend optimized (8s)

Deploying:
  ✅ Connected to staging.example.com
  ✅ Code pulled
  ✅ Migrations run (3 new)
  ✅ Caches cleared
  ✅ Workers restarted

Verification:
  ✅ Health check passed
  ✅ Smoke tests passed (5/5)

🎉 Deployment complete!
   URL: https://staging.example.com
   Version: 1.5.3
   Duration: 2m 34s