1# Vercel Deployment
2 
3Turborepo integrates seamlessly with Vercel for monorepo deployments.
4 
5## Remote Cache
6 
7Remote caching is **automatically enabled** when deploying to Vercel. No configuration needed - Vercel detects Turborepo and enables caching.
8 
9This means:
10 
11- No `TURBO_TOKEN` or `TURBO_TEAM` setup required on Vercel
12- Cache is shared across all deployments
13- Preview and production builds benefit from cache
14 
15## turbo-ignore
16 
17Skip unnecessary builds when a package hasn't changed using `turbo-ignore`.
18 
19### Installation
20 
21```bash
22npx turbo-ignore
23```
24 
25Or install globally in your project:
26 
27```bash
28pnpm add -D turbo-ignore
29```
30 
31### Setup in Vercel
32 
331. Go to your project in Vercel Dashboard
342. Navigate to Settings > Git > Ignored Build Step
353. Select "Custom" and enter:
36 
37```bash
38npx turbo-ignore
39```
40 
41### How It Works
42 
43`turbo-ignore` checks if the current package (or its dependencies) changed since the last successful deployment:
44 
451. Compares current commit to last deployed commit
462. Uses Turborepo's dependency graph
473. Returns exit code 0 (skip) if no changes
484. Returns exit code 1 (build) if changes detected
49 
50### Options
51 
52```bash
53# Check specific package
54npx turbo-ignore web
55 
56# Use specific comparison ref
57npx turbo-ignore --fallback=HEAD~1
58 
59# Verbose output
60npx turbo-ignore --verbose
61```
62 
63## Environment Variables
64 
65Set environment variables in Vercel Dashboard:
66 
671. Go to Project Settings > Environment Variables
682. Add variables for each environment (Production, Preview, Development)
69 
70Common variables:
71 
72- `DATABASE_URL`
73- `API_KEY`
74- Package-specific config
75 
76## Monorepo Root Directory
77 
78For monorepos, set the root directory in Vercel:
79 
801. Project Settings > General > Root Directory
812. Set to the package path (e.g., `apps/web`)
82 
83Vercel automatically:
84 
85- Installs dependencies from monorepo root
86- Runs build from the package directory
87- Detects framework settings
88 
89## Build Command
90 
91Vercel auto-detects `turbo run build` when `turbo.json` exists at root.
92 
93Override if needed:
94 
95```bash
96turbo run build --filter=web
97```
98 
99Or for production-only optimizations:
100 
101```bash
102turbo run build --filter=web --env-mode=strict
103```
104