turborepo

Use when managing monorepos with Turborepo — workspace setup, pipeline configuration, caching, or multi-package builds. Also use when deciding on a monorepo strategy or optimizing build times in a multi-package project.

Model	Source
sonnet	pack: tooling

Full Reference

┏━ 🔧 turborepo ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓ ┃ Use when managing monorepos with Turborepo — w… ┃ ┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛

Turborepo

Turborepo (v2.7, December 2025) is a Rust-powered build system for JavaScript/TypeScript monorepos. It caches task outputs locally and remotely, runs tasks in parallel, and understands the dependency graph between packages so builds always run in the right order.

The key v2.x breaking change: pipeline was renamed to tasks and removed in 2.0. Remote caching via Vercel is free for all repos since January 2025.

Quick Reference

Item	Value
Current version	2.7.x (December 2025)
Create new repo	npx create-turbo@latest
Add to existing	npx turbo@latest init
Config file	turbo.json or turbo.jsonc (since 2.3)
Schema (local)	"$schema": "./node_modules/turbo/schema.json"
Cache dir	.turbo/cache/ (add .turbo to .gitignore)
Run all builds	turbo run build
Run affected only	turbo run build --affected
Link remote cache	turbo login && turbo link
Visual task graph	turbo devtools (2.7+)
Docs	turborepo.dev

Reference Index

I want to…	File
Set up workspace structure and install Turborepo	reference/setup.md
Configure turbo.json tasks and task dependencies	reference/pipeline.md
Understand cache keys, outputs, inputs, and env vars	reference/caching.md
Set up Vercel remote cache or a self-hosted cache server	reference/remote-caching.md
Create and configure internal shared packages	reference/workspace-packages.md
Filter tasks, run affected packages, build with Docker, or configure CI	reference/filtering.md

Usage: Read the reference file matching your current task from the index above. Each file is self-contained with code examples and inline gotchas.