nextjs-deployment

## Quick Reference

| Output Mode | Config | Use Case |
|-------------|--------|----------|
| Default | - | Vercel/Node.js hosting |
| Standalone | `output: 'standalone'` | Docker containers |
| Static | `output: 'export'` | Static hosting (no SSR) |

| Platform | Command | Notes |
|----------|---------|-------|
| Vercel | `vercel --prod` | Automatic, recommended |
| Node.js | `npm run build && npm start` | Self-hosted |
| Docker | `docker build -t app .` | Container deployment |
| Static | `npm run build` → `out/` | CDN hosting |

| Runtime | Config | Features |
|---------|--------|----------|
| Node.js | Default | Full features |
| Edge | `export const runtime = 'edge'` | Fast, limited APIs |

| Environment | File | Usage |
|-------------|------|-------|
| Development | `.env.local` | Local dev |
| Production | `.env.production` | Build time |
| Runtime | Platform secrets | Server runtime |

## When to Use This Skill

Use for **deployment and production**:
- Deploying to Vercel (easiest path)
- Self-hosting with Docker or Node.js
- Static export for CDN hosting
- Setting up CI/CD pipelines
- Production configuration and monitoring

**Related skills:**
- For middleware: see `nextjs-middleware`
- For caching in production: see `nextjs-caching`
- For authentication: see `nextjs-authentication`

---

# Next.js Deployment

## Vercel Deployment

### Automatic Deployment

```bash
# Install Vercel CLI
npm i -g vercel

# Deploy
vercel

# Production deployment
vercel --prod
```

### Environment Variables

```bash
# Set environment variables
vercel env add DATABASE_URL production

# Pull env vars locally
vercel env pull .env.local
```

### vercel.json Configuration

```json
{
  "buildCommand": "npm run build",
  "outputDirectory": ".next",
  "framework": "nextjs",
  "regions": ["iad1", "sfo1"],
  "functions": {
    "app/api/**/*.ts": {
      "memory": 1024,
      "maxDuration": 30
    }
  },
  "headers": [
    {
      "source": "/api/(.*)",
      "headers": [
        { "key"