creating-changesets

Semantic versioning automates version bumps based on change type. Use Changesets with pnpm in Node.js monorepos to create .changeset entries describing affected packages and bump type (patch/minor/major), then generate release notes automatically during the release workflow.

Patch fixes bugs without API changes, minor adds backward-compatible features, and major introduces breaking changes. Changesets detect which applies to your changes and applies the correct semantic version bump accordingly.

Run pnpm changeset to open an interactive prompt. Select affected packages, choose the bump type, write a brief description, then commit the generated .changeset markdown file. This documents the change for release automation.

Yes. Changesets integrates directly with pnpm monorepos and workspaces. It detects packages, handles dependencies between them, and coordinates version bumps and changelog entries across your workspace during releases.

During release, Changesets collects all .changeset entries, applies version bumps to affected packages, generates a consolidated changelog, and creates a version PR. On merge, it publishes updated packages with new versions and release notes.

When running pnpm changeset, select major as the bump type and describe the breaking change in the changeset file. This ensures it appears prominently in release notes and signals consumers that migration is required.