vercel-cli

leobrival's avatarfrom leobrival

Vercel CLI expert for serverless deployment. Use when users need to deploy apps, manage domains, env vars, or Vercel projects.

⭐0stars🔀0forks📁View on GitHub🕐Updated Jan 10, 2026⬇️3downloads
[Cloud Infrastructure]

When & Why to Use This Skill

This Claude skill serves as a comprehensive expert for the Vercel CLI, designed to streamline serverless deployment and web infrastructure management. It helps developers automate the entire application lifecycle—from project initialization and local development to production deployment, custom domain configuration, and environment variable management—ensuring a fast, reliable, and scalable web hosting experience.

Use Cases

  • Streamlined Deployment: Rapidly deploy web applications to preview or production environments with optimized commands, including support for multi-region and prebuilt CI/CD workflows.
  • Environment Variable Syncing: Efficiently manage, add, and pull environment variables across different project stages to maintain configuration consistency between local and cloud environments.
  • Domain and DNS Management: Simplify the process of adding custom domains, inspecting DNS records, and verifying configurations to ensure seamless site accessibility.
  • Monitoring and Incident Recovery: Access real-time deployment logs for debugging and perform instant rollbacks to previous stable versions to minimize downtime during production issues.
namevercel-cli
descriptionVercel CLI expert for serverless deployment. Use when users need to deploy apps, manage domains, env vars, or Vercel projects.

Vercel CLI Guide

Vercel is a serverless platform for deploying, scaling, and managing web applications. This guide provides essential workflows and quick references for common Vercel operations.

Quick Start

# Check Vercel CLI installation
vercel --version

# Authenticate with Vercel
vercel login

# Show current user
vercel whoami

# Link project to Vercel
vercel link

# Pull environment variables
vercel env pull .env.local

Common Workflows

Workflow 1: Initialize and Deploy Project

# Initialize new project
vercel init

# Or link existing project
vercel link

# Start local development
vercel dev

# Create preview deployment
vercel

# Deploy to production
vercel --prod

Workflow 2: Manage Environment Variables

# List all environment variables
vercel env ls

# Add new variable
vercel env add API_KEY

# Pull variables to .env.local
vercel env pull .env.local

# Start dev with environment
vercel dev

Workflow 3: Setup Custom Domain

# Add domain to project
vercel domains add example.com my-project

# Verify domain configuration
vercel domains inspect example.com

# Check DNS records
vercel dns ls example.com

Workflow 4: Monitor Deployments

# List all deployments
vercel list

# View deployment logs
vercel logs https://my-app-xyz.vercel.app

# Follow logs in real-time
vercel logs --follow https://my-app-xyz.vercel.app

# Inspect deployment details
vercel inspect https://my-app-xyz.vercel.app

Workflow 5: Rollback & Recovery

# View recent deployments
vercel list

# Rollback to previous version
vercel rollback https://my-app.vercel.app

# Redeploy if needed
vercel redeploy https://my-app.vercel.app

Decision Tree

When to use which command:

  • To start local development: Use vercel dev
  • To create preview deployment: Use vercel (no flags)
  • To deploy to production: Use vercel --prod
  • To manage environment variables: Use vercel env add/rm/ls
  • To setup domains: Use vercel domains add/inspect
  • To view deployment logs: Use vercel logs [url]
  • To rollback deployment: Use vercel rollback [url]
  • For detailed command syntax: See Commands Reference
  • For complex workflows: See Common Patterns
  • For troubleshooting: See Troubleshooting Guide

Common Patterns

Deployment Process

# 1. Setup environment variables
vercel env add API_KEY
vercel env add DATABASE_URL

# 2. Test locally
vercel dev

# 3. Create preview
vercel

# 4. Test preview URL
# ... verify at https://my-app-xyz.vercel.app ...

# 5. Promote to production
vercel promote https://my-app-xyz.vercel.app

# 6. Monitor production
vercel logs --follow https://my-app.vercel.app

Team Collaboration

# Switch to team
vercel switch my-team

# Pull team project settings
vercel pull

# Deploy to team project
vercel --scope my-team --prod

Multi-Region Deployment

# Deploy to multiple regions
vercel --regions sfo1,fra1,sin1

# In vercel.json:
{
  "regions": ["sfo1", "fra1"]
}

CI/CD Automation

# Deploy via CI/CD pipeline
vercel --token $VERCEL_TOKEN --prod --yes

# Build and deploy
vercel build
vercel --prebuilt --token $VERCEL_TOKEN

Troubleshooting

Common Issues:

  1. Cannot login

  2. Project not linked

  3. Build fails during deployment

  4. Deployment crashes after build

    • Quick fix: Check logs with vercel logs https://my-app.vercel.app
    • See: Runtime Issues

  5. Domain not resolving

    • Quick fix: Update nameservers to Vercel's at domain registrar
    • See: Domain Issues

For detailed troubleshooting steps, see the Troubleshooting Guide.

Reference Files

Load as needed for detailed information:

  • Commands Reference - Complete CLI command documentation with all flags and options. Use when you need exact syntax or flag details for any Vercel command.

  • Common Patterns - Real-world patterns and workflows for development, deployments, domains, environment management, debugging, team collaboration, and production setups. Use for implementing specific workflows or integrations.

  • Troubleshooting Guide - Detailed error messages, diagnosis steps, and resolution strategies for authentication, deployment, runtime, domain, git integration, and environment variable issues. Use when encountering errors or unexpected behavior.

When to use each reference:

  • Use Commands Reference when you need exact syntax, flag combinations, or comprehensive command documentation
  • Use Common Patterns for implementing deployment workflows, team setups, or production configurations
  • Use Troubleshooting when deployments fail, apps crash, or services are unreachable

Resources