●Change8

Migrating to pnpm v11.0.0-rc.2

Version v11.0.0-rc.2 introduces 2 breaking changes. This guide details how to update your code.

Released: 4/17/2026

2
Breaking Changes
2
Migration Steps
14
Affected Symbols

⚠️ Check Your Code

If you use any of these symbols, you need to read this guide:

`managePackageManagerVersions` (setting removed)`packageManagerStrict` (setting removed)`packageManagerStrictVersion` (setting removed)`COREPACK_ENABLE_STRICT` (env var removed)`pmOnFail` (new setting)`pnpm with` (new command)`runtimeOnFail` (new setting)`star` (command added)`unstar` (command added)`stars` (command added)`whoami` (command added)`packageManager` (field behavior changed)`devEngines.packageManager` (field behavior changed)`devEngines.runtime` (field behavior affected by `runtimeOnFail`)

Breaking Changes

●Issue #1

The settings `managePackageManagerVersions`, `packageManagerStrict`, and `packageManagerStrictVersion` have been removed because their functionality is now entirely covered by the new `pmOnFail` setting.

●Issue #2

The `COREPACK_ENABLE_STRICT` environment variable is no longer honored; use the `pmOnFail` setting instead to control strictness behavior.

Migration Steps

  1. 1
    Replace usage of removed settings (`managePackageManagerVersions`, `packageManagerStrict`, `packageManagerStrictVersion`) with the new `pmOnFail` setting according to the following mapping: `managePackageManagerVersions: true` -> `pmOnFail: download` (default); `managePackageManagerVersions: false` -> `pmOnFail: ignore`; `packageManagerStrict: false` -> `pmOnFail: warn`; `packageManagerStrictVersion: true` -> `pmOnFail: error`; `COREPACK_ENABLE_STRICT=0` -> `pmOnFail: warn`.
  2. 2
    When using `pnpm init` with `init-package-manager` enabled, note that it now writes to `devEngines.packageManager` instead of `packageManager` in the root `package.json`.

Release Summary

This release removes several legacy configuration settings in favor of the unified `pmOnFail` setting and introduces the powerful `pnpm with` command for running specific pnpm versions. New native commands for managing package manager stars were also implemented.

Need More Details?

View the full release notes and all changes for pnpm v11.0.0-rc.2.

View Full Changelog