Skip to content

Commit 8c9f1b3

Browse files
committed
docs: document pnpm 12 bootstrap and Corepack recovery
pnpm 12 removes the legacy CommonJS entry used by older Corepack versions. Document a compatible Corepack upgrade, stale cache recovery, and direct pnpm installation so existing Node 22 environments can adopt the upgrade.
1 parent 7ffb5b6 commit 8c9f1b3

1 file changed

Lines changed: 20 additions & 0 deletions

File tree

‎README.md‎

Lines changed: 20 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -98,7 +98,27 @@ The service will start on the following ports:
9898

9999
### Install Dependencies
100100

101+
The pnpm version is pinned in `package.json` under `devEngines.packageManager`.
102+
103+
If you use Corepack, upgrade to **Corepack >= 0.34.5** before running pnpm 12:
104+
105+
```bash
106+
npm install --global corepack@0.34.5
107+
corepack enable pnpm
108+
```
109+
110+
Older Corepack versions look for `bin/pnpm.cjs`, which pnpm 12 no longer provides. If a previous attempt failed with `Cannot find module .../bin/pnpm.cjs`, run `corepack cache clean` after upgrading to clear the stale package-manager cache, then retry.
111+
112+
Alternatively, install pnpm directly through npm. If Corepack manages your `pnpm` command, first run `corepack disable pnpm`.
113+
114+
```bash
115+
npm install --global pnpm@12.3.4
116+
```
117+
118+
From the project directory, verify the pinned version and install dependencies:
119+
101120
```bash
121+
pnpm --version # Expected: 12.3.4
102122
pnpm install
103123
```
104124

0 commit comments

Comments
 (0)