Setting the file. One moment.
Subchapter 9.18
references/configuration/tasks.mdMarkdown7 KBView on GitHub
Controls task execution order.
{
"tasks": {
"build": {
"dependsOn": [
"^build", // Dependencies' build tasks first
"codegen", // Same package's codegen task first
"shared#build" // Specific package's build task
]
}
}
}| Syntax | Meaning |
|---|---|
^task | Run task in all dependencies first |
task | Run task in same package first |
pkg#task | Run specific package’s task first |
The ^ prefix is crucial - without it, you’re referencing the same package.
For tasks like lint and check-types that can run in parallel but need dependency-aware caching:
{
"tasks": {
"transit": { "dependsOn": ["^transit"] },
"lint": { "dependsOn": ["transit"] },
"check-types": { "dependsOn": ["transit"] }
}
}DO NOT use dependsOn: ["^lint"] - this forces sequential execution.
DO NOT use dependsOn: [] - this breaks cache invalidation.
The transit task creates dependency relationships without running anything (no matching script), so tasks run in parallel with correct caching.
Glob patterns for files to cache. If omitted, nothing is cached.
{
"tasks": {
"build": {
"outputs": ["dist/**", "build/**"]
}
}
}Framework examples:
// Next.js
"outputs": [".next/**", "!.next/cache/**", "!.next/dev/**"]
// Vite
"outputs": ["dist/**"]
// TypeScript (tsc)
"outputs": ["dist/**", "*.tsbuildinfo"]
// No file outputs (lint, typecheck)
"outputs": []Use ! prefix to exclude patterns from caching.
Files considered when calculating task hash. Defaults to all tracked files in package.
{
"tasks": {
"test": {
"inputs": ["src/**", "tests/**", "vitest.config.ts"]
}
}
}Special values:
| Value | Meaning |
|---|---|
$TURBO_DEFAULT$ | Include default inputs, then add/remove |
$TURBO_ROOT$/<path> | Reference files from repo root |
{
"tasks": {
"build": {
"inputs": [
"$TURBO_DEFAULT$",
"!README.md",
"$TURBO_ROOT$/tsconfig.base.json"
]
}
}
}When futureFlags.globalConfiguration is enabled, files listed in global.inputs are prepended to every task’s inputs. The combined list is then used to compute the task hash.
This is different from globalDependencies, where files were hashed into the global hash and could not be influenced by task-level inputs.
With globalDependencies (old behavior):
globalDependencies files contribute to the global hashinputs only control which package files are hashedglobalDependencies fileWith global.inputs (new behavior):
global.inputs files are merged into each task’s inputs globsinputs and global.inputs are combined, then the full list is hashed into the task hash{
"futureFlags": { "globalConfiguration": true },
"global": {
"inputs": ["tsconfig.json", ".env"]
},
"tasks": {
"build": {},
"lint": {
"inputs": ["$TURBO_DEFAULT$", "!$TURBO_ROOT$/.env"]
}
}
}In this example:
build hashes all package files + tsconfig.json + .env (from global.inputs)lint hashes all package files + tsconfig.json, but excludes .env because of the negation globTasks with no explicit inputs key still hash all package files (the default behavior) plus the global.inputs files.
Environment variables to include in task hash.
{
"tasks": {
"build": {
"env": [
"API_URL",
"NEXT_PUBLIC_*", // Wildcard matching
"!DEBUG" // Exclude from hash
]
}
}
}Variables listed here affect cache hits - changing the value invalidates cache.
Enable/disable caching for a task. Default: true.
{
"tasks": {
"dev": { "cache": false },
"deploy": { "cache": false }
}
}Disable for: dev servers, deploy commands, tasks with side effects.
Mark long-running tasks that don’t exit. Default: false.
{
"tasks": {
"dev": {
"cache": false,
"persistent": true
}
}
}Required for dev servers - without it, dependent tasks wait forever.
Allow task to receive stdin input. Default: false.
{
"tasks": {
"login": {
"cache": false,
"interactive": true
}
}
}Control when logs are shown. Options: full, hash-only, new-only, errors-only, none.
{
"tasks": {
"build": {
"outputLogs": "new-only" // Only show logs on cache miss
}
}
}Run tasks alongside this task. For long-running tasks that need runtime dependencies.
{
"tasks": {
"dev": {
"with": ["api#dev"],
"persistent": true,
"cache": false
}
}
}Unlike dependsOn, with runs tasks concurrently (not sequentially). Use for dev servers that need other services running.
Allow turbo watch to restart the task on changes. Default: false.
{
"tasks": {
"dev": {
"persistent": true,
"interruptible": true,
"cache": false
}
}
}Use for dev servers that don’t automatically detect dependency changes.
Human-readable description of the task.
{
"tasks": {
"build": {
"description": "Compiles the application for production deployment"
}
}
}For documentation only - doesn’t affect execution or caching.
Environment variables available at runtime but NOT included in cache hash.
{
"tasks": {
"build": {
"passThroughEnv": ["AWS_SECRET_KEY", "GITHUB_TOKEN"]
}
}
}Warning: Changes to these vars won’t cause cache misses. Use env if changes should invalidate cache.
Control task inheritance in Package Configurations.
// packages/ui/turbo.json
{
"extends": ["//"],
"tasks": {
"lint": {
"extends": false // Exclude from this package
}
}
}| Value | Behavior |
|---|---|
true (default) | Inherit from root turbo.json |
false | Exclude task from package, or define fresh without inheritance |