К основному содержанию
скилл CX Codex

vercel-deployment · curiositech — скилл для Claude Code: деплой Next.js на Vercel

Скилл vercel-deployment для деплоя Next.js и React-приложений на Vercel: переменные окружения, edge-функции, отладка сборки. Для AWS, GCP и Azure не подходит.

MIT 187 установок ★ 274 обновлён 2026-10-30

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add curiositech/some_claude_skills --skill vercel-deployment -a claude-code
Открыть на GitHub

Что делает vercel-deployment

Скилл ведёт по чек-листу перед деплоем: переменные окружения в дашборде Vercel, команда сборки, выходная директория, версия Node.js. Отдельно разбирает vercel.json с заголовками, редиректами и реврайтами, а также TypeScript-конфигурацию через defineConfig из @vercel/config.

Edge-функции описаны с границами: авторизация, A/B-тесты и гео-контент — да, подключения к базе и долгие операции — нет. Есть пример middleware на src/middleware.ts и API-маршрут с runtime = 'edge'.

Для баз данных скилл советует Turso, Vercel Postgres, PlanetScale и Neon. SQLite на Vercel работает только в /tmp, данные между вызовами не сохраняются. Для preview-деплоев можно задать отдельные переменные окружения, а PR получают комментарий со ссылкой и статусом сборки.

Какие задачи решает

  • настроить переменные окружения для продакшена и preview
  • собрать vercel.json с заголовками и редиректами
  • выбрать, что выносить в edge-функции
  • разобраться, почему падает сборка на Vercel
  • подключить базу данных к серверлесс-функциям

Примеры запросов агенту

  • Настрой переменные окружения для этого проекта на Vercel
  • Собери vercel.json с безопасными заголовками для API-маршрутов
  • Проверь, почему сборка падает, и запусти npm run build локально

Как установить vercel-deployment

1Через Skills CLI (Vercel)

npx skills add curiositech/some_claude_skills --skill vercel-deployment -a claude-code

2Вручную: положить файлы

~/.claude/skills/vercel-deployment/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/vercel-deployment/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о vercel-deployment

Как установить vercel-deployment в Claude Code?

Выполните npx skills add curiositech/some_claude_skills --skill vercel-deployment -a claude-code. Скилл появится в ~/.claude/skills/vercel-deployment/SKILL.md.

Что делает vercel-deployment?

Помогает деплоить Next.js и React-приложения на Vercel: переменные окружения, edge-функции, конфигурация vercel.json, отладка сборки, preview-деплои и монорепозитории.

Подходит ли скилл для деплоя на AWS или Cloudflare Pages?

Нет. Скилл заточен только под Vercel, для AWS/GCP/Azure и Cloudflare Pages он не предназначен.

Исходный текст

SKILL.md · MIT
---
name: vercel-deployment
description: Deploy Next.js and React applications to Vercel — project setup, environment variables, edge functions, build troubleshooting, preview deployments, monorepo configuration. NOT for AWS/GCP/Azure
  deployment, self-hosted solutions, or Cloudflare Pages.
allowed-tools: Read,Write,Edit,Bash(npm:*,npx:*,vercel:*)
metadata:
  category: DevOps & Site Reliability
  tags:
  - devops
  - automation
  - web
  - react
  pairs-with:
  - skill: nextjs-app-router-expert
    reason: Vercel is optimized for Next.js deployment with native App Router feature support
  - skill: devops-automator
    reason: Vercel deployment automation integrates with broader CI/CD pipeline workflows
  - skill: github-actions-pipeline-builder
    reason: Vercel preview deployments trigger from GitHub Actions PR workflows
---

# Vercel Deployment

This skill helps you deploy and configure Next.js applications on Vercel following best practices.

## Quick Deploy Checklist

- [ ] Environment variables set in Vercel dashboard
- [ ] Build command configured (default: `next build`)
- [ ] Output directory correct (default: `.next`)
- [ ] Node.js version specified (20.x recommended)
- [ ] Database accessible from Vercel's network
- [ ] Secrets not committed to git

## Environment Variables

### Setting Variables

