Turborepo v2.5.5stable Released Jul 16, 2025
⚠️ Breaking Change Impact Score: 7/10

Turborepo v2.5.5

Source available β€” automated, not human-reviewed

Component: turbo Β· Channel: stable. Automated analysis, not a compatibility certification. How this works.

Analysis updated: 2026-11-01.

Breaking-change evidence from the source

  • feat: opt into breaking changes and pre-stable features early with `turbo.json` configuration by @anthonyshew in https://github.com/vercel/turborepo/pull/10590
Read the original context β†—
Source flags breaking changes β€” review applicability
$ npm install --save-dev --save-exact [email protected]
πŸ“„ .MD
⚑ Executive Summary (TL;DR)

Turborepo v2.5.5. Source highlight: fix(docs): use `pnpm add <pkg>` instead of `pnpm install <pkg>`

Who Does This Impact? (Role-Based Analysis)

πŸ’» Software Engineers & Devs

Check the source notes against the package and APIs you use before upgrading.

πŸ“Š Product & Engineering Leads

Use the documented changes to assess relevance to your product; release frequency alone is not a quality measure.

βš™οΈ DevOps & Security

Verify the target version, runtime requirements and rollback procedure in the official documentation.

⚠️ Breaking Changes & Deprecations (1)

  • feat: opt into breaking changes and pre-stable features early with `turbo.json` configuration by @anthonyshew in https://github.com/vercel/turborepo/pull/10590

✨ New Features & Capabilities (6)

  • feat(auth): optional callback port
  • feat(turbo.json): allow for trailing commas
  • feat(env): add Windows user profile variables to pass-through
  • feat: opt into breaking changes and pre-stable features early with `turbo.json` configuration
  • refactor: add spans to some turbo.json fields
  • chore: add unit test coverage reporter

⚑ Performance & Enhancements (2)

  • refactor: improve messaging in global warning
  • test(turborepo-analytics): improve unit test coverage

πŸ”§ Bug Fixes & Patches (6)

  • fix(docs): use `pnpm add <pkg>` instead of `pnpm install <pkg>`
  • fix(docs): missing commas in package.json files of jest docs
  • fix(docs): css import order bug in tailwindcss docs and example
  • docs: logo fix
  • fix(docs): incorrect CSS filename in Tailwind CSS setup example
  • fix(docs): inconsistent command with the illustration
