feat: pnpm migration

.github/workflows/ci.yml

@@ -18,18 +18,21 @@ jobs:
     steps:
       - uses: actions/checkout@v6
       - uses: jdx/mise-action@v4
+      - uses: pnpm/action-setup@v4
+        with:
+          version: 10.33.2
       - name: Install dependencies
-        run: npm ci
+        run: pnpm install --frozen-lockfile
       - name: Pull environment variables from Vercel
-        run: npx vercel env pull .env.local --token=${{ secrets.VERCEL_TOKEN }} --yes
+        run: pnpm dlx vercel env pull .env.local --token=${{ secrets.VERCEL_TOKEN }} --yes
       - name: Build
-        run: npm run build
+        run: pnpm run build
       - name: Lint
-        run: npm run lint
+        run: pnpm run lint
       - name: Type check
-        run: npm run type:check
+        run: pnpm run type:check
       - name: Format
-        run: npm run format:check
+        run: pnpm run format:check
 
   e2e:
     name: E2E Tests
@@ -39,12 +42,15 @@ jobs:
     steps:
       - uses: actions/checkout@v6
       - uses: jdx/mise-action@v4
+      - uses: pnpm/action-setup@v4
+        with:
+          version: 10.33.2
       - name: Install dependencies
-        run: npm ci
+        run: pnpm install --frozen-lockfile
       - name: Install Playwright browsers
-        run: npx playwright install --with-deps chromium
+        run: pnpm exec playwright install --with-deps chromium
       - name: Pull environment variables from Vercel
-        run: npx vercel env pull .env.local --token=${{ secrets.VERCEL_TOKEN }} --yes
+        run: pnpm dlx vercel env pull .env.local --token=${{ secrets.VERCEL_TOKEN }} --yes
       - name: Wait for Vercel preview deployment
         uses: patrickedqvist/wait-for-vercel-preview@v1.3.3
         id: wait_for_vercel
@@ -53,7 +59,7 @@ jobs:
           max_timeout: 300
           check_interval: 10
       - name: Run E2E tests
-        run: npm run test:e2e
+        run: pnpm run test:e2e
         env:
           PLAYWRIGHT_TEST_BASE_URL: ${{ steps.wait_for_vercel.outputs.url }}
       - name: Upload test results

.github/workflows/crawl.yml

@@ -27,36 +27,42 @@ jobs:
     outputs:
       chunks: ${{ steps.chunk.outputs.chunks }}
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
       - uses: jdx/mise-action@v4
+      - uses: pnpm/action-setup@v4
+        with:
+          version: 10.33.2
       - name: Install dependencies
-        run: npm ci
+        run: pnpm install --frozen-lockfile
       - id: chunk
         name: Compute chunks
         run: |
           SIZE=${{ github.event.inputs.chunk_size || '4' }}
-          echo "chunks=$(npx tsx bin/wsc.ts list chunks --size $SIZE)" >> $GITHUB_OUTPUT
+          echo "chunks=$(pnpm exec tsx bin/wsc.ts list chunks --size $SIZE)" >> $GITHUB_OUTPUT
 
   crawl-clubs:
     name: Crawl clubs
     runs-on: ubuntu-latest
     timeout-minutes: 10
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
       - uses: jdx/mise-action@v4
+      - uses: pnpm/action-setup@v4
+        with:
+          version: 10.33.2
       - name: Install dependencies
-        run: npm ci
+        run: pnpm install --frozen-lockfile
       - name: Cache Playwright browsers
         uses: actions/cache@v4
         with:
           path: ~/.cache/ms-playwright
-          key: playwright-chrome-${{ hashFiles('package-lock.json') }}
+          key: playwright-chrome-${{ hashFiles('pnpm-lock.yaml') }}
       - name: Install Chrome
-        run: npx playwright install --with-deps chrome
+        run: pnpm exec playwright install --with-deps chrome
       - name: Crawl clubs
-        run: npm run crawl:clubs:ci
+        run: pnpm run crawl:clubs:ci
       - name: Sync clubs
-        run: npm run sync:clubs
+        run: pnpm run sync:clubs
       - uses: actions/upload-artifact@v4
         with:
           name: clubs-data
@@ -72,27 +78,30 @@ jobs:
         chunk: ${{ fromJson(needs.setup.outputs.chunks) }}
       fail-fast: false
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
       - uses: jdx/mise-action@v4
+      - uses: pnpm/action-setup@v4
+        with:
+          version: 10.33.2
       - name: Install dependencies
-        run: npm ci
+        run: pnpm install --frozen-lockfile
       - name: Cache Playwright browsers
         uses: actions/cache@v4
         with:
           path: ~/.cache/ms-playwright
-          key: playwright-chrome-${{ hashFiles('package-lock.json') }}
+          key: playwright-chrome-${{ hashFiles('pnpm-lock.yaml') }}
       - name: Install Chrome
-        run: npx playwright install --with-deps chrome
+        run: pnpm exec playwright install --with-deps chrome
 
       - name: Crawl fixtures for chunk
-        run: xvfb-run --auto-servernum npx tsx bin/wsc.ts crawl fixtures --team ${{ join(matrix.chunk, ' --team ') }}
+        run: xvfb-run --auto-servernum pnpm exec tsx bin/wsc.ts crawl fixtures --team ${{ join(matrix.chunk, ' --team ') }}
 
       - name: Sync fixtures and tables for chunk
         run: |
           mkdir -p tmp/crawl/matches tmp/crawl/table
           for team in ${{ join(matrix.chunk, ' ') }}; do
-            npx tsx bin/wsc.ts sync fixtures --team "$team"
-            npx tsx bin/wsc.ts sync table --team "$team"
+            pnpm exec tsx bin/wsc.ts sync fixtures --team "$team"
+            pnpm exec tsx bin/wsc.ts sync table --team "$team"
             if [[ -f "data/matches/$team.json" ]]; then
               cp "data/matches/$team.json" "tmp/crawl/matches/$team.json"
             else
@@ -123,10 +132,13 @@ jobs:
     needs: [crawl-clubs, crawl]
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
       - uses: jdx/mise-action@v4
+      - uses: pnpm/action-setup@v4
+        with:
+          version: 10.33.2
       - name: Install dependencies
-        run: npm ci
+        run: pnpm install --frozen-lockfile
       - uses: actions/download-artifact@v4
         with:
           pattern: clubs-data
@@ -144,7 +156,7 @@ jobs:
           path: data/table/
           merge-multiple: true
       - name: Format code
-        run: npm run format
+        run: pnpm run format
       - name: Create Pull Request
         id: cpr
         uses: peter-evans/create-pull-request@v8

.github/workflows/deploy-sanity.yml

@@ -21,11 +21,15 @@ jobs:
 
       - uses: jdx/mise-action@v4
 
+      - uses: pnpm/action-setup@v4
+        with:
+          version: 10.33.2
+
       - name: Install dependencies
-        run: npm ci
+        run: pnpm install --frozen-lockfile
 
       - name: Deploy to Sanity
-        run: npm run deploy:sanity -- --yes
+        run: pnpm run deploy:sanity -- --yes
         env:
           SANITY_AUTH_TOKEN: ${{ secrets.SANITY_AUTH_TOKEN }}
           NEXT_PUBLIC_SANITY_PROJECT_ID: ${{ vars.SANITY_PROJECT_ID }}

.prettierignore

@@ -9,6 +9,8 @@ node_modules
 
 # Ignore files for PNPM, NPM and YARN
 package-lock.json
+pnpm-lock.yaml
+yarn.lock
 
 # Nextjs
 .next

AGENTS.md

@@ -1,27 +1,27 @@
 # Environment & Commands
 
-- **IMPORTANT**: Dev server runs on port 3003 (not 3000): `npm run dev`
-- Node version: 24.12.0 (managed by Volta)
+- **IMPORTANT**: Dev server runs on port 3003 (not 3000): `pnpm run dev`
+- Node version (managed by Mise)
 - TypeScript path aliases: `@/*` (src), `@data/*` (data)
 - Required env vars: see .env.example (Sanity, AWS SES, reCAPTCHA)
 - Sanity Studio: separate at /studio path
 
 ## Key Commands (see package.json for full list)
 
-- `npm run dev` - Dev server on port 3003
-- `npm run test:e2e[:ui|:debug|:report]` - Playwright E2E tests
-- `npm run crawl:[clubs|fixtures]` - Playwright-based web scraping
-- `npm run sync:[clubs|fixtures]` - Sync scraped data to Sanity
-- `npm run type:gen` - Regenerate Sanity types after schema changes
+- `pnpm run dev` - Dev server on port 3003
+- `pnpm run test:e2e[:ui|:debug|:report]` - Playwright E2E tests
+- `pnpm run crawl:[clubs|fixtures]` - Playwright-based web scraping
+- `pnpm run sync:[clubs|fixtures]` - Sync scraped data to Sanity
+- `pnpm run type:gen` - Regenerate Sanity types after schema changes
 
 # Testing
 
 - Framework: Playwright only (no unit test framework)
 - Tests run against http://localhost:3003
-- Run E2E tests: `npm run test:e2e`
-- Run with UI mode: `npm run test:e2e:ui`
-- Debug mode: `npm run test:e2e:debug`
-- View report: `npm run test:e2e:report`
+- Run E2E tests: `pnpm run test:e2e`
+- Run with UI mode: `pnpm run test:e2e:ui`
+- Debug mode: `pnpm run test:e2e:debug`
+- View report: `pnpm run test:e2e:report`
 
 # Technical Requirements
 
