vercel-cli

# 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

```bash
# 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

```bash
# 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

```bash
# 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

```bash
# 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

```bash
# 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

```bash
# 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