turbo
Setup
npm i -g turbo
Verify installation:
turbo --version
Requires a turbo.json configuration file in the project root.
Authentication
turbo login
Link to a Vercel team for remote caching:
turbo link
Resources
Running Tasks
| Command | Description |
|---|
turbo run build | Run build task across all packages |
turbo run test | Run test task across all packages |
turbo run lint | Run lint task across all packages |
turbo run build test lint | Run multiple tasks |
turbo run build --filter=<package> | Run task for a specific package |
turbo run build --filter=<package>... | Run task for a package and its dependencies |
turbo run build --filter=...<package> | Run task for a package and its dependents |
turbo run build --filter='[HEAD~1]' | Run task only for changed packages |
turbo run build --dry-run | Preview which tasks would run |
turbo run build --graph | Generate a task dependency graph |
turbo run build --force | Force execution, ignoring cache |
turbo run build --concurrency=4 | Limit parallel task execution |
turbo run build --continue | Continue running even if a task fails |
Pruning
| Command | Description |
|---|
turbo prune <package> | Generate a sparse monorepo for a specific package |
turbo prune <package> --docker | Generate pruned output optimized for Docker |
Code Generation
| Command | Description |
|---|
turbo gen | Run a generator |
turbo gen workspace | Generate a new workspace package |
turbo gen workspace --name <name> | Generate a named workspace package |
Daemon
| Command | Description |
|---|
turbo daemon status | Show daemon status |
turbo daemon start | Start the turbo daemon |
turbo daemon stop | Stop the turbo daemon |
Remote Caching
| Command | Description |
|---|
turbo login | Login to remote cache provider |
turbo link | Link project to remote cache |
turbo unlink | Unlink project from remote cache |
Global Flags
| Flag | Description |
|---|
--filter=<pattern> | Filter packages to run tasks on |
--force | Ignore cache and force execution |
--dry-run | Preview tasks without executing |
--concurrency=<n> | Set max parallel tasks |
--graph | Generate a dependency graph |
--output-logs=<mode> | Control log output (full, hash-only, new-only, none) |
--env-mode=<mode> | Control environment variable handling (strict, loose) |