ENG-3951: Switch to pnpm and mise for dependency management

.github/workflows/hugo.yml

@@ -19,22 +19,20 @@ jobs:
           fetch-depth: 0
           persist-credentials: false
 
-      - name: Setup Hugo
-        uses: peaceiris/actions-hugo@75d2e84710de30f6ff7268e08f310b60ef14033f # 3.0.0
-        with:
-          hugo-version: 'latest'
-          extended: true
-
-      - name: Install Dart Sass
-        run: sudo snap install dart-sass
-
-      - name: Setup Node.js
-        uses: actions/setup-node@6044e13b5dc448c55e2357c09f80417699197238 # v6.2.0
-        with:
-          node-version-file: '.nvmrc'
-
-      - name: Install Node dependencies
-        run: npm ci
+      - name: Setup mise
+        uses: jdx/mise-action@6d1e696aa24c1aa1bcc1adea0212707c71ab78a8 # v3.6.1
+
+      - name: Verify Hugo version matches wrangler.toml
+        run: |
+          MISE_VERSION=$(mise current hugo)
+          WRANGLER_VERSION=$(grep -oP 'HUGO_VERSION\s*=\s*"\K[^"]+' wrangler.toml | head -1)
+          if [ "$MISE_VERSION" != "$WRANGLER_VERSION" ]; then
+            echo "::error::Hugo version mismatch: mise has $MISE_VERSION, wrangler.toml has $WRANGLER_VERSION"
+            exit 1
+          fi
+
+      - name: Install dependencies
+        run: pnpm install --frozen-lockfile
 
       - name: Build site
         run: ./build.sh

.github/workflows/precious.yml

@@ -22,23 +22,16 @@ jobs:
           fetch-depth: 0
           persist-credentials: false
 
-      - uses: actions/setup-node@6044e13b5dc448c55e2357c09f80417699197238 # v6.2.0
-        with:
-          cache: 'npm'
-          node-version-file: '.nvmrc'
-
-      - name: Check that package-lock.json is valid JSON
-        run: jq empty package-lock.json
+      - name: Setup mise
+        uses: jdx/mise-action@6d1e696aa24c1aa1bcc1adea0212707c71ab78a8 # v3.6.1
 
-      - run: npm ci
+      - name: Install dependencies
+        run: pnpm install --frozen-lockfile
 
       - name: Fetch base ref
         if: ${{ github.event.pull_request }}
         run: git fetch origin "${BASE_REF}"
 
-      - name: Install precious
-        run: ./bin/install-precious /usr/local/bin
-
       - name: Select files
         id: select-files
         run: |

.gitignore

@@ -34,6 +34,9 @@ build/Release
 node_modules/
 jspm_packages/
 
+# pnpm
+.pnpm-store/
+
 # Typescript v1 declaration files
 typings/
 

.npmrc

@@ -1,2 +1 @@
 engine-strict=true
-legacy-peer-deps=true

.nvmrc

@@ -1 +1 @@
-v22.21.1
+v22.21.1

.precious.toml

@@ -1,7 +1,7 @@
 [commands.lint-scripts]
 type = "lint"
 cmd = [
-  "npm",
+  "pnpm",
   "run",
   "lint:scripts"
 ]
@@ -12,7 +12,8 @@ ok-exit-codes = 0
 [commands.stylelint-styles]
 type="both"
 cmd = [
-  "npx",
+  "pnpm",
+  "exec",
   "stylelint"
 ]
 lint-flags = []
@@ -24,7 +25,8 @@ ok-exit-codes = 0
 [commands.prettier-scripts]
 type = "both"
 cmd = [
-  "npx",
+  "pnpm",
+  "exec",
   "prettier",
   "--write"
 ]
@@ -38,7 +40,7 @@ ok-exit-codes = 0
 type="lint"
 include = ["*.md"]
 cmd = [
-  "npm",
+  "pnpm",
   "run",
   "lint:cspell",
 ]
