Configure options below — the preview updates in real time.

Global Options

Root-level settings that define the overarching behavior of the Turborepo build system.

Enables IDE autocompletion and validation using JSON Schema.

Used in Package Configurations to inherit from root turbo.json. Must begin with '//'.

File globs relative to the workspace root that impact the hash of all tasks. Changes to these files cause all tasks to miss the cache.

Environment variables that impact the cache hash of all tasks. Supports wildcards and negations.

Environment variables made available to tasks without impacting the global hash. Enables Strict Environment Variable Mode.

Controls which environment variables are exposed at runtime. 'strict' filters to explicitly listed variables only.

The directory where Turborepo writes and reads its local filesystem cache.

Set the maximum concurrency for task execution. Must be an integer >= 1 or a percentage value like '50%'. Use '1' for serial execution.

Specifies the UI layout for terminal output.

Disable Package Manager CheckSkip the package manager validation step. Use with caution.
No Update NotifierDisable the update notification message when a newer version of Turborepo is available.

Remote Cache

Configuration for connecting to a Remote Cache provider like Vercel.

EnabledEnable or disable remote caching. When false, all remote cache operations are disabled even if the repo has a valid token.

Endpoint for API calls to the remote cache.

Endpoint for requesting tokens during the turbo login flow.

The ID of the Remote Cache team. Must start with 'team_'.

The slug of the Remote Cache team.

Signature VerificationEnable verification of remote cache artifact cryptographic signatures.
PreflightEnable preflight requests for remote cache operations.

Timeout for remote cache operations in whole seconds. Set to 0 for no timeout.

Timeout for remote cache upload operations in whole seconds. Set to 0 for no timeout.

Build Task

Configuration for the 'build' task pipeline.

Tasks that must complete before build begins. Use '^build' for workspace dependency builds.

^build

Files and directories to cache once build completes. Empty means no artifacts are cached.

dist/**.next/**!.next/cache/**

Files to include in the build task hash. $TURBO_DEFAULT$ tracks all git-tracked files.

$TURBO_DEFAULT$

Environment variables that specifically impact this task's hash.

Environment variables available to the task without impacting its hash.

Controls the verbosity of log output for cached builds.

CacheWhether to cache the outputs of this task.
PersistentMark as a long-running process that does not exit (e.g. dev servers). Persistent tasks cannot be depended on.
InteractiveMark as an interactive task that requires stdin input.
InterruptibleAllow turbo watch to restart this task when inputs change.

Dev Task

Configuration for the 'dev' task pipeline (development servers).

Tasks that must complete before dev begins.

^build

Files to cache for the dev task. Typically empty since dev servers produce no cacheable output.

Environment variables impacting the dev task hash.

Controls the verbosity of log output for the dev task.

CacheWhether to cache the dev task outputs.
PersistentMark dev as a long-running process that does not exit.
InteractiveMark as an interactive task that requires stdin input.
InterruptibleAllow turbo watch to restart this task when inputs change.

Lint Task

Configuration for the 'lint' task pipeline.

Tasks that must complete before lint begins.

^build

Files to cache for the lint task.

Files to include in the lint task hash.

$TURBO_DEFAULT$

Environment variables impacting the lint task hash.

Controls lint log verbosity.

CacheWhether to cache the lint task outputs.
PersistentMark lint as long-running.
InterruptibleAllow turbo watch to restart this task when inputs change.

Test Task

Configuration for the 'test' task pipeline.

Tasks that must complete before test begins.

^build

Files to cache for the test task (e.g. coverage reports).

Files to include in the test task hash.

$TURBO_DEFAULT$

Environment variables impacting the test task hash.

Controls test log verbosity.

CacheWhether to cache the test task outputs.
PersistentMark test as long-running.
InterruptibleAllow turbo watch to restart this task when inputs change.

Type Check Task

Configuration for a 'typecheck' or 'check-types' task pipeline.

Tasks that must complete before typecheck begins.

^build

Files to cache for the typecheck task.

Files to include in the typecheck task hash.

$TURBO_DEFAULT$

Environment variables impacting the typecheck hash.

Controls typecheck log verbosity.

CacheWhether to cache the typecheck task outputs.
PersistentMark typecheck as long-running.
InterruptibleAllow turbo watch to restart this task when inputs change.