Migrate to pnpm

Author: CodeDoctorDE

.github/workflows/ci.yml

@@ -20,19 +20,23 @@ jobs:
 
     steps:
       - name: Check out repository
-        uses: actions/checkout@v6
+        uses: actions/checkout@v7
+
+      - name: Set up pnpm
+        uses: pnpm/action-setup@v6
 
       - name: Set up Node.js
         uses: actions/setup-node@v6
         with:
           node-version-file: .nvmrc
-          cache: npm
+          cache: pnpm
+          cache-dependency-path: pnpm-lock.yaml
 
       - name: Install dependencies
-        run: npm ci
+        run: pnpm install --frozen-lockfile
 
       - name: Run frontend checks
-        run: npm run check
+        run: pnpm run check
 
   php:
     name: PHP
@@ -41,12 +45,12 @@ jobs:
 
     steps:
       - name: Check out repository
-        uses: actions/checkout@v6
+        uses: actions/checkout@v7
 
       - name: Set up PHP
         uses: shivammathur/setup-php@v2
         with:
-          php-version: '8.1'
+          php-version: '8.4'
           coverage: none
           tools: composer:v2
 

CONTRIBUTING.md

@@ -14,16 +14,17 @@ Thank you for helping improve Butterfly's Nextcloud integration.
 ## Development setup
 
 You need Nextcloud 31–34, PHP 8.1 or newer, Composer, Node.js 24.11 or newer
-in the 24.x release line, and npm 11. The included Docker Compose setup
+in the 24.x release line, and Corepack for pnpm 11. The included Docker Compose setup
 provides a local Nextcloud 34 instance.
 
 ```bash
 git clone https://github.com/LinwoodDev/ButterflyNextcloud.git
 cd ButterflyNextcloud
 nvm install
 nvm use
-npm ci
-npm run build
+corepack enable
+pnpm install --frozen-lockfile
+pnpm run build
 composer install
 chmod a+rx .
 docker compose up -d
@@ -47,7 +48,7 @@ Open <http://localhost:8080> and sign in with `admin` / `admin`. Upload a
 Run all checks before opening a pull request:
 
 ```bash
-npm run check
+pnpm run check
 composer lint
 composer cs:check
 composer psalm
@@ -60,7 +61,7 @@ the pull request. Do not commit generated `node_modules`, `vendor`, `js`, or
 
 ## Dependency updates
 
-Use `npm install` when intentionally changing JavaScript constraints, and
-commit both `package.json` and `package-lock.json`. Use `composer update` for
+Use `corepack pnpm update` when intentionally changing JavaScript constraints,
+and commit both `package.json` and `pnpm-lock.yaml`. Use `composer update` for
 PHP tooling and commit the affected Composer lockfiles. Avoid forced upgrades
 that violate the supported Node.js, PHP, or Nextcloud ranges.

README.md

@@ -10,7 +10,8 @@ while they are open. The app is based on the official
 
 - Nextcloud 31–34
 - PHP 8.1 or newer
-- Node.js 24.11 or newer in the 24.x release line, and npm 11, for building
+- Node.js 24.11 or newer in the 24.x release line, with Corepack for pnpm 11,
+  for building
   the frontend
 - Composer for PHP development and tests
 
@@ -19,8 +20,9 @@ while they are open. The app is based on the official
 ```bash
 nvm install
 nvm use
-npm ci
-npm run build
+corepack enable
+pnpm install --frozen-lockfile
+pnpm run build
 composer install
 ```
 
@@ -32,8 +34,9 @@ present in an installed or packaged app.
 Build the frontend, then start the included development instance:
 
 ```bash
-npm ci
-npm run build
+corepack enable
+pnpm install --frozen-lockfile
+pnpm run build
 chmod a+rx .
 docker compose up -d
 docker compose exec --user www-data nextcloud php occ app:enable butterfly
@@ -70,7 +73,7 @@ not discover the mounted app and attempted to install it instead.
 ## Checks
 
 ```bash
-npm run check
+pnpm run check
 composer lint
 composer cs:check
 composer psalm