From aeb1358360530c81e8fd04b2e74cc2c248dd1ef1 Mon Sep 17 00:00:00 2001 From: Logan Rosen Date: Thu, 22 Oct 2026 22:02:10 -0400 Subject: [PATCH 1/2] docs: update install instructions for Node.js 25+ Node.js 25 no longer ships Corepack, so split the install section by whether Corepack is bundled and make the npm install steps visible. Switch the update command from `corepack@latest` to a bare `corepack`, which lets npm pick the newest release compatible with the running Node.js version instead of forcing one whose `engines` may not match. Also fix the `corepack disable` description, which locates Corepack rather than Node.js. Fixes #783 Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> Copilot-Session: 812ed6c7-9adb-4a4b-822e-a1f511614be2 --- README.md | 27 +++++++++++++++++---------- 1 file changed, 17 insertions(+), 10 deletions(-) diff --git a/README.md b/README.md index e2adeb949..c06819ab7 100644 --- a/README.md +++ b/README.md @@ -9,15 +9,18 @@ and pnpm without having to install them**. ## How to Install -### Default Installs +### Node.js 14.19.0 to 24.x Corepack is distributed with Node.js from version 14.19.0 up to (but not including) 25.0.0. Run `corepack enable` to install the required Yarn and pnpm binaries on your path. +If you're on a supported Node.js release that still bundles Corepack, using the +bundled version is the preferred option. -### Manual Installs +### Node.js versions without bundled Corepack -
-Install Corepack using npm +Starting with Node.js 25, Corepack is no longer distributed with Node.js +([nodejs/node#57617](https://github.com/nodejs/node/pull/57617)), so you need to +install it from npm. First uninstall your global Yarn and pnpm binaries (just leave npm). In general, you'd do this by running the following command: @@ -35,18 +38,22 @@ Then install Corepack: npm install -g corepack ``` +This installs the Yarn and pnpm shims as well, so there's no need to run +`corepack enable` afterwards. + We do acknowledge the irony and overhead of using npm to install Corepack, which -is at least part of why the preferred option is to use the Corepack version that -is distributed along with Node.js itself. +is part of why we recommend the bundled version on supported Node.js releases +that still include it. -
+### Updating or Installing from Source
Update Corepack using npm -To install the latest version of Corepack, use: +To update Corepack to the newest version compatible with your Node.js version, +use: ```shell -npm install -g corepack@latest +npm install -g corepack ``` If Corepack was installed on your system using a Node.js Windows Installer @@ -243,7 +250,7 @@ echo 'function npx { corepack npx @args }' >> $PROFILE | --------------------- | ------------------------------------------ | | `--install-directory` | Remove the shims to the specified location | -This command will detect where Node.js is installed and will remove the shims +This command will detect where Corepack is installed and will remove the shims from there. ### `corepack install` From 690ec69978b0a29b1d3993fae1623164eb269b21 Mon Sep 17 00:00:00 2001 From: Logan Rosen Date: Thu, 22 Oct 2026 22:20:10 -0400 Subject: [PATCH 2/2] docs: drop the "irony" paragraph from the install section It was written when Corepack shipped with every Node.js release and doesn't fit the section for versions where npm is the only option. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> Copilot-Session: 812ed6c7-9adb-4a4b-822e-a1f511614be2 --- README.md | 4 ---- 1 file changed, 4 deletions(-) diff --git a/README.md b/README.md index c06819ab7..90f995863 100644 --- a/README.md +++ b/README.md @@ -41,10 +41,6 @@ npm install -g corepack This installs the Yarn and pnpm shims as well, so there's no need to run `corepack enable` afterwards. -We do acknowledge the irony and overhead of using npm to install Corepack, which -is part of why we recommend the bundled version on supported Node.js releases -that still include it. - ### Updating or Installing from Source
Update Corepack using npm