Description
The local setup instructions in CONTRIBUTING.md say pnpm can be installed via Corepack, which "ships with Node.js", then recommend running:
While following the instructions, I used nvm use stable, which selected Node v25.8.0 with npm v11.11.0. In that environment, corepack is not available on PATH:
$ nvm use stable
Now using node v25.8.0 (npm v11.11.0)
$ corepack
-bash: corepack: command not found
This is confusing because the docs say Corepack ships with Node.js, but Node 25+ no longer distributes Corepack with Node. The docs do recommend Node 22 in the nvm snippet, but it is easy to read "v22+" / "ships with Node.js" as applying to the current stable Node release.
Official context:
Expected outcome: the setup docs should make this explicit, for example by saying to use Node 22/LTS rather than stable, or noting that Node 25+ users must install Corepack separately.
Reproduction
-
Install/use latest stable Node via nvm, currently Node 25.x:
-
Follow the pnpm setup instructions in CONTRIBUTING.md:
-
Observe:
-bash: corepack: command not found
XDS Version
Repository setup documentation on main; package version 0.0.0.
Environment
macOS shell using nvm. Observed with Node v25.8.0 and npm v11.11.0.
Description
The local setup instructions in
CONTRIBUTING.mdsay pnpm can be installed via Corepack, which "ships with Node.js", then recommend running:corepack enableWhile following the instructions, I used
nvm use stable, which selected Nodev25.8.0with npmv11.11.0. In that environment,corepackis not available on PATH:$ nvm use stable Now using node v25.8.0 (npm v11.11.0) $ corepack -bash: corepack: command not foundThis is confusing because the docs say Corepack ships with Node.js, but Node 25+ no longer distributes Corepack with Node. The docs do recommend Node 22 in the nvm snippet, but it is easy to read "v22+" / "ships with Node.js" as applying to the current stable Node release.
Official context:
Expected outcome: the setup docs should make this explicit, for example by saying to use Node 22/LTS rather than
stable, or noting that Node 25+ users must install Corepack separately.Reproduction
Install/use latest stable Node via nvm, currently Node 25.x:
Follow the pnpm setup instructions in
CONTRIBUTING.md:corepack enableObserve:
-bash: corepack: command not foundXDS Version
Repository setup documentation on
main; package version0.0.0.Environment
macOS shell using nvm. Observed with Node
v25.8.0and npmv11.11.0.