{"id":14989,"library":"turbo","title":"Turborepo","description":"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.","status":"active","version":"2.9.6","language":"javascript","source_language":"en","source_url":"https://github.com/vercel/turborepo","tags":["javascript"],"install":[{"cmd":"npm install turbo","lang":"bash","label":"npm"},{"cmd":"yarn add turbo","lang":"bash","label":"yarn"},{"cmd":"pnpm add turbo","lang":"bash","label":"pnpm"}],"dependencies":[],"imports":[],"quickstart":{"code":"npx create-turbo@latest my-monorepo\ncd my-monorepo\npnpm install\nnpx turbo dev","lang":"typescript","description":"This demonstrates how to initialize a new Turborepo monorepo, install dependencies, and run a development script across all workspaces."},"warnings":[{"fix":"Update your CI/CD configurations and re-authenticate using the new OAuth/device flows. Consult the Turborepo (v2.9.7+) documentation for details.","message":"Turborepo 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.","severity":"breaking","affected_versions":">=2.9.7"},{"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.","message":"Even 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.","severity":"gotcha","affected_versions":">=2.9.6"}],"env_vars":null,"last_verified":"2026-04-18T00:00:00.000Z","next_check":"2026-07-17T00:00:00.000Z","problems":[{"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).","cause":"Vercel authentication token is expired, invalid, or permissions are insufficient, or the authentication flow has changed.","error":"Error: Failed to authenticate with Vercel for remote caching."},{"fix":"Upgrade Turborepo to v2.9.7 or newer to ensure full compatibility with pnpm v11 lockfiles.","cause":"Using pnpm v11 multi-document lockfiles with Turborepo versions prior to 2.9.7.","error":"Error: Failed to parse pnpm-lock.yaml: unknown format version"},{"fix":"Upgrade Turborepo to v2.9.7 or newer to benefit from improved graceful shutdown handling.","cause":"Turborepo process or its child processes did not terminate gracefully, potentially leading to hanging processes or incorrect exit codes in CI/CD environments.","error":"Error: Task 'build' did not exit cleanly"}],"ecosystem":"npm"}