Turborepo v2.5.0stable Released Apr 03, 2025
Impact Score: 5/10

Turborepo v2.5.0

Source available โ€” automated, not human-reviewed

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

Analysis updated: 2026-11-01.

Compatibility not verified โ€” check source notes
$ npm install --save-dev --save-exact [email protected]
๐Ÿ“„ .MD
โšก Executive Summary (TL;DR)

Turborepo v2.5.0. Source highlight: docs: fix typo on continue docs

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.

โœจ New Features & Capabilities (6)

  • docs: add explicit mention for capturing multiple .env files
  • docs: upgrades for Vitest doc and add `with-vitest` example
  • docs: add hybrid approach to vitest guide
  • docs: add release phases to support policy
  • feat(boundaries): package name as tag punning
  • docs: add `FORCE_COLOR` variable to docs

โšก Performance & Enhancements (1)

  • docs: enhance examples tables

๐Ÿ”ง Bug Fixes & Patches (6)

  • docs: fix typo on continue docs
  • docs: fix json title for Watch Mode docs
  • fix(cli): no longer attempt to parse task name as continue value
  • fix: adds callout for installation instructions for PNPM
  • docs: fix code black background colors
  • fix(docs): prefix environment variable for search dialog
๐Ÿ“„ View Raw Release Notes (Original Developer Log)
<!-- Release notes generated using configuration in .github/turborepo-release.yml at v2.5.0 --> ## What's Changed ### Docs * docs: fix typo on continue docs by @jenseng in https://github.com/vercel/turborepo/pull/10041 * docs: add explicit mention for capturing multiple .env files by @anthonyshew in https://github.com/vercel/turborepo/pull/10061 * docs: fix json title for Watch Mode docs by @bohongu in https://github.com/vercel/turborepo/pull/10085 * docs: upgrades for Vitest doc and add `with-vitest` example by @anthonyshew in https://github.com/vercel/turborepo/pull/10063 * chore: remove experimental warning from ls command by @anthonyshew in https://github.com/vercel/turborepo/pull/10096 * docs: add hybrid approach to vitest guide by @beaussan in https://github.com/vercel/turborepo/pull/10092 * fix(cli): no longer attempt to parse task name as continue value by @chris-olszewski in https://github.com/vercel/turborepo/pull/10097 * docs: clarify TURBO_TEAM slug usage by @anthonyshew in https://github.com/vercel/turborepo/pull/10102 * fix: adds callout for installation instructions for PNPM by @Tigatok in https://github.com/vercel/turborepo/pull/10100 * docs: add release phases to support policy by @anthonyshew in https://github.com/vercel/turborepo/pull/10091 * docs: remove `ls` from Experimental phase in Support Policy by @anthonyshew in https://github.com/vercel/turborepo/pull/10108 * docs: open source site source code by @anthonyshew in https://github.com/vercel/turborepo/pull/10127 * docs: fix code black background colors by @anthonyshew in https://github.com/vercel/turborepo/pull/10141 * fix(docs): prefix environment variable for search dialog by @anthonyshew in https://github.com/vercel/turborepo/pull/10142 * fix(docs): fix commas in package exports example by @x-N0 in https://github.com/vercel/turborepo/pull/10143 * docs: fix typos in documentation files by @rootdiae in https://github.com/vercel/turborepo/pull/10124 * docs: update storybook initiation instructions by @sicarius97 in https://github.com/vercel/turborepo/pull/10145 * feat(boundaries): package name as tag punning by @NicholasLYang in https://github.com/vercel/turborepo/pull/10151 * fix(docs): asset importing failure for OG images by @anthonyshew in https://github.com/vercel/turborepo/pull/10159 * chore(docs): convert 'Turbo' into 'Turborepo' by @anthonyshew in https://github.com/vercel/turborepo/pull/10162 * docs: add `FORCE_COLOR` variable to docs by @anthonyshew in https://github.com/vercel/turborepo/pull/10165 * feat: workspace root microsyntax by @anthonyshew in https://github.com/vercel/turborepo/pull/10094 * docs(run): fix passthrough arg behavior by @chris-olszewski in https://github.com/vercel/turborepo/pull/10167 * docs: bump openapi framework version by @anthonyshew in https://github.com/vercel/turborepo/pull/10172 * docs: fix typos by @xiaobei0715 in https://github.com/vercel/turborepo/pull/10182 * docs: update fallback OG image by @anthonyshew in https://github.com/vercel/turborepo/pull/10174 * docs: enhance examples tables by @anthonyshew in https://github.com/vercel/turborepo/pull/10173 * docs: fix typos in documentation files by @rootdiae in https://github.com/vercel/turborepo/pull/10192 * docs: add checkout optimization for `--affected` by @anthonyshew in https://github.com/vercel/turborepo/pull/10188 * feat(turbo json): make `with` public by @chris-olszewski in https://github.com/vercel/turborepo/pull/10191 * chore: fix some typos by @pudongair in https://github.com/vercel/turborepo/pull/10196 * docs: use schema from current @turbo/types by @chris-olszewski in https://github.com/vercel/turborepo/pull/10197 * docs: switch turbo run to turbo watch for --experimental-write-cache by @victorlagerfors in https://github.com/vercel/turborepo/pull/10199 * docs: layout redesign by @anthonyshew in https://github.com/vercel/turborepo/pull/10178 * docs: fix text colors in a few spots by @anthonyshew in https://github.com/vercel/turborepo/pull/10213 * docs: remove stale callout by @anthonyshew in https://github.com/vercel/turborepo/pull/10217 * docs: links for OpenAPI spec for both human-readable and JSON by @anthonyshew in https://github.com/vercel/turborepo/pull/10216 * docs: add a snippet to `with` by @anthonyshew in https://github.com/vercel/turborepo/pull/10215 * docs: mention JSONC support by @anthonyshew in https://github.com/vercel/turborepo/pull/10214 * chore(docs): remove with until published by @tknickman in https://github.com/vercel/turborepo/pull/10237 * docs: add missing shadcn/ui tile by @anthonyshew in https://github.com/vercel/turborepo/pull/10249 * docs: add config mention to upgrading guide by @anthonyshew in https://github.com/vercel/turborepo/pull/10233 * docs: move CTA below TOC by @anthonyshew in https://github.com/vercel/turborepo/pull/10252 * chore: upgrade to `proxy-agent` 6.5.0 by @chris-olszewski in https://github.com/vercel/turborepo/pull/10278 ### eslint * fix: `eslint-config-turbo` module export by @anthonyshew in https://github.com/vercel/turborepo/pull/10105 * fix: mark type of flat config export to satisfy Linter.Config[] by @cprussin in https://github.com/vercel/turborepo/pull/10128 * fix(eslint): array type lints by @chris-olszewski in https://github.com/vercel/turborepo/pull/10139 * chore: fix types for ESLint package builds by @anthonyshew in https://github.com/vercel/turborepo/pull/10157 ### @turbo/repository * fix(release): manually install target toolchain by @dimitropoulos in https://github.com/vercel/turborepo/pull/10080 * chore: update to Rust 1.85.0 by @ognevny in https://github.com/vercel/turborepo/pull/10024 * fix: `affected_packages`'s optimization flow by @dimitropoulos in https://github.com/vercel/turborepo/pull/9950 * chore: update to Rust 2024 edition by @ognevny in https://github.com/vercel/turborepo/pull/10114 ### Examples * docs: update README.md in examples with-tailwind to correctly reference .ts config files instead of .js by @vinayaksodar in https://github.com/vercel/turborepo/pull/10057 * chore(deps-dev): bump the with-svelte group in /examples/with-svelte with 2 updates by @dependabot in https://github.com/vercel/turborepo/pull/10068 * chore(deps): bump the non-monorepo group in /examples/non-monorepo with 2 updates by @dependabot in https://github.com/vercel/turborepo/pull/10070 * chore(deps-dev): bump turbo from 2.4.2 to 2.4.4 in /examples/with-shell-commands by @dependabot in https://github.com/vercel/turborepo/pull/10071 * chore(deps): bump the basic group in /examples/basic with 5 updates by @dependabot in https://github.com/vercel/turborepo/pull/10069 * chore(deps): bump the kitchen-sink group in /examples/kitchen-sink with 12 updates by @dependabot in https://github.com/vercel/turborepo/pull/10072 * chore(deps): bump the with-tailwind group in /examples/with-tailwind with 5 updates by @dependabot in https://github.com/vercel/turborepo/pull/10073 * docs: fix JSDoc annotation for ESLint flat configs of basic example by @Tyoneb in https://github.com/vercel/turborepo/pull/10089 * chore(deps-dev): bump the basic group in /examples/basic with 3 updates by @dependabot in https://github.com/vercel/turborepo/pull/10131 * chore(deps-dev): bump the with-tailwind group in /examples/with-tailwind with 3 updates by @dependabot in https://github.com/vercel/turborepo/pull/10132 * chore(deps-dev): bump the with-svelte group in /examples/with-svelte with 6 updates by @dependabot in https://github.com/vercel/turborepo/pull/10133 * chore(deps): bump the non-monorepo group in /examples/non-monorepo with 2 updates by @dependabot in https://github.com/vercel/turborepo/pull/10134 * chore(deps-dev): bump the kitchen-sink group in /examples/kitchen-sink with 3 updates by @dependabot in https://github.com/vercel/turborepo/pull/10135 * feat(examples): add example `with-solid` by @ssshashank in https://github.com/vercel/turborepo/pull/10144 * chore: fix example readme typo by @wmjae in https://github.com/vercel/turborepo/pull/10164 * chore(deps-dev): bump the with-svelte group across 1 directory with 2 updates by @dependabot in https://github.com/vercel/turborepo/pull/10189 * chore(deps): bump the non-monorepo group in /examples/non-monorepo with 2 updates by @dependabot in https://github.com/vercel/turborepo/pull/10183 * chore(deps-dev): bump @next/eslint-plugin-next from 15.2.1 to 15.2.2 in /examples/with-tailwind by @dependabot in https://github.com/vercel/turborepo/pull/10184 * fix(example): remove obsolete @types/react-native from with-react-native-web by @shinjith-dev in https://github.com/vercel/turborepo/pull/10190 * chore(deps-dev): bump @types/node from 22.13.9 to 22.13.10 in /examples/basic by @dependabot in https://github.com/vercel/turborepo/pull/10186 * chore(deps): bump the non-monorepo group in /examples/non-monorepo with 2 updates by @dependabot in https://github.com/vercel/turborepo/pull/10220 * chore(deps-dev): bump the basic group in /examples/basic with 3 updates by @dependabot in https://github.com/vercel/turborepo/pull/10222 * chore(deps-dev): bump the with-svelte group in /examples/with-svelte with 4 updates by @dependabot in https://github.com/vercel/turborepo/pull/10224 * chore(deps-dev): bump the with-tailwind group in /examples/with-tailwind with 3 updates by @dependabot in https://github.com/vercel/turborepo/pull/10223 * fix: unexpected top-level property `default` in `base.js` eslint config by @mm-webx in https://github.com/vercel/turborepo/pull/10240 * docs: fix the incorrect export keyword by @todaymoon in https://github.com/vercel/turborepo/pull/10235 * chore(deps-dev): bump the with-svelte group in /examples/with-svelte with 2 updates by @dependabot in https://github.com/vercel/turborepo/pull/10256 * chore(deps): bump the basic group in /examples/basic with 4 updates by @dependabot in https://github.com/vercel/turborepo/pull/10257 * chore(deps): bump the non-monorepo group in /examples/non-monorepo with 6 updates by @dependabot in https://github.com/vercel/turborepo/pull/10259 * chore(deps): bump the with-tailwind group in /examples/with-tailwind with 4 updates by @dependabot in https://github.com/vercel/turborepo/pull/10258 * chore(deps): bump the kitchen-sink group across 1 directory with 8 updates by @dependabot in https://github.com/vercel/turborepo/pull/10221 * chore(deps-dev): bump typescript-eslint from 8.28.0 to 8.29.0 in /examples/with-svelte in the with-svelte group by @dependabot in https://github.com/vercel/turborepo/pull/10263 * chore(deps-dev): bump typescript-eslint from 8.28.0 to 8.29.0 in /examples/with-tailwind in the with-tailwind group by @dependabot in https://github.com/vercel/turborepo/pull/10264 * chore(deps-dev): bump typescript-eslint from 8.28.0 to 8.29.0 in /examples/basic in the basic group by @dependabot in https://github.com/vercel/turborepo/pull/10265 ### Changelog * feat(process): differentiate between child interruption and killing by @chris-olszewski in https://github.com/vercel/turborepo/pull/10027 * fix(@turbo/repository): revert "chore(deps): update git2 to 0.20.0" by @chris-olszewski in https://github.com/vercel/turborepo/pull/10045 * fix(process): revert "feat(process): differentiate between child interruption and killing" by @chris-olszewski in https://github.com/vercel/turborepo/pull/10046 * feat(boundaries): support tsconfig path aliases by @NicholasLYang in https://github.com/vercel/turborepo/pull/10002 * chore: fix corepack wiring in integration tests by @jenseng in https://github.com/vercel/turborepo/pull/10044 * chore(spaces): remove spaces id by @chris-olszewski in https://github.com/vercel/turborepo/pull/10050 * refactor: move tests to Rust by @NicholasLYang in https://github.com/vercel/turborepo/pull/10043 * feat(query): add schema flag by @NicholasLYang in https://github.com/vercel/turborepo/pull/10052 * fix: revert "chore: fix corepack wiring in integration tests" by @chris-olszewski in https://github.com/vercel/turborepo/pull/10054 * chore(signals): prefactor by @chris-olszewski in https://github.com/vercel/turborepo/pull/9995 * fix: filter logic by @dinglindong in https://github.com/vercel/turborepo/pull/9653 * chore(deps): update git2 to 0.20.0 by @chris-olszewski in https://github.com/vercel/turborepo/pull/10058 * chore: unify futures versions by @chris-olszewski in https://github.com/vercel/turborepo/pull/10059 * chore(signals): lift error conversion to each command that sets up signal handler by @chris-olszewski in https://github.com/vercel/turborepo/pull/10060 * chore(scm): gate git2 behind feature flag by @chris-olszewski in https://github.com/vercel/turborepo/pull/10076 * chore(turbo_json): remove exterior mutability from loader by @chris-olszewski in https://github.com/vercel/turborepo/pull/10066 * chore: delete redundant glob watcher code by @NicholasLYang in https://github.com/vercel/turborepo/pull/10075 * feat(ls): add package path to ls by @NicholasLYang in https://github.com/vercel/turborepo/pull/10079 * fix(packages): no longer match versionless packages by @chris-olszewski in https://github.com/vercel/turborepo/pull/10056 * fix(engine): no longer error if provided task is omitted by filter by @chris-olszewski in https://github.com/vercel/turborepo/pull/10051 * feat: add JSONC support by @anthonyshew in https://github.com/vercel/turborepo/pull/10083 * chore: update README by @NicholasLYang in https://github.com/vercel/turborepo/pull/10098 * feat(clone): turbo clone by @NicholasLYang in https://github.com/vercel/turborepo/pull/9904 * fix: correctly forward passthrough arguments when using pkg#task format by @NicholasLYang in https://github.com/vercel/turborepo/pull/10087 * fix(boundaries): support import attributes by @NicholasLYang in https://github.com/vercel/turborepo/pull/10078 * chore(scm): gate manual file hash behind git2 by @chris-olszewski in https://github.com/vercel/turborepo/pull/10088 * fix(boundaries): unnecessary tsconfig warnings by @NicholasLYang in https://github.com/vercel/turborepo/pull/10104 * fix(affected): consider turbo.jsonc as a default global dependency by @chris-olszewski in https://github.com/vercel/turborepo/pull/10106 * fix(prune): support copying turbo.jsonc by @chris-olszewski in https://github.com/vercel/turborepo/pull/10107 * chore(ci): remove kodiak by @tknickman in https://github.com/vercel/turborepo/pull/10116 * fix: typo in issue template by @dimitropoulos in https://github.com/vercel/turborepo/pull/10119 * feat(boundaries): implicit dependencies by @NicholasLYang in https://github.com/vercel/turborepo/pull/10117 * chore: update schema with boundaries by @NicholasLYang in https://github.com/vercel/turborepo/pull/10118 * chore: fix some typos by @kevincatty in https://github.com/vercel/turborepo/pull/10149 * feat(process): distinguish between signals used to kill children by @chris-olszewski in https://github.com/vercel/turborepo/pull/10049 * feat(boundaries): auto ignore by @NicholasLYang in https://github.com/vercel/turborepo/pull/10147 * fix(bun): properly handle bun lockfile keys by @chris-olszewski in https://github.com/vercel/turborepo/pull/10137 * chore: dogfood $TURBO_ROOT$ by @chris-olszewski in https://github.com/vercel/turborepo/pull/10168 * chore: add missing backquotes by @jimmycathy in https://github.com/vercel/turborepo/pull/10180 * feat(bun): bun prune support by @camero2734 in https://github.com/vercel/turborepo/pull/10175 * chore: fix clippy lints in tests by @chris-olszewski in https://github.com/vercel/turborepo/pull/10193 * feat(boundaries): package rules by @NicholasLYang in https://github.com/vercel/turborepo/pull/10160 * fix: update env variables supported by nitro by @pi0 in https://github.com/vercel/turborepo/pull/10176 * chore(frameworks): move framework logic to new crate by @chris-olszewski in https://github.com/vercel/turborepo/pull/10198 * chore: format frameworks.json by @chris-olszewski in https://github.com/vercel/turborepo/pull/10209 * fix(turbo_json): avoid workspace validation errors by @chris-olszewski in https://github.com/vercel/turborepo/pull/10211 * fix(bun): deserialize correctly and use optionalPeers by @camero2734 in https://github.com/vercel/turborepo/pull/10219 * feat(tui): bump default scrollback length by @anthonyshew in https://github.com/vercel/turborepo/pull/10261 * chore: upgrade turborepo-process and turborepo-filewatch to Rust 2024 edition by @ognevny in https://github.com/vercel/turborepo/pull/10260 * chore(auth): include path to bad token in error message by @chris-olszewski in https://github.com/vercel/turborepo/pull/10208 ## New Contributors * @dinglindong made their first contribution in https://github.com/vercel/turborepo/pull/9653 * @vinayaksodar made their first contribution in https://github.com/vercel/turborepo/pull/10057 * @bohongu made their first contribution in https://github.com/vercel/turborepo/pull/10085 * @Tyoneb made their first contribution in https://github.com/vercel/turborepo/pull/10089 * @beaussan made their first contribution in https://github.com/vercel/turborepo/pull/10092 * @Tigatok made their first contribution in https://github.com/vercel/turborepo/pull/10100 * @cprussin made their first contribution in https://github.com/vercel/turborepo/pull/10128 * @x-N0 made their first contribution in https://github.com/vercel/turborepo/pull/10143 * @rootdiae made their first contribution in https://github.com/vercel/turborepo/pull/10124 * @ssshashank made their first contribution in https://github.com/vercel/turborepo/pull/10144 * @sicarius97 made their first contribution in https://github.com/vercel/turborepo/pull/10145 * @kevincatty made their first contribution in https://github.com/vercel/turborepo/pull/10149 * @jimmycathy made their first contribution in https://github.com/vercel/turborepo/pull/10180 * @xiaobei0715 made their first contribution in https://github.com/vercel/turborepo/pull/10182 * @camero2734 made their first contribution in https://github.com/vercel/turborepo/pull/10175 * @pudongair made their first contribution in https://github.com/vercel/turborepo/pull/10196 * @pi0 made their first contribution in https://github.com/vercel/turborepo/pull/10176 * @victorlagerfors made their first contribution in https://github.com/vercel/turborepo/pull/10199 * @mm-webx made their first contribution in https://github.com/vercel/turborepo/pull/10240 * @todaymoon made their first contribution in https://github.com/vercel/turborepo/pull/10235 **Full Changelog**: https://github.com/vercel/turborepo/compare/v2.4.4...v2.5.0