turbo

library2.9.6jsnpmunverified

Turborepo is a high-performance build system designed for JavaScript and TypeScript monorepos. It optimizes builds and tests using caching and parallel execution. The current stable version is 2.9.6, with frequent canary releases pushing fixes and new features.

devops

npm install turbo

github ↗package ↗homepage ↗

INSTALL

IMPORT

SIG · TURBO

turbo

devopsjavascriptv2.9.6

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

This demonstrates how to initialize a new Turborepo monorepo, install dependencies, and run a development script across all workspaces.

npx create-turbo@latest my-monorepo cd my-monorepo pnpm install npx turbo dev

turbo --version

Debug

Known issues

breakingTurborepo v2.9.7 introduces a transition to standard OAuth/device flows for Vercel authentication. This is a breaking change for existing setups relying on legacy token methods for remote caching, including CI/CD.

fix

Update your CI/CD configurations and re-authenticate using the new OAuth/device flows. Consult the Turborepo (v2.9.7+) documentation for details.

affects: >=2.9.7

gotchaEven with recent fixes, users might encounter transient issues with Vercel authentication token persistence across login flows or after updates. This can lead to unexpected remote cache misses.

fix

If remote caching fails unexpectedly, try re-running `npx turbo login` to refresh your authentication tokens. Ensure Vercel environment variables are correctly set in CI/CD.

affects: >=2.9.6

Errors

Common errors & fixes

Error: Failed to authenticate with Vercel for remote caching.

Vercel authentication token is expired, invalid, or permissions are insufficient, or the authentication flow has changed.

fix

Run `npx turbo login` to re-authenticate or verify `TURBO_TOKEN` in CI/CD. Refer to documentation for the latest authentication procedures (especially for versions >=2.9.7).

Error: Failed to parse pnpm-lock.yaml: unknown format version

Using pnpm v11 multi-document lockfiles with Turborepo versions prior to 2.9.7.

fix

Upgrade Turborepo to v2.9.7 or newer to ensure full compatibility with pnpm v11 lockfiles.

Error: Task 'build' did not exit cleanly

Turborepo process or its child processes did not terminate gracefully, potentially leading to hanging processes or incorrect exit codes in CI/CD environments.

fix

Upgrade Turborepo to v2.9.7 or newer to benefit from improved graceful shutdown handling.

Upgrade

Version history

2.9.6latest on npm

Audit

Dependencies

No dependency data recorded yet.

Agent activity

6 hits · last 30 days

node

Resources

githubhttps://github.com/vercel/turborepo ↗

packagehttps://www.npmjs.com/package/turbo ↗

homepagehttps://turbo.build ↗