deploy

Deploy Application

Runs a full deployment pipeline: pre-flight checks, build, deploy, health verification, and status report.

---

Execution Flow

Step 1: Pre-Flight Checks

Before deploying, verify the codebase is ready:

# Ensure clean working tree
git status --porcelain

If the tree is dirty: Stop and report. Don't run test, type-check, or lint ladders unless the user asks; the Step 3 build is the pre-deploy check.

---

Step 2: Detect Environment

Target: {{target}} Environment: {{environment}} (default: staging)

If environment is production, add an extra confirmation step:

WARNING: You are deploying to PRODUCTION.
Confirm: Is this change reviewed?

---

Step 3: Build

# Build the project
npm run build 2>/dev/null || python -m build 2>/dev/null || go build ./... 2>/dev/null || cargo build --release 2>/dev/null

If build fails: Stop. Report error with context.

---

Step 4: Deploy by Target

Vercel

# Staging
npx vercel --confirm

# Production
npx vercel --prod --confirm

Pre-requisites: vercel CLI installed, project linked (vercel link).

Docker

# Build image
docker build -t app:latest .

# Tag for registry
docker tag app:latest registry.example.com/app:$(git rev-parse --short HEAD)

# Push
docker push registry.example.com/app:$(git rev-parse --short HEAD)

# Deploy (compose)
docker compose -f docker-compose.{{environment}}.yml up -d

Pre-requisites: Dockerfile exists, Docker daemon running.

AWS

# Detect AWS deployment type
[ -f "serverless.yml" ] && echo "SERVERLESS"
[ -f "cdk.json" ] && echo "CDK"
[ -f "template.yaml" ] && echo "SAM"
[ -f "copilot/.workspace" ] && echo "COPILOT"

# Serverless Framework
npx sls deploy --stage {{environment}}

# AWS CDK
npx cdk deploy --require-approval never

# AWS SAM
sam build && sam deploy --no-confirm-changeset

# AWS Copilot
copilot deploy --env {{environment}}

Pre-requisites: AWS credentials configured, deployment framework installed.