pnpm
Dev ToolsFast, disk space efficient package manager
Release History
v10.30.31 fixThis patch release fixes an issue where version switching failed when pnpm was installed as a standalone executable without a system Node.js environment.
v11.0.0-alpha.11Breaking3 fixes17 featuresThis release introduces major performance improvements across the store by switching to MessagePack and optimizing index formats, alongside significant changes to configuration loading, moving away from INI/rc files towards YAML for pnpm-specific settings. Many deprecated configuration options and commands have been removed, and the package is now pure ESM.
v10.30.22 fixesThis patch release fixes an issue where auto-installed peer dependencies ignored overrides and resolves an input line length error on Windows when using the global virtual store. It also includes a dependency update to patch a moderate vulnerability.
v11.0.0-alpha.10Breaking2 fixes16 featuresThis release introduces major performance improvements by switching internal store formats to MessagePack and optimizing index storage. Configuration handling has been significantly overhauled, moving away from rc files and standardizing on YAML for pnpm-specific settings, alongside dropping support for older Node.js versions.
v10.30.11 fixThis patch release updates the primary endpoint used for fetching security audits to improve reliability.
v10.30.01 fix1 featureThis release updates pnpm why to display a reverse dependency tree for better readability and reverts a dependency pruning change in pnpm why to ensure correctness. Performance for pnpm why and pnpm list in large workspaces has also been improved.
v11.0.0-alpha.5Breaking2 fixes12 featuresThis major release introduces significant performance improvements by switching internal store formats to MessagePack and optimizing index storage. It also brings substantial changes to configuration handling, replacing INI formats with JSON for config commands and standardizing workspace configuration via `pnpm-workspace.yaml`.
v11.0.0-alpha.4Breaking3 fixes21 featuresThis major release introduces significant performance improvements by switching internal store formats to MessagePack and optimizing index storage. Configuration handling has been overhauled, moving project-specific settings out of .npmrc files into pnpm-workspace.yaml and changing CLI output formats.
v10.29.34 fixesThis patch release resolves several bugs, including an out-of-memory error in dependency listing commands and issues with configuration settings in `.pnpmfile.cjs` and `pnpm dlx`. Additionally, `pnpm deploy` behavior is corrected regarding the global virtual store setting.
v10.29.21 fixThis patch release reverts a previous fix (from v10.29.1) that was causing issues, restoring functionality for 'pnpm run -r' when an empty workspace file is present.
v10.29.110 fixes3 featuresThis release introduces support for the `catalog:` protocol in `pnpx` and allows configuring `auditLevel` in `pnpm-workspace.yaml`. Numerous bug fixes address issues related to JSON output, store path resolution, audit command behavior, and dependency handling.
v10.29.010 fixes3 featuresThis release introduces support for the `catalog:` protocol in `pnpx` and allows configuring `auditLevel` in `pnpm-workspace.yaml`. Numerous bugs were fixed, including issues related to JSON output, store path resolution, audit command behavior, and dependency hoisting configuration.
v10.28.23 fixesThis patch release focuses on security improvements by preventing path traversal in `directories.bin` and securing symlink handling for local dependencies. It also fixes an issue related to optional dependency metadata fetching for platform checks.
v10.28.17 fixes2 featuresThis patch release focuses heavily on security by fixing multiple path traversal vulnerabilities in ZIP and binary fetching, and improves dependency resolution by supporting plain HTTP/HTTPS git URLs. It also adjusts the exit code behavior for filtered script execution.
v11.0.0-alpha.3Breaking1 fix8 featuresThis release introduces significant configuration restructuring, replacing project-specific .npmrc files with packageConfigs in pnpm-workspace.yaml and restricting configuration loading from rc files. It also updates default behaviors, removes deprecated build dependency settings, and shifts the runtime environment to a bundled Node.js version.
v10.28.0v10.27.0Breaking5 fixes4 featuresThis release adds trust‑policy ignore options, project registry and mark‑and‑sweep pruning for the global virtual store, and includes several bug fixes, with a semi‑breaking change to unscoped package storage layout.
v10.26.22 fixes4 featuresThis patch release improves error messages, fixes Git annotated‑tag handling, writes runtime binaries earlier in the install lifecycle, and reduces network calls when `preferOffline` is used.
v10.26.12 fixesPatch release fixing pnpm add behavior with blockExoticSubdeps and improving git reference resolution to full commits.
v11.0.0-alpha.2Breaking11 featurespnpm 9.x introduces pure ESM packaging, a bundled Node runtime, JSON‑based config output, camelCase keys, and V8‑binary store, while dropping Node 18/19 support and changing several CLI behaviours.
v10.26.0Breaking3 fixes7 featuresThis release adds supply‑chain security features like `blockExoticSubdeps` and integrity hashing, introduces the unified `allowBuilds` config, and brings several usability improvements such as `--dry‑run` for `pack` and better deprecation displays.
v10.25.04 fixes2 featuresThis release adds certificate loading via `cert`, `ca`, and `key` fields and a `--bare` flag for `pnpm init`, plus several bug fixes around script reporting, build handling, forced publishing, and trust‑policy time errors.
v10.24.05 fixes1 featureThis release adds automatic network concurrency scaling for high‑core systems and includes several bug fixes around trust policies, file linking, self‑update behavior, package detection, and auth token handling.
v10.23.0Breaking4 fixes2 featuresThis release adds a new `--lockfile-only` flag to `pnpm list`, improves self‑update handling, displays npm protocols for aliased packages, and includes several bug fixes and stricter trust‑policy enforcement.
v11.0.0-alpha.0Breaking1 fix11 featurespnpm 9 introduces pure ESM, JSON‑based config output, V8‑serialized store files, and drops Node.js v18/v19 support, requiring migration of config files, imports, and runtime versions.
v10.22.01 fix2 featuresThis release introduces `trustPolicyExclude` and `publishConfig.engines` support, and fixes a hardlinking crash.
v10.21.03 fixes3 featuresThis release adds automatic Node.js runtime installation for dependencies, introduces a new \"trustPolicy\" setting, and adds a command to retrieve the global config path, while fixing several bugs around update behavior, hardlinking, and workspace configuration.
v10.20.03 fixes1 featureThis release adds the `--all` option to `pnpm --help` and includes several bug fixes related to version selection, the `create` command, and package manager version handling.
v10.19.02 featuresThis release introduces version‑specific controls for postinstall scripts and release‑age exclusions, enhancing security and flexibility in dependency management.
v10.18.39 fixesThis patch release fixes several bugs related to configuration handling, publishing, bin linking, and workspace behavior, improving the stability of pnpm commands.
v10.18.25 fixesThis patch release fixes several command issues, reduces the CLI bundle size by swapping ndjson for split2, and improves metadata handling for pnpm dlx.
v10.18.12 fixes1 featureThis patch release silences an unnecessary warning for `--lockfile-only`, adds a Windows shim for `pnpm setup` to support self‑updates, and corrects catalog warning behavior.
v10.18.05 fixes2 featuresThis release adds network performance monitoring with configurable thresholds and includes several bug fixes such as retrying EAGAIN filesystem errors and respecting `minimumReleaseAge` in various commands.
v10.17.13 fixesThis patch release fixes error messaging, workspace state file creation, and improves handling of `minimumReleaseAge` for selecting the latest version.
v10.17.02 fixes1 featureThis release adds pattern support to the `minimumReleaseAgeExclude` configuration and fixes two bugs related to minimumReleaseAge handling and prerelease downgrades.
v10.16.12 fixesThis patch release resolves a metadata cache bug and ensures patch diffs are generated without ANSI color codes.
v10.16.04 fixes3 featuresThis release adds a `minimumReleaseAge` safety setting and custom finder support, while fixing several bugs such as Node.js 24 deprecation warnings and improving error handling for `nodeVersion`.
v10.15.12 fixesThis patch release fixes a crash in `.pnp.cjs` and improves peer dependency resolution in workspaces.
v10.15.0Breaking4 fixes7 featuresThis release adds several new configuration capabilities, improves config handling, restores glibc 2.26 support, and includes a semi‑breaking change to peer‑dependency resolution.
v10.14.06 fixes2 featuresThis release adds JavaScript runtime installation support and new CLI flags for architecture selection, plus several bug fixes and integrity improvements.
v10.14.0-03 fixes3 featuresThis release adds new CLI flags for architecture selection, introduces devEngines‑based Node.js runtime resolution, improves dlx flag parsing, and fixes several bugs around package downloading and production installs.
v10.13.11 featureThis patch updates pnpm to run user‑defined pnpmfiles after plugin pnpmfiles.
v10.13.05 fixes2 featuresThis release adds support for multiple pnpmfiles and automatic loading of pnpmfile.cjs from config dependencies, while fixing several configuration conflicts, sorting behavior, rebuild handling, and command quoting.
v10.12.44 fixesThis patch release resolves several bugs: the `pnpm licenses` command for local dependencies, incorrect JSON output for non‑existent filters, a peer‑dependency deadlock, and restores proper hoisting after `pnpm fetch`.
v10.12.31 fixThis patch restores the hoisting of optional peer dependencies when using an outdated lockfile, fixing a regression introduced in v10.12.2.
v10.12.24 fixesThis patch release fixes several CLI bugs, including hoisting with `enableGlobalVirtualStore`, help flag handling for `pnpm create`, incorrect license list paths, and a deployment failure caused by outdated lockfiles.
v10.12.1Breaking2 fixes6 featuresThis release introduces experimental global virtual stores, catalog enhancements, new CLI options, and a new CI flag, while changing side‑effects cache keys (requiring cache cleanup) and fixing several regressions.
v10.11.18 fixesThis patch release resolves multiple regressions and bugs affecting pnpm deploy, URL‑based dependencies, strict peer dependency handling, environment variable naming, lockfile generation, overrides handling, URL parsing, and silent run output.
v10.11.04 fixes8 featuresThis release adds several new features such as module‑type init, Nushell support, audit ignore flags, recursive packing, and improves workspace behavior, while also fixing bugs related to peer dependencies, configuration loading, Node.js 24 warnings, and script execution.
v10.10.04 fixes1 featureThis release adds support for loading preResolution, importPackage, and fetchers hooks from a local pnpmfile and includes several bug fixes such as the cd command with shellEmulator, workspace yaml key sorting, and npm_package_json propagation.
v10.9.0Breaking1 fix2 featuresThis release adds JSR package installation support and a new `dangerouslyAllowAllBuilds` setting, fixes a verifyDepsBeforeRun false negative, and drops verifyDepsBeforeRun support for nodeLinker "pnp".
v10.8.12 fixes1 featureThis patch release removes bright white highlighting, adds automatic writing of `onlyBuiltDependencies` to `pnpm-workspace.yaml` when no config exists, and ensures patch file paths are stored as relative paths.
v10.8.03 fixes2 featuresThis release adds an experimental configuration hook and a new --config flag for pnpm add, and includes several bug fixes around workspace globs, audit overrides, and link behavior.
v10.7.13 fixesPatch release that corrects config type conversion, auth config retrieval, and expands `~/` in .npmrc paths.
v10.7.01 fix6 featuresThis minor release adds workspace‑aware config commands, env‑var support in workspace files, version‑range based dependency patching, a new ignore‑patch‑failures option, and fixes audit output memory issues.
v10.6.54 fixesThis patch release fixes several issues: it removes post‑approval warnings, preserves the `ignoredBuilds` field, corrects `catalog:` protocol handling in injected workspace packages, and allows non‑positive `workspace-concurrency` values.
v10.6.43 fixesThis patch release fixes pnpm dlx with the --allow-build flag, prevents invalid Node.js versions from breaking pnpm, and reduces the max linking workers to four for better performance.
v10.6.32 fixes1 featurePatch release fixing a crash in `pnpm install --prod=false`, adding missing `node-options` to `recursive run`, and cleaning up the `dedupe-peer-dependents` code path.
v9.15.91 fixThis patch release fixes a Windows-specific issue where running the pnpm CLI from within itself failed when the CLI was bundled as an executable.
v10.6.22 fixes4 featuresThis patch release fixes Windows CLI execution issues, improves self‑update behavior, aligns patch‑commit filesystem handling, adds proper handling of log level errors, and enables peerDependencyRules configuration via pnpm‑workspace.yaml.
v9.15.83 fixesThis patch release fixes self-update version handling, prevents CLI hangs with --silent, and silences extra output when --loglevel=error.
v10.6.15 fixesThis patch release fixes several CLI hanging and output issues, restores handling of patchedDependencies, improves approve-builds behavior, and adds registry info for missing package versions.
v10.6.06 fixes3 featuresThis release adds support for .npmrc settings in pnpm-workspace.yaml, improves tarball dependency performance, replaces fast-glob with tinyglobby, and includes several bug fixes for self-update, deploy, and update commands.
v9.15.74 fixes1 featureThis patch release introduces a new scoped registry CLI option and resolves several bugs affecting self‑update, interactive update listings, and catalog entry preservation.
v10.5.21 fixThe patch restores the default behavior of `pnpm config set` to modify the global .npmrc file.
v10.5.15 fixesThis patch release fixes several issues: it adds an error for incorrect workspace config filenames, corrects workspace updates via approve-builds, normalizes link paths in package.json, enables overrides in pnpm-workspace.yaml, and makes pnpm dlx ignore local package.json settings.
v10.5.02 fixes6 featuresThis release adds support for defining `pnpm.*` settings in `pnpm-workspace.yaml`, introduces automatic syncing of injected workspace packages after scripts, makes the `packages` field optional, and includes several command enhancements and bug fixes.
v9.15.65 fixesThis patch release fixes several bugs related to corepack updates, version output, packageManager version format, and catalog handling during filtered installs.
v10.4.14 fixesThis patch release fixes several CLI behaviors: it adds validation for overlapping `--allow-build` values, prints version info after execution time, warns on ignored builds during repeat installs, and restores proper handling of `init-package-manager`.
v10.4.0Breaking3 fixes2 featurespnpm v10 introduces `--global` support for approve-builds, a new `--allow-build` flag for add, and several bug fixes and documentation updates.
v10.3.02 fixes1 featurev10 introduces the `strict-dep-builds` setting for stricter script validation and includes fixes for `verify-deps-before-run` false negatives and improved warning display.
v10.2.14 fixesThis patch release fixes side‑effects cache handling, improves `pnpm approve-builds` in sub‑workspaces, and restores `pnpm deploy --legacy` functionality with clearer error guidance.
v10.2.05 fixes1 featurepnpm v10 introduces default building of packages run via `dlx` and `create`, adds several bug fixes, and improves handling of overrides and proxy settings.
v9.15.52 fixes3 featuresThis patch release adds support for preprepare/postprepare scripts during pnpm install, improves script argument quoting on POSIX, respects proxy settings for Git dependencies, validates package names on publish, and replaces strip-ansi with the built-in util.stripVTControlCharacters.
v10.1.08 fixes4 featuresThis release introduces new commands (`pnpm ignored-builds`, `pnpm approve-builds`), a performance‑focused setting, and a field to ignore built dependencies, while also fixing several bugs around publishing, scripts execution, peerDependencies handling, and internal utilities.
v9.15.41 fixThis patch release fixes recursive `pnpm update --latest` to correctly update only the targeted package when `dedupe-peer-dependents` is enabled.
Common Errors
TimeoutError1 reportTimeoutError in pnpm often arises from network congestion or slow server responses when downloading packages. Increase the `network-concurrency` setting in your `.npmrc` or `.pnpmfile.cjs` to allow more simultaneous downloads. Alternatively, switch to a faster mirror using the `registry` setting to improve package retrieval speed.
OnFatalError1 reportThe "OnFatalError" error in pnpm, often manifesting as "JavaScript heap out of memory," usually arises from insufficient memory allocated to Node.js during dependency installation, especially with large projects. Increase the Node.js heap size by setting the `NODE_OPTIONS` environment variable before running pnpm install, for example, `NODE_OPTIONS="--max-old-space-size=4096" pnpm install`. You can also try using a smaller, more targeted install by specifying particular dependencies.
Related Dev Tools Packages
Empowering everyone to build reliable and efficient software.
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
Playwright is a framework for Web Testing and Automation. It allows testing Chromium, Firefox and WebKit with a single API.
Next generation frontend tooling. It's fast!
An extremely fast Python package and project manager, written in Rust.
A bundler for javascript and friends. Packs many modules into a few bundled assets. Code Splitting allows for loading parts of the application on demand. Through "loaders", modules can be CommonJs, AMD, ES6 modules, CSS, Images, JSON, Coffeescript, LESS, ... and your custom stuff.
Subscribe to Updates
Get notified when new versions are released