Switch from npm to pnpm (#451)

* Initial plan

* Switch from npm to pnpm

Co-authored-by: abernier <76580+abernier@users.noreply.github.com>

* Fix pnpm version and setup order in CI workflow

Co-authored-by: abernier <76580+abernier@users.noreply.github.com>

* Update to latest pnpm version (10.28.1) and remove explicit version from CI

Co-authored-by: abernier <76580+abernier@users.noreply.github.com>

* Use corepack instead of npm install -g for pnpm installation

Co-authored-by: abernier <76580+abernier@users.noreply.github.com>

* Revert from pnpm dlx back to npx

Co-authored-by: abernier <76580+abernier@users.noreply.github.com>

* Simplify corepack prepare command to read version from package.json

Co-authored-by: abernier <76580+abernier@users.noreply.github.com>

* Fix Dockerfile: copy package.json before corepack prepare

Co-authored-by: abernier <76580+abernier@users.noreply.github.com>

---------

Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
Co-authored-by: abernier <76580+abernier@users.noreply.github.com>

Author: Copilot

.github/dependabot.yml

@@ -9,7 +9,7 @@ updates:
     directory: '/' # Location of package manifests
     schedule:
       interval: 'weekly'
-  - package-ecosystem: "github-actions"
-    directory: "/"
+  - package-ecosystem: 'github-actions'
+    directory: '/'
     schedule:
-      interval: "weekly"
+      interval: 'weekly'

.github/workflows/build.yml

@@ -107,7 +107,7 @@ jobs:
             -e THEME_WARNING \
             -e THEME_CAUTION \
             -e CONTRIBUTORS_PAT \
-            ghcr.io/pmndrs/docs:${{ inputs.docker_tag }} npm run build
+            ghcr.io/pmndrs/docs:${{ inputs.docker_tag }} pnpm run build
         env:
           BASE_PATH: ${{ steps.set-base-path.outputs.BASE_PATH }}
           MDX: ${{ inputs.mdx }}

.github/workflows/ci.yml

@@ -50,20 +50,23 @@ jobs:
         with:
           fetch-depth: 0
 
+      - name: Setup pnpm
+        uses: pnpm/action-setup@v4
+
       - name: Setup Node.js
         uses: actions/setup-node@v6
         with:
           node-version-file: '.nvmrc'
-          cache: 'npm'
+          cache: 'pnpm'
 
       - name: Install dependencies
-        run: npm ci
+        run: pnpm install --frozen-lockfile
 
       - name: Create Release Pull Request or Publish
         id: changesets
         uses: changesets/action@v1
         with:
-          publish: npm run release
+          publish: pnpm run release
           createGithubReleases: true
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

.gitignore

@@ -6,6 +6,9 @@
 .pnp.js
 node_modules/
 
+# pnpm
+.pnpm-debug.log*
+
 # other
 .next/
 .DS_Store

.husky/pre-commit

@@ -1,4 +1,4 @@
 echo "🪝 .husky/pre-commit hook is running"
 
-npx tsc --noEmit
-npx lint-staged
+pnpm exec tsc --noEmit
+pnpm exec lint-staged

Dockerfile

@@ -1,9 +1,15 @@
 FROM node:24-alpine
 
 RUN apk add --no-cache libc6-compat git && apk update
+
 WORKDIR /app
 
-COPY package.json package-lock.json ./
-RUN npm ci
+# Copy package.json first so corepack can read the packageManager field
+COPY package.json pnpm-lock.yaml ./
+
+# Enable corepack and prepare pnpm (reads version from package.json)
+RUN corepack enable && corepack prepare --activate
+
+RUN pnpm install --frozen-lockfile
 
 COPY . .

docs/getting-started/introduction.mdx

@@ -28,7 +28,7 @@ Pre-requisites:
 ```sh
 $ git clone https://github.com/pmndrs/docs.git
 $ cd docs
-$ npm ci
+$ pnpm install
 ```
 
 ## Configuration
@@ -136,7 +136,7 @@ $ (
 
   kill $(lsof -ti:"$_PORT")
   npx serve $MDX -p $_PORT --no-port-switching --no-clipboard &
-  npm run dev &
+  pnpm run dev &
 
   wait
 )
@@ -184,7 +184,7 @@ $ (
   export THEME_CAUTION="#da3633"
   export CONTRIBUTORS_PAT=
 
-  npm run build
+  pnpm run build
 
   kill $(lsof -ti:"$_PORT")
   npx serve $MDX -p $_PORT --no-port-switching --no-clipboard &
@@ -265,7 +265,7 @@ $ (
     -e THEME_WARNING \
     -e THEME_CAUTION \
     -e CONTRIBUTORS_PAT \
-    pmndrs-docs npm run build
+    pmndrs-docs pnpm run build
 
   kill $(lsof -ti:"$_PORT")
   npx serve $MDX -p $_PORT --no-port-switching --no-clipboard &