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

# Run tests
npm run test 2>/dev/null || pytest 2>/dev/null || go test ./... 2>/dev/null || echo "NO_TEST_RUNNER"

# Run type checks (if applicable)
npm run type-check 2>/dev/null || npx tsc --noEmit 2>/dev/null || mypy src/ 2>/dev/null || echo "NO_TYPE_CHECK"

# Run linter
npm run lint 2>/dev/null || ruff check . 2>/dev/null || golangci-lint run 2>/dev/null || echo "NO_LINTER"

If any check fails: Stop deployment, report the failure, and suggest fixes.

---

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: Have tests passed? 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}}