Changed Source theme from Yarn to pnpm

Standardises this theme on pnpm so local development and CI use the same package manager version as sibling Ghost themes. The release path is preserved by keeping the existing ship scripts and switching their package-manager calls to pnpm.

This also updates PR CI to install with pnpm, keeps the existing fatal gscan gate, runs pnpm zip before gscan so compatibility checks use freshly built assets, and excludes pnpm metadata from the release archive. pnpm-workspace.yaml explicitly denies dtrace-provider because it is an optional bunyan binding reached through gscan and is not needed to build, zip, or scan the theme.

Author: aileen

.gitattributes

@@ -0,0 +1,5 @@
+/AGENTS.md export-ignore
+/CLAUDE.md export-ignore
+/pnpm-lock.yaml export-ignore
+/pnpm-workspace.yaml export-ignore
+/.gitattributes export-ignore

.github/workflows/test.yml

@@ -16,14 +16,17 @@ jobs:
         with:
           persist-credentials: false
 
+      - uses: pnpm/action-setup@0e279bb959325dab635dd2c09392533439d90093
+
       - uses: actions/setup-node@48b55a011bda9f5d6aeb4c2d9c7362e8dae4041e
         with:
           node-version: lts/*
-          cache: yarn
+          cache: pnpm
+          cache-dependency-path: pnpm-lock.yaml
 
-      - run: yarn install --frozen-lockfile
+      - run: pnpm install --frozen-lockfile
 
-      - run: yarn test:ci
+      - run: pnpm test:ci
 
   all-tests-pass:
     name: All tests pass

AGENTS.md

@@ -6,13 +6,13 @@ This repository is the default Ghost theme. Keep changes focused on theme source
 
 ## Commands
 
-Use Yarn Classic for this repo.
+Use pnpm for this repo.
 
 ```bash
-yarn install --frozen-lockfile
-yarn dev
-yarn test:ci
-yarn zip
+pnpm install --frozen-lockfile
+pnpm dev
+pnpm test:ci
+pnpm zip
 ```
 
 Run the test command before opening a PR when theme files, generated assets, dependencies, or CI change.

README.md

@@ -29,14 +29,14 @@ One neat trick is that you can also create custom one-off templates by adding th
 
 # Development
 
-Source styles are compiled using Gulp/PostCSS to polyfill future CSS spec. You'll need [Node](https://nodejs.org/), [Yarn](https://yarnpkg.com/) and [Gulp](https://gulpjs.com) installed globally. After that, from the theme's root directory:
+Source styles are compiled using Gulp/PostCSS to polyfill future CSS spec. You'll need [Node](https://nodejs.org/), [pnpm](https://pnpm.io/) and [Gulp](https://gulpjs.com) installed globally. After that, from the theme's root directory:
 
 ```bash
 # install dependencies
-yarn install
+pnpm install
 
 # run development server
-yarn dev
+pnpm dev
 ```
 
 Now you can edit `/assets/css/` files, which will be compiled to `/assets/built/` automatically.
@@ -45,7 +45,7 @@ The `zip` Gulp task packages the theme files into `dist/<theme-name>.zip`, which
 
 ```bash
 # create .zip file
-yarn zip
+pnpm zip
 ```
 
 # PostCSS Features Used

gulpfile.js

@@ -79,8 +79,9 @@ function zipper(done) {
             '**',
             '!node_modules', '!node_modules/**',
             '!dist', '!dist/**',
-            '!yarn-error.log',
-            '!yarn.lock',
+            '!pnpm-debug.log',
+            '!pnpm-lock.yaml',
+            '!pnpm-workspace.yaml',
             '!AGENTS.md',
             '!CLAUDE.md',
             '!gulpfile.js'
@@ -102,7 +103,7 @@ exports.zip = series(build, zipper);
 exports.default = series(build, serve, watcher);
 
 exports.release = async () => {
-    // @NOTE: https://yarnpkg.com/lang/en/docs/cli/version/
+    // @NOTE: https://pnpm.io/cli/version
     // require(./package.json) can run into caching issues, this re-reads from file everytime on release
     let packageJSON = JSON.parse(fs.readFileSync('./package.json'));
     const newVersion = packageJSON.version;

package.json

@@ -11,13 +11,16 @@
     "scripts": {
         "dev": "gulp",
         "zip": "gulp zip",
+        "build": "gulp build",
         "test": "gscan .",
         "test:ci": "gscan --fatal --verbose .",
-        "pretest": "gulp build",
-        "preship": "yarn test",
-        "ship": "STATUS=$(git status --porcelain); echo $STATUS; if [ -z \"$STATUS\" ]; then yarn version && git push --follow-tags; else echo \"Uncomitted changes found.\" && exit 1; fi",
+        "pretest": "pnpm zip",
+        "pretest:ci": "pnpm zip",
+        "preship": "pnpm test",
+        "ship": "STATUS=$(git status --porcelain); echo $STATUS; if [ -z \"$STATUS\" ]; then pnpm version && git push --follow-tags; else echo \"Uncomitted changes found.\" && exit 1; fi",
         "postship": "git fetch && gulp release"
     },
+    "packageManager": "pnpm@11.6.0",
     "author": {
         "name": "Ghost Foundation",
         "email": "hello@ghost.org",