**Vercel Dashboard** (Recommended for secrets):
1. Project Settings → Environment Variables
2. Add variable with appropriate scope:
   - **Production**: Only production deployments
   - **Preview**: PR and branch previews
   - **Development**: Local `vercel dev`

**Via CLI**:
```bash
vercel env add VARIABLE_NAME production
vercel env pull .env.local  # Pull to local
```

### Variable Naming

```bash
# Server-only (never exposed to browser)
DATABASE_URL=
SESSION_SECRET=
ANTHROPIC_API_KEY=

# Client-exposed (prefixed with NEXT_PUBLIC_)
NEXT_PUBLIC_APP_URL=
NEXT_PUBLIC_ANALYTICS_ID=
```

### Size Limits

| Context | Limit |
|---------|-------|
| Total per deployment | 64 KB |
| Edge Functions | 5 KB per variable |
| Single variable | 64 KB max |

### Required Variables for This Project

```bash
# Authentication (required)
SESSION_SECRET=your-32-char-minimum-secret-here

# AI Integration (required for chat)
ANTHROPIC_API_KEY=sk-ant-api...

# Database (if using external)
DATABASE_URL=file:./data/app.db

# Push Notifications (optional)
VAPID_PUBLIC_KEY=
VAPID_PRIVATE_KEY=
VAPID_SUBJECT=mailto:[email protected]

# OAuth (optional)
GOOGLE_CLIENT_ID=
GOOGLE_CLIENT_SECRET=
GITHUB_CLIENT_ID=
GITHUB_CLIENT_SECRET=
APPLE_CLIENT_ID=
APPLE_CLIENT_SECRET=
```

## vercel.json Configuration

```json
{
  "buildCommand": "npm run build",
  "framework": "nextjs",
  "regions": ["iad1"],
  "headers": [
    {
      "source": "/api/(.*)",
      "headers": [
        { "key": "Cache-Control", "value": "no-store, must-revalidate" }
      ]
    },
    {
      "source": "/(.*)",
      "headers": [
        { "key": "X-Content-Type-Options", "value": "nosniff" },
        { "key": "X-Frame-Options", "value": "DENY" },
        { "key": "X-XSS-Protection", "value": "1; mode=block" }
      ]
    }
  ],
  "redirects": [
    {
      "source": "/old-path",
      "destination": "/new-path",
      "permanent": true
    }
  ],
  "rewrites": [
    {
      "source": "/api/v1/:path*",
      "destination": "/api/:path*"
    }
  ]
}
```

## TypeScript Configuration (New in 2025)

```typescript
// vercel.ts - Type-safe configuration
import { defineConfig } from '@vercel/config';

export default defineConfig({
  regions: ['iad1'],

  headers: async () => [
    {
      source: '/api/:path*',
      headers: [
        { key: 'Cache-Control', value: 'no-store' },
      ],
    },
  ],

  redirects: async () => [
    {
      source: '/old',
      destination: '/new',
      permanent: true,
    },
  ],
});
```

## Edge Functions

### When to Use Edge

Good for:
- Authentication/authorization
- A/B testing
- Geolocation-based content
- Request/response transforms
- Simple, fast operations

Not suitable for:
- Database connections (use serverless instead)
- Long-running operations
- Large dependencies

### Edge Function Example

```typescript
// src/middleware.ts
import { NextResponse } from 'next/server';
import type { NextRequest } from 'next/server';

export const config = {
  matcher: ['/api/:path*', '/protected/:path*'],
};

export function middleware(request: NextRequest) {
  // Check auth token
  const token = request.cookies.get('session')?.value;

  if (!token && request.nextUrl.pathname.startsWith('/protected')) {
    return NextResponse.redirect(new URL('/login', request.url));
  }

  // Add headers
  const response = NextResponse.next();
  response.headers.set('X-Request-Id', crypto.randomUUID());

  return response;
}
```

### Edge Runtime in API Routes

```typescript
// src/app/api/edge-example/route.ts
export const runtime = 'edge';

export async function GET(request: Request) {
  // Limited to edge-compatible APIs
  return Response.json({ timestamp: Date.now() });
}
```

## Build Configuration

### package.json Scripts

```json
{
  "scripts": {
    "build": "next build",
    "postbuild": "npm run db:generate"
  }
}
```

### Build Environment

