local-deploy

Deploy the latest Docker image from GitHub Container Registry to your LOCAL machine's Docker. Works on any machine with Docker Desktop or Docker Engine installed.

Usage

/local-deploy              # Deploy using dev mode (source-mounted, hot-reload)
/local-deploy --staging    # Deploy using staging mode (self-contained, production-like)
/local-deploy --rebuild    # Trigger GitHub Actions build first, then deploy
/local-deploy --staging --rebuild  # Build and deploy to staging mode

Deployment Modes

Mode	Flag	Container	Use Case
Development (default)	(none)	{{PROJECT_NAME}}-dev-app	Active development with hot-reload (STANDARD port 3000)
Staging	--staging	{{PROJECT_NAME}}-staging-app	Production-like, self-contained, survives git operations (port 3001)
Both	--both	Both containers	Run dev and staging simultaneously ({{TICKET_PREFIX}}-400/{{TICKET_PREFIX}}-401)

When to use each mode:

• Dev mode: You're actively writing code and want hot-reload (STANDARD port 3000)
• Staging mode: Testing, demos, or when you need stability during git operations (port 3001)
• Both modes: Run both simultaneously for testing migrations, feature comparison, etc.

Workflow

1. Parse Arguments

Check flags:

# Check command arguments
if [[ "$*" == *"--staging"* ]]; then
  MODE="staging"
else
  MODE="development"
fi

if [[ "$*" == *"--rebuild"* ]]; then
  REBUILD=true
else
  REBUILD=false
fi

2. Pre-Deployment Status Check

Get current running status (check both container types):

# Check for staging container
docker ps --filter name={{PROJECT_NAME}}-staging-app --format '{{.Names}}\t{{.Status}}'

# Check for dev container ({{TICKET_PREFIX}}-400: updated container name)
docker ps --filter name={{PROJECT_NAME}}-dev-app --format '{{.Names}}\t{{.Status}}'