# Turborepo v2.8.21 — Release & Upgrade Intelligence
- **Product:** Turborepo (https://turbo.build)
- **Version:** v2.8.21
- **Released:** Mar 28, 2026
- **Impact Score:** 5/10
- **Breaking Changes:** Not verified
- **Canonical Analysis:** https://changelogs.us/turborepo/updates/v2.8.21/

## Executive Summary (TL;DR)
Turborepo v2.8.21. Source highlight: fix: Strip JSX components from heading anchors and TOC entries

## New Features
- feat: Add `packagesFromLockfile()` NAPI binding to `@turbo/repository`
- docs: Add link to Docker guide in prune --docker flag section
- feat: Add `global` configuration key behind `futureFlags.globalConfiguration`
- feat: Add experimental structured logging with `--json` and `--log-file` flags
- feat: Rework `turbo ls` to use `query` internals and add `turbo query ls` shorthand
- docs: Add Git history requirements to `turbo query affected` docs

## Bug Fixes
- fix: Strip JSX components from heading anchors and TOC entries
- fix(eslint-plugin-turbo): Guard against missing tasks/pipeline in forEachTaskDef
- fix(examples): Update of `with-svelte` example
- fix: Use script-shell=bash for cross-platform with-shell-commands example
- fix: Move docs app icons into app/ directory
- Revert "fix: Flush stale mouse tracking events from stdin during TUI cleanup"

## Upgrade Command
```bash
npm install --save-dev --save-exact turbo@2.8.21
```