```bash
# Set Node.js version
# In Vercel Dashboard → Settings → General → Node.js Version
# Or in package.json:
{
  "engines": {
    "node": "20.x"
  }
}
```

### Build Output

```bash
# Check build locally
npm run build

# Analyze bundle
ANALYZE=true npm run build
```

## Database Considerations

### SQLite on Vercel

SQLite with better-sqlite3 works in Vercel's serverless functions, but:
- Filesystem is **read-only** except `/tmp`
- Data doesn't persist between invocations
- Not suitable for production data storage

### Production Database Options

1. **Turso** (SQLite edge database)
   ```typescript
   import { createClient } from '@libsql/client';

   const db = createClient({
     url: process.env.TURSO_DATABASE_URL!,
     authToken: process.env.TURSO_AUTH_TOKEN,
   });
   ```

2. **Vercel Postgres**
   ```typescript
   import { sql } from '@vercel/postgres';

   const result = await sql`SELECT * FROM users`;
   ```

3. **PlanetScale** (MySQL)
4. **Neon** (Postgres)

## Preview Deployments

### Branch Previews

Every git push creates a preview deployment:
- `https://<project>-<branch>-<team>.vercel.app`
- Separate environment variables for preview

### Preview Environment Variables

```bash
# Different values for preview vs production
# In Vercel Dashboard, set both:

DATABASE_URL (Production): postgres://prod-db...
DATABASE_URL (Preview): postgres://staging-db...
```

### Commenting on PRs

Vercel automatically comments on PRs with:
- Preview URL
- Build status
- Performance metrics

## Troubleshooting

### Build Failures

```bash
# Check build locally first
npm run build

# Common issues:
# - Missing environment variables
# - TypeScript errors
# - ESLint errors (strict mode)
# - Missing dependencies
```

### Environment Variable Issues

```bash
# Verify variables are set
vercel env ls

# Pull to local for debugging
vercel env pull .env.local
```

### Function Timeout

```typescript
// Increase timeout (max 60s on Pro, 10s on Hobby)
// In vercel.json:
{
  "functions": {
    "api/long-running.ts": {
      "maxDuration": 60
    }
  }
}
```

### Memory Issues

```typescript
// Increase memory (affects cost)
{
  "functions": {
    "api/heavy-processing.ts": {
      "memory": 1024
    }
  }
}
```

## Monitoring

### Vercel Analytics

```typescript
// src/app/layout.tsx
import { Analytics } from '@vercel/analytics/react';

export default function RootLayout({ children }) {
  return (
    <html>
      <body>
        {children}
        <Analytics />
      </body>
    </html>
  );
}
```

### Speed Insights

```typescript
import { SpeedInsights } from '@vercel/speed-insights/next';

export default function RootLayout({ children }) {
  return (
    <html>
      <body>
        {children}
        <SpeedInsights />
      </body>
    </html>
  );
}
```

### Function Logs

```bash
# View logs via CLI
vercel logs <deployment-url>

# Real-time logs
vercel logs <deployment-url> --follow
```

## Domains

### Custom Domain Setup

1. Vercel Dashboard → Domains
2. Add domain
3. Configure DNS:
   - A record: `76.76.21.21`
   - Or CNAME: `cname.vercel-dns.com`
4. SSL automatically provisioned

### Redirects

```json
// vercel.json
{
  "redirects": [
    {
      "source": "/:path((?!api/).*)",
      "has": [{ "type": "host", "value": "old-domain.com" }],
      "destination": "https://new-domain.com/:path",
      "permanent": true
    }
  ]
}
```

## Security

### Protected Routes

Use middleware for authentication checks (see Edge Functions above).

### Rate Limiting

Implement application-level rate limiting since Vercel doesn't provide built-in rate limiting for serverless functions.

### Secrets Management

- Never commit `.env` files
- Use Vercel's encrypted environment variables
- Rotate secrets regularly
- Different secrets for preview vs production

## References

