Files
agent-skills/skills/turborepo/references/ci/vercel.md
Jason Woltje f5792c40be feat: Complete fleet — 94 skills across 10+ domains
Pulled ALL skills from 15 source repositories:
- anthropics/skills: 16 (docs, design, MCP, testing)
- obra/superpowers: 14 (TDD, debugging, agents, planning)
- coreyhaines31/marketingskills: 25 (marketing, CRO, SEO, growth)
- better-auth/skills: 5 (auth patterns)
- vercel-labs/agent-skills: 5 (React, design, Vercel)
- antfu/skills: 16 (Vue, Vite, Vitest, pnpm, Turborepo)
- Plus 13 individual skills from various repos

Mosaic Stack is not limited to coding — the Orchestrator and
subagents serve coding, business, design, marketing, writing,
logistics, analysis, and more.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-16 16:27:42 -06:00

2.1 KiB

Vercel Deployment

Turborepo integrates seamlessly with Vercel for monorepo deployments.

Remote Cache

Remote caching is automatically enabled when deploying to Vercel. No configuration needed - Vercel detects Turborepo and enables caching.

This means:

  • No TURBO_TOKEN or TURBO_TEAM setup required on Vercel
  • Cache is shared across all deployments
  • Preview and production builds benefit from cache

turbo-ignore

Skip unnecessary builds when a package hasn't changed using turbo-ignore.

Installation

npx turbo-ignore

Or install globally in your project:

pnpm add -D turbo-ignore

Setup in Vercel

  1. Go to your project in Vercel Dashboard
  2. Navigate to Settings > Git > Ignored Build Step
  3. Select "Custom" and enter:
npx turbo-ignore

How It Works

turbo-ignore checks if the current package (or its dependencies) changed since the last successful deployment:

  1. Compares current commit to last deployed commit
  2. Uses Turborepo's dependency graph
  3. Returns exit code 0 (skip) if no changes
  4. Returns exit code 1 (build) if changes detected

Options

# Check specific package
npx turbo-ignore web

# Use specific comparison ref
npx turbo-ignore --fallback=HEAD~1

# Verbose output
npx turbo-ignore --verbose

Environment Variables

Set environment variables in Vercel Dashboard:

  1. Go to Project Settings > Environment Variables
  2. Add variables for each environment (Production, Preview, Development)

Common variables:

  • DATABASE_URL
  • API_KEY
  • Package-specific config

Monorepo Root Directory

For monorepos, set the root directory in Vercel:

  1. Project Settings > General > Root Directory
  2. Set to the package path (e.g., apps/web)

Vercel automatically:

  • Installs dependencies from monorepo root
  • Runs build from the package directory
  • Detects framework settings

Build Command

Vercel auto-detects turbo run build when turbo.json exists at root.

Override if needed:

turbo run build --filter=web

Or for production-only optimizations:

turbo run build --filter=web --env-mode=strict