From 77ac154ce962d1507e758458987fe0b90504cd5d Mon Sep 17 00:00:00 2001
From: Jan Brasna <1784648+janbrasna@users.noreply.github.com>
Date: Sat, 17 Jan 2026 14:13:47 +0100
Subject: [PATCH 1/3] Update CI and expand matrix versions

---
 .github/workflows/build-test.yml | 28 ++++++++++++++++++++++++++++
 .github/workflows/node.js.yml    | 22 ----------------------
 2 files changed, 28 insertions(+), 22 deletions(-)
 create mode 100644 .github/workflows/build-test.yml
 delete mode 100644 .github/workflows/node.js.yml

diff --git a/.github/workflows/build-test.yml b/.github/workflows/build-test.yml
new file mode 100644
index 000000000..4982af367
--- /dev/null
+++ b/.github/workflows/build-test.yml
@@ -0,0 +1,28 @@
+name: CI
+
+on:
+  workflow_dispatch:
+  push:
+    branches: [ main ]
+  pull_request:
+    branches: [ main ]
+
+permissions:
+  contents: read
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        node: [20, 22, 24, 25]
+    steps:
+      - uses: actions/checkout@v6
+      - uses: actions/setup-node@v6
+        id: node
+        with:
+          node-version: ${{ matrix.node }}
+      - name: "Install, lint and test production build (Node ${{ steps.node.outputs.node-version }})"
+        run: npm run build-package
+      - name: "Run (Xvfb) JS tests in Firefox & Chrome"
+        run: xvfb-run npm test
diff --git a/.github/workflows/node.js.yml b/.github/workflows/node.js.yml
deleted file mode 100644
index 141022b3f..000000000
--- a/.github/workflows/node.js.yml
+++ /dev/null
@@ -1,22 +0,0 @@
-name: Node.js CI
-on:
-  push:
-    branches: [ main ]
-  pull_request:
-    branches: [ main ]
-jobs:
-  build:
-    runs-on: ubuntu-latest
-    steps:
-      - name: "Install framebuffer (xvfb) and Chromium"
-        run: |
-          sudo apt-get update
-          sudo apt-get install chromium-browser xvfb
-      - uses: actions/checkout@v4
-      - uses: actions/setup-node@v4
-        with:
-          node-version: 20
-      - name: "Install dependencies and build NPM package"
-        run: npm run build-package
-      - name: "Run JS tests"
-        run: xvfb-run npm test

From d17f4fa023cb4cb6a0206aabf110a79b67546222 Mon Sep 17 00:00:00 2001
From: Jan Brasna <1784648+janbrasna@users.noreply.github.com>
Date: Sun, 18 Jan 2026 02:48:06 +0100
Subject: [PATCH 2/3] Log versions in the output

---
 .github/workflows/build-test.yml | 14 ++++++++++----
 1 file changed, 10 insertions(+), 4 deletions(-)

diff --git a/.github/workflows/build-test.yml b/.github/workflows/build-test.yml
index 4982af367..67248b96d 100644
--- a/.github/workflows/build-test.yml
+++ b/.github/workflows/build-test.yml
@@ -14,6 +14,7 @@ jobs:
   test:
     runs-on: ubuntu-latest
     strategy:
+      fail-fast: false
       matrix:
         node: [20, 22, 24, 25]
     steps:
@@ -22,7 +23,12 @@ jobs:
         id: node
         with:
           node-version: ${{ matrix.node }}
-      - name: "Install, lint and test production build (Node ${{ steps.node.outputs.node-version }})"
-        run: npm run build-package
-      - name: "Run (Xvfb) JS tests in Firefox & Chrome"
-        run: xvfb-run npm test
+          cache: npm
+      - name: "Install, lint and build production outputs (Node ${{ steps.node.outputs.node-version }})"
+        run: |
+          npm run build-package
+      - name: "Build development outputs and (Xvfb) run JS tests in Firefox & Chrome"
+        run: |
+          firefox --version
+          google-chrome --version
+          xvfb-run npm test

From 47489584bd57e0c47063e1d59ebcacd38fa20ca3 Mon Sep 17 00:00:00 2001
From: Jan Brasna <1784648+janbrasna@users.noreply.github.com>
Date: Tue, 20 Jan 2026 00:37:50 +0100
Subject: [PATCH 3/3] Add deployment CI/CD notes

---
 README.md | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/README.md b/README.md
index 7eb53856b..4abd9e88f 100755
--- a/README.md
+++ b/README.md
@@ -148,6 +148,11 @@ should also be updated so the documentation site matches the NPM package feature
 2. Make sure your local `main` branch is up to date.
 3. Push the `main` branch to the `prod` branch: `git push origin main:prod`.
 
+_(The same is triggered by submitting a new GitHub Release, so the steps above can be
+skipped if you plan to publish a GitHub Release for the version tag — which you should.
+In such case the site deployment will be taken care of by automation, publishing the
+reference the release tag actually points to.)_
+
 A notice will be posted in #www-notify on Slack when the push has completed.
 
 ### Pushing to demo