@@ -51,7 +53,8 @@ include = [
     "content/**/*.md"
 ]
 cmd = [
-    "npx",
+    "pnpm",
+    "exec",
     "prettier",
     "--parser",
     "markdown",
@@ -67,7 +70,7 @@ ignore-stderr = ["Code style issues"]
 [commands.format-content]
 type = "tidy"
 cmd = [
-  "npm",
+  "pnpm",
   "run",
   "format:rawhtml"
 ]
@@ -79,7 +82,7 @@ ok-exit-codes = 0
 [commands.check-shortcode-parity]
 type = "lint"
 cmd = [
-  "npm",
+  "pnpm",
   "run",
   "lint:shortcode-parity"
 ]

README.md

@@ -25,54 +25,33 @@
   - [Development Server](#development-server)
 - [Updating Release Notes for the New Year](#updating-release-notes-for-the-new-year)
 
-### Minimum Requirements
+### Prerequisites
 
-The minimum versions can be found in the [package.json file](package.json)
-under `engines`.
+This project uses [mise](https://mise.jdx.dev/) to manage tool versions
+(Node.js, Hugo, pnpm, precious, Dart Sass).
 
-If you need help installing and/or managing Node and NPM versions, check out
-[NVM](https://github.com/nvm-sh/nvm).
-
-### Installation
+#### Install mise
 
 ```sh
-npm install
+curl https://mise.jdx.dev/install.sh | sh
 ```
 
-- `npm install` installs the necessary node modules for development.
-
-#### Install Precious
-
-You should install our pre-commit hook. You can do this from your checkout
-by running `git/setup.sh`. These hooks do things like ensure that the code you
-commit is tidy and passes various linter checks.
-
-#### Install Hugo
+See the [mise installation guide](https://mise.jdx.dev/getting-started.html)
+for other installation methods.
 
-##### Homebrew (macOS)
+### Installation
 
 ```sh
-brew install hugo
+mise trust    # Trust the mise.toml configuration
+mise install  # Install all required tools (Node, Hugo, pnpm, etc.)
+pnpm install  # Install Node.js dependencies
 ```
 
-##### Debian / Ubuntu
-
-It is recommended that you install
-[the latest release of Hugo](https://github.com/gohugoio/hugo/releases).
-For debian and ubuntu users, they offer a .deb file.
-
-##### Other OS
-
-See [Hugo Installation](https://gohugo.io/installation/)
+#### Pre-commit Hooks
 
-#### Install Embedded Dart Sass
-
-Download
-[Embedded Dart Sass](https://github.com/sass/dart-sass-embedded/releases) and
-make sure it is in your `$PATH`. This is necessary for Hugo to process SASS and
-SCSS files. See the
-[Hugo documentation](https://gohugo.io/functions/css/sass/#dart-sass) for more
-information.
+You should install our pre-commit hook. You can do this from your checkout
+by running `git/setup.sh`. These hooks do things like ensure that the code you
+commit is tidy and passes various linter checks.
 
 ### Development
 
@@ -97,15 +76,15 @@ directly**.
    and TypeScript type safety)
 2. Test your changes locally by generating the headers file:
    ```sh
-   npm run build:headers
+   pnpm run build:headers
    ```
 3. Commit only `bin/_headers.config.ts` - the `_headers` file will be
    generated automatically during deployment
 
 ##### Build-Time Generation
 
 The headers file is generated automatically during deployment via `build.sh`.
-You can also generate it manually for local testing with `npm run build:headers`.
+You can also generate it manually for local testing with `pnpm run build:headers`.
 
 ### Updating Release Notes for the New Year
 

build.sh

@@ -3,6 +3,6 @@
 set -eu
 
 # Generate _headers file from TypeScript configuration
-npm run build:headers
+pnpm run build:headers
 
 hugo --gc --minify -b "$CF_PAGES_URL"

content/geoip/release-notes/2026.md

@@ -11,9 +11,13 @@ whenever a new GeoIP release note is posted. {{</ alert >}}
 
 {{< release-note date="2026-01-22" title="Update to Japan NTT networks ISP/org name">}}
 
-On Tuesday, January 27, 2026, we will be updating a number of NTT (Nippon Telegraph and Telephone) networks to reflect one of NTT’s consumer-facing brands. For these networks, the ISP name will change from `NTT DOCOMO BUSINESS` to `Open Computer Network`.  
+On Tuesday, January 27, 2026, we will be updating a number of NTT (Nippon
+Telegraph and Telephone) networks to reflect one of NTT’s consumer-facing
+brands. For these networks, the ISP name will change from `NTT DOCOMO BUSINESS`
+to `Open Computer Network`.
 
 This change will be reflected in the following products and services:
+
 - GeoIP Enterprise database
 - GeoIP ISP database
 - GeoIP Insights web service

mise.toml

@@ -0,0 +1,9 @@
+[settings]
+lockfile = true
+idiomatic_version_file_enable_tools = ["node"]
+
+[tools]
+hugo = "0.153.1"
+"aqua:pnpm/pnpm" = "10.28.1"
+"github:houseabsolute/precious" = "0.10.1"
+"github:sass/dart-sass" = "1.97.3"