Changesets v3 Released with ESM-Only, Smaller Install, and Peer Dependency Patch Bumps

Major Release After Seven Years

Changesets, a file-based versioning and changelog tool for JavaScript monorepos, has released v3.0. This marks the first major release in seven years since v2, led by a refreshed maintainer team including Mateusz Burzyński, Bjorn Lu, and Adam Haglund. The release, which landed on August 11, 2026, follows a public v3 release plan and arrives with a new documentation site and an updated changesets/action v2.

Leaner Installs and Modernized Stack

Changesets v3 is now ESM-only, requiring Node.js 22.11 or newer, along with pnpm 10, npm 10.9, or Yarn 4.5.2. Yarn Classic support has been dropped. This modernization effort significantly reduced the install size from 16.1MB to 2.1MB and cut the number of dependencies from 95 to 39. Internally, the project transitioned to tsdown, rolldown, vitest, and oxfmt. Changelog formatting no longer includes its own Prettier copy, instead using @changesets/format to detect existing formatters in the project.

Peer Dependency Bumping Change

A key behavioral change in v3 is that updating a peer dependency now results in a patch bump for dependents, rather than a major version bump. This change addresses years of user complaints, including issue 1011, where the previous behavior was seen as misrepresenting semantic versioning. Authors can still explicitly add a major changeset for dependents if a breaking change is intended.

Rebuilt CLI and New Commands

The command-line interface (CLI) for Changesets has been rebuilt using cac for argument parsing and clack for interactive prompts, which also resolves issues with cancelled prompts crashing the process. New `pack` and `publish-plan` commands have been introduced to support the build, pack, and publish sequence recommended by the e18e community. The v2 action now exposes sub-actions, allowing teams using npm trusted publishing to narrow publish permissions.

Migration and Configuration Updates

Upgrading to Changesets v3 primarily involves configuration work, detailed in the migration guide. Beyond the new install requirements, several commands and flags have been renamed. For example, `changeset tag` is now `changeset git-tag`, and `changeset status --sinceMaster` is now `changeset status --since=main`. Configuration changes include `prettier` being replaced by `format` and updates to `private pac`.