- [Vercel Documentation](https://vercel.com/docs)
- [Environment Variables](https://vercel.com/docs/environment-variables)
- [Edge Functions](https://vercel.com/docs/functions/edge-functions)
- [Next.js on Vercel](https://vercel.com/docs/frameworks/nextjs)

© curiositech · MIT · curiositech/some_claude_skills

Похожие скиллы

Все скиллы по теме «DevOps и инфраструктура» →

Сначала — vercel-deployment от других авторов.

vercel-deployment sickn33 Скилл vercel-deployment для Claude Code добавляет агенту порядок деплоя Next.js-приложений на Vercel. Включается, когда в задаче появляются vercel, deploy, production или переменные окружения. CX Codex +1 1 800установок vercel-deployment davila7 Скилл vercel-deployment для Claude, который подсказывает, как правильно выкатывать Next.js на Vercel: переменные окружения, edge и serverless, кэш сборки. CX Codex +1 124установок vercel-deployment-specialist davila7 Субагент vercel-deployment-specialist настраивает развёртывание проектов на платформе Vercel, готовит конфигурацию vercel.json и пишет код для Edge Functions. CX Codex 1 309установок aspire-deployment Microsoft Скилл aspire-deployment для Claude Code публикует и развёртывает Aspire-приложения из модели AppHost. Срабатывает на запросы о деплое, публикации артефактов и удалении развёрнутых ресурсов. CX Codex +1 1 200установок vercel-deployments devops-skills Скилл vercel-deployments для деплоя фронтенда и фулстек-приложений на Vercel: превью, edge-функции, переменные окружения и защита продакшена. CX Codex +1 351установок vercel membrane Скилл для работы с Vercel через Membrane: создавайте проекты, управляйте развёртываниями, переменными окружения и доменами прямо из агента. Нужен аккаунт Membrane (поддерживается бесплатный тариф). CX Codex +1 258установок vercel-deploy-optimize davila7 Команда vercel-deploy-optimize для Claude Code, которая оптимизирует и разворачивает Next.js-приложение на Vercel с мониторингом производительности. CX Codex +1 506установок vercel-deployment-cursorrules-prompt-file PatrickJS Правило vercel-deployment-cursorrules-prompt-file для Cursor, которое подсказывает агенту, как готовить проект к деплою на Vercel. Задаёт структуру API-роутов, настройки vercel.json, работу с переменными окружения и кеширование. CX Codex +1 ★ 41 178звёзд репо

Из того же набора180

Весь набор →
2000s-visualization-expert Скилл 2000s-visualization-expert для Claude Code воссоздаёт визуализации нулевых — Milkdrop, AVS и Geiss — на WebGL и Web Audio API. Создаёт аудиореактивный фон для плеера или генеративный арт под музыку. CX Codex +1 190установок cloudflare-worker-dev Скилл cloudflare-worker-dev помогает проектировать Cloudflare Workers для API на edge, кэширования, лимитов запросов и координации в реальном времени. CX Codex +1 189установок clip-aware-embeddings Скилл clip-aware-embeddings помогает ИИ выбирать между CLIP и специализированными моделями для поиска и классификации картинок. Предотвращает ошибки при подсчёте объектов или анализе геометрии. CX Codex +1 188установок code-necromancer Скилл code-necromancer помогает разобраться в унаследованном или давно заброшенном коде, запустить проект и составить план модернизации. Сначала он предлагает изучить устройство системы, а уже потом менять её. CX Codex +1 187установок speech-pathology-ai Скилл speech-pathology-ai направляет ассистента в задачах логопедии: расчёт акустических параметров фонем, анализ артикуляции и разработка ассистивных речевых интерфейсов. CX Codex +1 186установок code-review-checklist Скилл code-review-checklist для Claude Code создаёт чек-лист ревью по изменениям в PR с учётом языка и соглашений проекта. Он выделяет пункты, на которых стоит сосредоточиться при проверке. CX Codex +1 185установок modern-drug-rehab-computer Скилл modern-drug-rehab-computer объясняет подходы к лечению зависимости и предлагает техники для работы с тягой и стрессом. Пригодится, чтобы разобраться в вариантах поддержки и подготовить вопросы лечащей команде. CX Codex +1 185установок hr-network-analyst Скилл hr-network-analyst строит графы профессиональных связей и находит неявных коннекторов по метрикам центральности. Помогает подбирать людей для рекомендаций и выявлять структурные дыры в профсообществах. CX Codex +1 184установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой