Merge branch 'move-to-pnpm' into 'main'

chore: replace npm with pnpm as default package manager

See merge request flarenetwork/docs-team/developer-hub-v1!1

Author: nikerzetic-aflabs

.github/dependabot.yml

@@ -21,12 +21,14 @@ jobs:
           fetch-depth: 0
       - uses: actions/setup-node@v6
         with:
-          node-version: 22
-          cache: "npm"
+          node-version-file: ".nvmrc"
+      - uses: pnpm/action-setup@v4
+        with:
+          cache: "true"
       - name: Install dependencies
-        run: npm ci
+        run: pnpm install --frozen-lockfile
       - name: Build website
-        run: npm run build
+        run: pnpm run build
       - name: Upload Build Artifact
         uses: actions/upload-pages-artifact@v4
         with:

.github/workflows/deploy.yml

@@ -16,12 +16,14 @@ jobs:
       - uses: actions/checkout@v6
       - uses: actions/setup-node@v6
         with:
-          node-version: 22
-          cache: "npm"
+          node-version-file: ".nvmrc"
+      - uses: pnpm/action-setup@v4
+        with:
+          cache: "true"
       - name: Install dependencies
-        run: npm ci
+        run: pnpm install --frozen-lockfile
       - name: Run ESLint
-        run: npm run lint -- --max-warnings=0
+        run: pnpm run lint:check -- --max-warnings=0
 
   typecheck:
     name: TypeScript Check
@@ -30,12 +32,14 @@ jobs:
       - uses: actions/checkout@v6
       - uses: actions/setup-node@v6
         with:
-          node-version: 22
-          cache: "npm"
+          node-version-file: ".nvmrc"
+      - uses: pnpm/action-setup@v4
+        with:
+          cache: "true"
       - name: Install dependencies
-        run: npm ci
+        run: pnpm install --frozen-lockfile
       - name: Run typecheck
-        run: npm run typecheck
+        run: pnpm run typecheck
 
   format-check:
     name: Format with Prettier
@@ -44,12 +48,14 @@ jobs:
       - uses: actions/checkout@v6
       - uses: actions/setup-node@v6
         with:
-          node-version: 22
-          cache: "npm"
+          node-version-file: ".nvmrc"
+      - uses: pnpm/action-setup@v4
+        with:
+          cache: "true"
       - name: Install dependencies
-        run: npm ci
+        run: pnpm install --frozen-lockfile
       - name: Run Prettier check
-        run: npm run format:check
+        run: pnpm run format:check
 
   build-and-link-check:
     name: Build & Link Check
@@ -58,9 +64,11 @@ jobs:
       - uses: actions/checkout@v6
       - uses: actions/setup-node@v6
         with:
-          node-version: 22
-          cache: "npm"
+          node-version-file: ".nvmrc"
+      - uses: pnpm/action-setup@v4
+        with:
+          cache: "true"
       - name: Install dependencies
-        run: npm ci
+        run: pnpm install --frozen-lockfile
       - name: Build Docusaurus site
-        run: npm run build
+        run: pnpm run build

.github/workflows/lint-check-internal-links.yml

@@ -30,15 +30,20 @@ jobs:
 
       - name: Setup Node.js
         if: steps.changed-files.outputs.any_changed == 'true'
-        uses: actions/setup-node@v4
+        uses: actions/setup-node@v6
         with:
-          node-version: 22
-          cache: "npm"
+          node-version-file: ".nvmrc"
+
+      - name: Setup pnpm
+        if: steps.changed-files.outputs.any_changed == 'true'
+        uses: pnpm/action-setup@v4
+        with:
+          cache: "true"
 
       - name: Install dependencies
         if: steps.changed-files.outputs.any_changed == 'true'
-        run: npm ci --include=dev
+        run: pnpm install --frozen-lockfile
 
       - name: Run sentence newline lint
         if: steps.changed-files.outputs.any_changed == 'true'
-        run: npx textlint --config .textlintrc.json ${{ steps.changed-files.outputs.all_changed_files }}
+        run: pnpm exec textlint --config .textlintrc.json ${{ steps.changed-files.outputs.all_changed_files }}

.github/workflows/lint-sentence-newline.yml

@@ -15,21 +15,19 @@ jobs:
   test:
     name: Test JavaScript Examples
     runs-on: ubuntu-latest