@@ -62,11 +62,11 @@
 All changes MUST follow the following workflow
 
 - After finishing code changes and **before every push**, run all checks in order:
-  1. `npm run format`
-  2. `npm run lint`
-  3. `npm run type:check`
-  4. `npm run build`
-  5. `npm run test:e2e`
+  1. `pnpm run format`
+  2. `pnpm run lint`
+  3. `pnpm run type:check`
+  4. `pnpm run build`
+  5. `pnpm run test:e2e`
 - Never push without running these checks — commit any formatting changes before pushing
 - Pre-commit hooks auto-run: Husky runs lint-staged (prettier + eslint)
 - Update any plan files with progress to help with issue tracking
@@ -96,5 +96,5 @@ All changes MUST follow the following workflow
 - **NEVER**: create "helpers" or "utils" (use services/mappers/transformers)
 - Playwright-based web scraping: crawl scripts use playwright-core for data extraction
 - Pre-commit hooks auto-run: changes will trigger prettier + eslint
-- Run `npm run type:gen` after Sanity schema changes
+- Run `pnpm run type:gen` after Sanity schema changes
 - Prettier line width: 100 chars (not default 80)

README.md

@@ -26,9 +26,9 @@
 
 ## Tooling
 
-- **Next.js 16**: React framework for production-grade applications
+- **Next.js**: React framework for production-grade applications
 - **Sanity CMS**: Headless CMS for flexible content management
-- **Tailwind CSS V4**: Utility-first CSS framework
+- **Tailwind CSS**: Utility-first CSS framework
 - **DaisyUI**: Tailwind CSS component library
 - **TypeScript**: Type-safe development
 - **Zod**: Schema validation for environment variables
@@ -47,15 +47,22 @@ To run the site locally, follow these steps:
 
 ### Prerequisites
 
-- Node.js 24 installed
+- Node.js installed (managed by Mise)
+- pnpm
 - A Sanity account and project set up
 
 ### CLI tools
 
 The data CLI uses Playwright. Before running crawl commands, install the browser binaries:
 
 ```bash
-npx playwright install --with-deps chromium
+pnpm exec playwright install --with-deps chromium
+```
+
+### Install dependencies
+
+```bash
+pnpm install
 ```
 
 ## Content Management
@@ -74,7 +81,7 @@ Sanity URLs:
 After modifying Sanity schemas in `src/sanity/schema/`, run:
 
 ```bash
-npm run type:gen
+pnpm run type:gen
 ```
 
 This will update the TypeScript types to match your schema changes.

docs/plans/2026-04-28-pnpm-migration.md

@@ -0,0 +1,48 @@
+# Migrate repo to pnpm
+
+**Created:** 2026-04-28
+**Status:** In Progress
+
+## Purpose
+
+Standardize project package manager on pnpm. Keep local docs and GitHub workflows aligned to prevent drift and CI failures.
+
+## Requirements
+
+- Use pnpm as canonical package manager for local and CI workflows
+- Remove npm lockfile and commit pnpm lockfile
+- Update script references in active docs and workflow docs
+- Update GitHub Actions install and command steps to pnpm
+
+## Todo
+
+- [x] Generate `pnpm-lock.yaml` from current dependency graph
+- [x] Add `packageManager` in `package.json`
+- [x] Update build script chaining in `package.json` to pnpm
+- [x] Configure `pnpm.onlyBuiltDependencies` for known postinstall/build-script deps
+- [x] Remove `package-lock.json`
+- [x] Migrate `.github/workflows/ci.yml` to pnpm install/exec/run commands
+- [x] Migrate `.github/workflows/crawl.yml` to pnpm install/exec/run commands and lockfile cache key
+- [x] Migrate `.github/workflows/deploy-sanity.yml` to pnpm install/run commands
+- [x] Update command docs in `README.md`
+- [x] Update command docs in `AGENTS.md`
+- [x] Run `pnpm run type:check`
+- [x] Run `pnpm run lint`
+- [x] Run `pnpm run format`
+- [x] Run `pnpm run build`
+- [ ] Run `pnpm run test:e2e` (1 failing test: `tests/search.spec.ts` navigation assertion)
+
+## Files
+
+- `package.json`: set pnpm package manager, update build chaining, add pnpm build-script allowlist
+- `pnpm-lock.yaml`: new lockfile generated via pnpm install
+- `package-lock.json`: removed
+- `.github/workflows/ci.yml`: npm/npx commands replaced with pnpm equivalents
+- `.github/workflows/crawl.yml`: npm/npx commands replaced with pnpm equivalents, cache key now uses pnpm lockfile
+- `.github/workflows/deploy-sanity.yml`: npm commands replaced with pnpm equivalents
+- `README.md`: local setup and schema typegen commands updated to pnpm
+- `AGENTS.md`: workflow command references updated to pnpm
+
+## Unresolved questions
+
+- None