πŸ“„ View Raw Release Notes (Original Developer Log)
<!-- Release notes generated using configuration in .github/release.yml at v2.5.5 --> ## What's Changed ### Docs * fix(docs): use `pnpm add <pkg>` instead of `pnpm install <pkg>` by @jferrettiboke in https://github.com/vercel/turborepo/pull/10529 * fix(docs): missing commas in package.json files of jest docs by @ashish0kumar in https://github.com/vercel/turborepo/pull/10560 * fix(docs): css import order bug in tailwindcss docs and example by @ashish0kumar in https://github.com/vercel/turborepo/pull/10561 * docs: logo fix by @anthonyshew in https://github.com/vercel/turborepo/pull/10562 * chore: bump to [email protected] by @mischnic in https://github.com/vercel/turborepo/pull/10530 * fix(docs): incorrect CSS filename in Tailwind CSS setup example by @jihwan1211 in https://github.com/vercel/turborepo/pull/10573 * docs: clarity for GitHub Actions caching strategies by @anthonyshew in https://github.com/vercel/turborepo/pull/10583 * fix(docs): inconsistent command with the illustration by @wilsonwangdev in https://github.com/vercel/turborepo/pull/10596 * fix(docs): inconsistent turbo command with the illustration by @wilsonwangdev in https://github.com/vercel/turborepo/pull/10602 * docs: update Vitest recommendations by @anthonyshew in https://github.com/vercel/turborepo/pull/10621 * docs: clarify default inputs behavior by @anthonyshew in https://github.com/vercel/turborepo/pull/10628 * docs: fixing --no-cache alert by @0ri0nexe in https://github.com/vercel/turborepo/pull/10653 * feat(auth): optional callback port by @anthonyshew in https://github.com/vercel/turborepo/pull/10666 ### Examples * fix: with-svelte example builds by @anthonyshew in https://github.com/vercel/turborepo/pull/10517 * chore(deps-dev): bump the basic group in /examples/basic with 3 updates by @dependabot[bot] in https://github.com/vercel/turborepo/pull/10531 * chore(deps-dev): bump the with-svelte group in /examples/with-svelte with 3 updates by @dependabot[bot] in https://github.com/vercel/turborepo/pull/10532 * chore(deps-dev): bump turbo from 2.5.3 to 2.5.4 in /examples/with-shell-commands by @dependabot[bot] in https://github.com/vercel/turborepo/pull/10533 * chore(deps-dev): bump the with-tailwind group in /examples/with-tailwind with 3 updates by @dependabot[bot] in https://github.com/vercel/turborepo/pull/10534 * chore(deps): bump the non-monorepo group in /examples/non-monorepo with 6 updates by @dependabot[bot] in https://github.com/vercel/turborepo/pull/10535 * chore(deps-dev): bump the kitchen-sink group in /examples/kitchen-sink with 5 updates by @dependabot[bot] in https://github.com/vercel/turborepo/pull/10536 * chore(deps-dev): bump eslint-plugin-react from 7.37.4 to 7.37.5 in /examples/basic by @dependabot[bot] in https://github.com/vercel/turborepo/pull/10553 * chore(deps): bump the non-monorepo group in /examples/non-monorepo with 3 updates by @dependabot[bot] in https://github.com/vercel/turborepo/pull/10554 * chore(deps-dev): bump @types/node from 22.15.3 to 22.15.30 in /examples/with-tailwind by @dependabot[bot] in https://github.com/vercel/turborepo/pull/10555 * chore(deps-dev): bump @sveltejs/vite-plugin-svelte from 5.0.3 to 5.1.0 in /examples/with-svelte in the with-svelte group by @dependabot[bot] in https://github.com/vercel/turborepo/pull/10556 * chore(deps-dev): bump @vitejs/plugin-react from 4.5.0 to 4.5.1 in /examples/kitchen-sink by @dependabot[bot] in https://github.com/vercel/turborepo/pull/10557 * fix(example/with-docker): jest can’t resolve @repo/jest-presets/node by @d0lwl0b in https://github.com/vercel/turborepo/pull/10551 * fix(non-monorepo): correct devDependency from 'turb' to 'turbo' by @DiegoDev2 in https://github.com/vercel/turborepo/pull/10526 * chore(deps-dev): bump the basic group in /examples/basic with 3 updates by @dependabot[bot] in https://github.com/vercel/turborepo/pull/10567 * chore(deps): bump the kitchen-sink group in /examples/kitchen-sink with 6 updates by @dependabot[bot] in https://github.com/vercel/turborepo/pull/10568 * chore(deps-dev): bump the with-svelte group in /examples/with-svelte with 4 updates by @dependabot[bot] in https://github.com/vercel/turborepo/pull/10569 * chore(deps-dev): bump the with-tailwind group in /examples/with-tailwind with 3 updates by @dependabot[bot] in https://github.com/vercel/turborepo/pull/10570 * fix(example): add missing Tailwind import to shared ui styles by @sahyl in https://github.com/vercel/turborepo/pull/10579 * chore(deps-dev): bump eslint from 9.28.0 to 9.29.0 in /examples/non-monorepo in the non-monorepo group by @dependabot[bot] in https://github.com/vercel/turborepo/pull/10571 * docs(example): use npx turbo and show filtering by @sdavids in https://github.com/vercel/turborepo/pull/10500 * chore(deps-dev): bump the kitchen-sink group in /examples/kitchen-sink with 2 updates by @dependabot[bot] in https://github.com/vercel/turborepo/pull/10594 * chore(deps-dev): bump prettier from 3.5.3 to 3.6.0 in /examples/with-tailwind in the with-tailwind group by @dependabot[bot] in https://github.com/vercel/turborepo/pull/10595 * chore(deps-dev): bump prettier from 3.5.3 to 3.6.0 in /examples/basic in the basic group by @dependabot[bot] in https://github.com/vercel/turborepo/pull/10597 * chore(deps-dev): bump the with-svelte group in /examples/with-svelte with 2 updates by @dependabot[bot] in https://github.com/vercel/turborepo/pull/10598 * chore(deps): bump next from 15.3.3 to 15.3.4 in /examples/non-monorepo by @dependabot[bot] in https://github.com/vercel/turborepo/pull/10593 * chore(deps-dev): bump the with-svelte group in /examples/with-svelte with 3 updates by @dependabot[bot] in https://github.com/vercel/turborepo/pull/10613 * chore(deps-dev): bump the basic group in /examples/basic with 3 updates by @dependabot[bot] in https://github.com/vercel/turborepo/pull/10614 * chore(deps-dev): bump the kitchen-sink group in /examples/kitchen-sink with 5 updates by @dependabot[bot] in https://github.com/vercel/turborepo/pull/10615 * chore(deps-dev): bump the with-tailwind group in /examples/with-tailwind with 3 updates by @dependabot[bot] in https://github.com/vercel/turborepo/pull/10616 * refactor(examples): remove duplicate Next.js plugin from app tsconfig files by @JeongHwan-dev in https://github.com/vercel/turborepo/pull/10612 * chore(deps-dev): bump globals from 16.2.0 to 16.3.0 in /examples/kitchen-sink in the kitchen-sink group by @dependabot[bot] in https://github.com/vercel/turborepo/pull/10643 * chore(deps-dev): bump globals from 16.2.0 to 16.3.0 in /examples/with-tailwind in the with-tailwind group by @dependabot[bot] in https://github.com/vercel/turborepo/pull/10644 * chore(deps-dev): bump svelte from 5.34.3 to 5.35.2 in /examples/with-svelte in the with-svelte group by @dependabot[bot] in https://github.com/vercel/turborepo/pull/10645 * chore(deps-dev): bump eslint from 9.29.0 to 9.30.1 in /examples/non-monorepo in the non-monorepo group by @dependabot[bot] in https://github.com/vercel/turborepo/pull/10647 * chore(deps-dev): bump globals from 16.2.0 to 16.3.0 in /examples/basic in the basic group by @dependabot[bot] in https://github.com/vercel/turborepo/pull/10646 * fix(examples): css specificity in Tailwind example by @anthonyshew in https://github.com/vercel/turborepo/pull/10657 * refactor(examples): update CSS variable names to use consistent --color- prefix in tailwind examples by @eric-hjh in https://github.com/vercel/turborepo/pull/10662 * fix(examples): vitest version upgrade by @anthonyshew in https://github.com/vercel/turborepo/pull/10667 * chore(deps-dev): bump the with-svelte group in /examples/with-svelte with 3 updates by @dependabot[bot] in https://github.com/vercel/turborepo/pull/10669 * chore(deps-dev): bump the kitchen-sink group in /examples/kitchen-sink with 5 updates by @dependabot[bot] in https://github.com/vercel/turborepo/pull/10670 * fix: typescript-config export form react-native-web by @safaiyeh in https://github.com/vercel/turborepo/pull/10671 * chore(deps-dev): bump the basic group in /examples/basic with 3 updates by @dependabot[bot] in https://github.com/vercel/turborepo/pull/10673 * fix(examples): update vitest config paths for packages and apps in `with-vitest` by @kenfdev in https://github.com/vercel/turborepo/pull/10675 * chore(deps-dev): bump the with-tailwind group in /examples/with-tailwind with 3 updates by @dependabot[bot] in https://github.com/vercel/turborepo/pull/10674 * chore(deps-dev): bump eslint from 9.30.1 to 9.31.0 in /examples/non-monorepo in the non-monorepo group by @dependabot[bot] in https://github.com/vercel/turborepo/pull/10672 ### Changelog * feat(turbo.json): allow for trailing commas by @chris-olszewski in https://github.com/vercel/turborepo/pull/10537 * fix(pnpm): respect deep for linkWorkspacePackages by @chris-olszewski in https://github.com/vercel/turborepo/pull/10558 * fix: vue/nuxt devtool component inspector by @NamesMT in https://github.com/vercel/turborepo/pull/10527 * chore: typo Fixes and Clarity Enhancements by @leopardracer in https://github.com/vercel/turborepo/pull/10574 * chore: fix formatting in JSON file by @anthonyshew in https://github.com/vercel/turborepo/pull/10589 * feat(env): add Windows user profile variables to pass-through by @yamadayutaka in https://github.com/vercel/turborepo/pull/10588 * feat: opt into breaking changes and pre-stable features early with `turbo.json` configuration by @anthonyshew in https://github.com/vercel/turborepo/pull/10590 * refactor(turborepo-updater): chain environment variable iterators in should_skip_notification by @JeongHwan-dev in https://github.com/vercel/turborepo/pull/10622 * chore: remove unused Rust dependencies by @anthonyshew in https://github.com/vercel/turborepo/pull/10630 * refactor: add spans to some turbo.json fields by @anthonyshew in https://github.com/vercel/turborepo/pull/10627 * chore: .cursor/rules by @anthonyshew in https://github.com/vercel/turborepo/pull/10636 * refactor: improve messaging in global warning by @anthonyshew in https://github.com/vercel/turborepo/pull/10629 * refactor: consolidate configuration file resolving by @anthonyshew in https://github.com/vercel/turborepo/pull/10619 * chore(@turbo/telemetry): fix README link by @robmorgan in https://github.com/vercel/turborepo/pull/10603 * chore: add unit test coverage reporter by @anthonyshew in https://github.com/vercel/turborepo/pull/10641 * test(telemetry): add telemetry API client tests by @anthonyshew in https://github.com/vercel/turborepo/pull/10650 * test(turborepo-analytics): improve unit test coverage by @anthonyshew in https://github.com/vercel/turborepo/pull/10651 * refactor: move config file discovery to shared util by @anthonyshew in https://github.com/vercel/turborepo/pull/10677 * fix(query): pin to last graphiql version with artifacts by @chris-olszewski in https://github.com/vercel/turborepo/pull/10685 ## New Contributors * @d0lwl0b made their first contribution in https://github.com/vercel/turborepo/pull/10551 * @ashish0kumar made their first contribution in https://github.com/vercel/turborepo/pull/10560 * @DiegoDev2 made their first contribution in https://github.com/vercel/turborepo/pull/10526 * @jihwan1211 made their first contribution in https://github.com/vercel/turborepo/pull/10573 * @leopardracer made their first contribution in https://github.com/vercel/turborepo/pull/10574 * @sahyl made their first contribution in https://github.com/vercel/turborepo/pull/10579 * @yamadayutaka made their first contribution in https://github.com/vercel/turborepo/pull/10588 * @sdavids made their first contribution in https://github.com/vercel/turborepo/pull/10500 * @wilsonwangdev made their first contribution in https://github.com/vercel/turborepo/pull/10596 * @JeongHwan-dev made their first contribution in https://github.com/vercel/turborepo/pull/10612 * @robmorgan made their first contribution in https://github.com/vercel/turborepo/pull/10603 * @0ri0nexe made their first contribution in https://github.com/vercel/turborepo/pull/10653 * @eric-hjh made their first contribution in https://github.com/vercel/turborepo/pull/10662 * @safaiyeh made their first contribution in https://github.com/vercel/turborepo/pull/10671 * @kenfdev made their first contribution in https://github.com/vercel/turborepo/pull/10675 **Full Changelog**: https://github.com/vercel/turborepo/compare/v2.5.4...v2.5.5