---

name: deploy-helper description: Deployment utilities for various platforms with health checks and rollback

deploy-helper

Overview

Comprehensive deployment utilities for Vercel, Netlify, and Supabase with pre-deployment checks, health monitoring, and rollback capabilities. Streamlines the deployment workflow with integrated environment management and domain configuration.

Usage

Copydeploy-helper <command> [options]

Commands

Core Deployment

• vercel [env] - Deploy to Vercel (production/preview)
• netlify [env] - Deploy to Netlify (production/preview)
• supabase-functions - Deploy Supabase edge functions
• preview - Create preview deployment (auto-detect platform)

Monitoring & Management

• health <url> - Comprehensive deployment health check
• status - Show deployment status across all platforms
• list - List recent deployments
• logs <deployment> - View deployment logs

Configuration

• domains - Manage custom domains
• env <deployment> - Manage deployment environment variables
• rollback [version] - Rollback to previous deployment

When to Use

• "deploy to production" - Use deploy-helper vercel production
• "create preview" - Use deploy-helper preview
• "check deployment" - Use deploy-helper health <url>
• "rollback deployment" - Use deploy-helper rollback
• "deploy functions" - Use deploy-helper supabase-functions
• "deployment status" - Use deploy-helper status

Features

Pre-Deployment Checks

• ✓ TypeScript compilation verification
• ✓ Linting checks
• ✓ Build verification (Netlify)
• ✓ Interactive error handling

Health Monitoring

• ✓ HTTP status verification
• ✓ Response time measurement
• ✓ SSL certificate validation
• ✓ Common health endpoint detection

Deployment Management

• ✓ Multi-platform support (Vercel, Netlify, Supabase)
• ✓ Environment management (production/preview/development)
• ✓ Domain configuration
• ✓ Environment variable management
• ✓ Rollback capability

Examples

Deploy to Vercel Production

Copydeploy-helper vercel production

Create Preview Deployment

Copydeploy-helper preview

Check Deployment Health

Copydeploy-helper health https://my-app.vercel.app

Deploy Supabase Functions

Copydeploy-helper supabase-functions

View Deployment Status

Copydeploy-helper status

Manage Environment Variables

Copydeploy-helper env

Rollback Deployment

Copydeploy-helper rollback

Environment Variables

Set these environment variables for authentication:

• VERCEL_TOKEN - Vercel authentication token
• NETLIFY_AUTH_TOKEN - Netlify authentication token
• SUPABASE_ACCESS_TOKEN - Supabase access token

Prerequisites

Install the required CLI tools:

Copy# Vercel
npm install -g vercel

# Netlify
npm install -g netlify-cli

# Supabase
brew install supabase/tap/supabase  # macOS
# or download from https://supabase.com/docs/guides/cli

Scripts

• scripts/main.sh - Main deployment functionality

Claude can execute this script directly without loading it into context.

Additional Resources

For detailed information, see:

• reference/examples.md - Comprehensive usage examples
• reference/platforms.md - Platform-specific details

Progressive Disclosure

Additional reference files available:

• reference/troubleshooting.md - Common deployment issues
• reference/best-practices.md - Deployment best practices