-    defaults:
-      run:
-        working-directory: ./examples/developer-hub-javascript
     steps:
       - uses: actions/checkout@v6
       - uses: actions/setup-node@v6
         with:
-          node-version: 22
-          cache: "npm"
-          cache-dependency-path: "examples/developer-hub-javascript/package-lock.json"
+          node-version-file: ".nvmrc"
+      - uses: pnpm/action-setup@v4
+        with:
+          cache: "true"
       - name: Install dependencies
-        run: npm ci
+        run: pnpm install --frozen-lockfile
       - name: Format with prettier
-        run: npm run format:diff
+        run: pnpm --filter ./examples/developer-hub-javascript run format:check
       - name: Lint with ESLint
-        run: npm run lint
+        run: pnpm --filter ./examples/developer-hub-javascript run lint:check
       - name: Test with jest
-        run: npm run test
+        run: pnpm --filter ./examples/developer-hub-javascript run test

.github/workflows/test-javascript-examples.yml

@@ -16,6 +16,7 @@
 .env.production.local
 
 npm-debug.log*
+pnpm-debug.log*
 yarn-debug.log*
 yarn-error.log*
 

.gitignore

@@ -0,0 +1,4 @@
+# Docusaurus and its plugin/webpack/loader chain reach into many undeclared
+# transitive deps, so we use a flat, npm-style node_modules instead of pnpm's
+# isolated layout.
+node-linker=hoisted

.npmrc

@@ -0,0 +1 @@
+24

.nvmrc

@@ -86,15 +86,15 @@ Run these locally before submitting a PR.
 1. **Build (includes internal link validation)**
 
    ```bash
-   npm run build
+   pnpm run build
    ```
 
 2. **Format, lint, and type-check**
 
    ```bash
-   npm run format
-   npm run lint
-   npm run typecheck
+   pnpm run format:fix
+   pnpm run lint:check
+   pnpm run typecheck
    ```
 
 3. **External link checking (optional but recommended)**

CONTRIBUTING.md

@@ -12,7 +12,7 @@ Built with [Docusaurus](https://docusaurus.io/), a modern static site generator.
 
 ### Prerequisites
 
-- [Node.js v22](https://nodejs.org/en/) and npm
+- [Node.js v24 LTS](https://nodejs.org/en/) and [pnpm](https://pnpm.io/) (enable with `corepack enable pnpm`)
   - Recommended: [nvm](https://github.com/nvm-sh/nvm) to manage Node versions
 - (Optional) For language-specific code in [examples](examples/):
   - Python: [uv](https://docs.astral.sh/uv/)
@@ -24,8 +24,9 @@ Built with [Docusaurus](https://docusaurus.io/), a modern static site generator.
 ```bash
 git clone https://github.com/flare-foundation/developer-hub.git
 cd developer-hub
-npm ci
-npm run start
+corepack enable pnpm
+pnpm install
+pnpm start
 ```
 
 This starts a local development server with hot reloading and opens the site in your browser.
@@ -53,7 +54,7 @@ flare-foundation/developer-hub/
 Some features (for example, search and production-only behavior) only work correctly against a production build.
 
 ```bash
-npm run build && npm run serve
+pnpm run build && pnpm run serve
 ```
 
 - `build` outputs the static site to `build/`
@@ -64,7 +65,7 @@ npm run build && npm run serve
 Run [Prettier](https://prettier.io/) for docs and site code:
 
 ```bash
-npm run format
+pnpm run format:fix
 ```
 
 Language-specific examples use their native tooling:
@@ -99,13 +100,13 @@ Automations update generated content used by tables/components (for example, con
 This will update `ftso_feeds.json` and `solidity_reference.json` in `src/features/DataTables/*`.
 
 ```bash
-npm run automations
+pnpm run automations
 ```
 
 To update dependencies across the language example projects:
 
 ```bash
-npm run update-deps
+pnpm run update-deps
 ```
 
 > **Caution:**
@@ -123,7 +124,7 @@ chmod +x generate-solidity-docs.sh
 
 # Return to the main site toolchain
 cd ..
-nvm use 22
+nvm use 24
 ```
 
 This pulls the latest smart contracts and regenerates the Solidity reference docs.