Upgrade package manager from pnpm 10 to pnpm 11
@infeo is already working on this.
Since May 8, 2026.
Assessment
This issue has not been assessed yet.
Description
Overview
This issue tracks the upgrade of the package manager from pnpm 10 to pnpm 11.
pnpm 11 Release Notes
- Blog post / release notes: https://pnpm.io/blog/releases/11.0
- Migration guide (v10 → v11): https://pnpm.io/blog/releases/11.0#migrating-from-v10-to-v11
- GitHub releases: https://github.com/pnpm/pnpm/releases
Key Changes in pnpm 11
- Node.js 22+ required — support for Node.js 18, 19, 20, and 21 is dropped. pnpm is now pure ESM.
- Supply-chain protection on by default —
minimumReleaseAgedefaults to 1 day (1440 min) andblockExoticSubdepsdefaults totrue. allowBuildsreplaces legacy build-dependency settings —onlyBuiltDependencies,neverBuiltDependencies,ignoredBuiltDependencies, andignoreDepScriptsare removed.- Configuration split —
.npmrcis now auth/registry only; all other pnpm settings must live inpnpm-workspace.yamlor the new global~/.config/pnpm/config.yaml. - New SQLite-backed store index (store v11) — replaces JSON-per-package index for faster installs.
- Native publish flow —
pnpm publish,login,logout, etc. no longer delegate to npm CLI. - Isolated global installs via the global virtual store.
- New commands —
pnpm ci,pnpm sbom,pnpm clean,pnpm peers check,pnpm runtime set, and shortpn/pnxaliases. - Environment variables use
pnpm_config_*prefix instead ofnpm_config_*.
Required Changes in This Repository
- Update
packageManagerfield inpackage.jsonto[email protected]. - Migrate
pnpm-workspace.yaml— replaceallowBuilds: falseentries with the newallowBuildsmodel; note thatstrictDepBuildsand related legacy fields are removed. - Ensure CI environment uses Node.js 22+.
- Review any
.npmrcsettings and move non-auth config topnpm-workspace.yaml. - Update the lockfile (
pnpm-lock.yaml) by runningpnpm installafter the upgrade. - Update
scripts/check-pm.jsif needed (thenpm_config_user_agentenv var logic may need updating since pnpm 11 usespnpm_config_*prefix for its own settings).
Context
This issue was raised in the context of PR #145, which introduced pnpm 10 as the package manager.
Requested by: @infeo
- Dominant language
- TypeScript
- Stars
- 66
- Forks
- 45
- Avg merge
- 5h 16m
- Merged PRs (30d)
- 5
Getting set up
- No Dockerfile or Docker Compose file
- No pull request template
- Read the contributing guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
More from cryptomator/docs
-
Difficulty 4/5 3-5 days Newbie friendliness 35/100
cryptomator/docs#89 ·
-
Difficulty 3/5 1-2 days Newbie friendliness 35/100
cryptomator/docs#11 · 1 comment ·
All issues in cryptomator/docs
Similar issues
-
bug
Difficulty 2/5 1-3 hours Newbie friendliness 67/100
outline/outline#14529 · 1 comment ·
Maintainers usually reply within 1 day
-
Difficulty 1/5 1-3 hours Newbie friendliness 86/100
g1331/phantom-circuit#93 ·
Maintainers usually reply within 1 day
-
bug
Difficulty 2/5 1-3 hours Newbie friendliness 68/100
-
Difficulty 2/5 1-3 hours Newbie friendliness 78/100
Maintainers usually reply within 1 day
-
compiler
Difficulty 2/5 1-3 hours Newbie friendliness 74/100
HerringtonDarkholme/hd-lang#1699 ·
Maintainers usually reply within 1 day