diff --git a/.github/dependabot.yml b/.github/dependabot.yml
index f097463..1596015 100644
--- a/.github/dependabot.yml
+++ b/.github/dependabot.yml
@@ -11,6 +11,10 @@ updates:
         patterns: ["*"]
   - package-ecosystem: npm
     directory: /docs
+    # not the theme: it is installed from a git tag, which Dependabot compares wrongly (it
+    # "updated" v0.3.1 to v0.2.0); bump it by hand with the docs workflow tag
+    ignore:
+      - dependency-name: "@max-models/starlight-theme"
     schedule:
       interval: weekly
     groups:
diff --git a/.github/workflows/docs.yml b/.github/workflows/docs.yml
index 5060493..4f1a52b 100644
--- a/.github/workflows/docs.yml
+++ b/.github/workflows/docs.yml
@@ -22,7 +22,7 @@ concurrency:
 
 jobs:
   docs:
-    uses: max-models/starlight-theme/.github/workflows/docs.yml@v0.3.1
+    uses: max-models/starlight-theme/.github/workflows/docs.yml@v0.4.0
     with:
       pre-build: uv run python docs/tools/examples.py
       smoke-paths: |
diff --git a/docs/package-lock.json b/docs/package-lock.json
index 5dfe5c7..cdd9670 100644
--- a/docs/package-lock.json
+++ b/docs/package-lock.json
@@ -9,7 +9,7 @@
       "version": "0.0.1",
       "dependencies": {
         "@astrojs/starlight": "^0.42.6",
-        "@max-models/starlight-theme": "github:max-models/starlight-theme#v0.2.0",
+        "@max-models/starlight-theme": "github:max-models/starlight-theme#v0.4.0",
         "astro": "^7.4.0",
         "sharp": "^0.35.3"
       },
@@ -1223,9 +1223,8 @@
       "license": "MIT"
     },
     "node_modules/@max-models/starlight-theme": {
-      "version": "0.2.0",
-      "resolved": "git+ssh://git@github.com/max-models/starlight-theme.git#2f646c50fd31fc23b9af1348600cbad708f2279f",
-      "integrity": "sha512-Irh3NsLgtq8gFVF3j2jouANhJyK0zkAGc6G1pIQweKtLwj63WOelR0NRmxekhlYRd1baV2foJ2T0OmOCJc/QDw==",
+      "version": "0.4.0",
+      "resolved": "git+ssh://git@github.com/max-models/starlight-theme.git#786dad95026f1c3db4e771af5384c002044864fc",
       "license": "MIT",
       "workspaces": [
         "example/docs"
@@ -1243,7 +1242,8 @@
       "bin": {
         "starlight-check-mdx": "bin/check-mdx.mjs",
         "starlight-gallery": "bin/gallery.mjs",
-        "starlight-notebooks": "bin/notebooks.mjs"
+        "starlight-notebooks": "bin/notebooks.mjs",
+        "starlight-theme-init": "bin/init.mjs"
       },
       "engines": {
         "node": ">=22.12.0"
@@ -1526,9 +1526,6 @@
       "cpu": [
         "arm64"
       ],
-      "libc": [
-        "glibc"
-      ],
       "license": "MIT",
       "optional": true,
       "os": [
@@ -1545,9 +1542,6 @@
       "cpu": [
         "arm64"
       ],
-      "libc": [
-        "musl"
-      ],
       "license": "MIT",
       "optional": true,
       "os": [
@@ -1564,9 +1558,6 @@
       "cpu": [
         "ppc64"
       ],
-      "libc": [
-        "glibc"
-      ],
       "license": "MIT",
       "optional": true,
       "os": [
@@ -1583,9 +1574,6 @@
       "cpu": [
         "s390x"
       ],
-      "libc": [
-        "glibc"
-      ],
       "license": "MIT",
       "optional": true,
       "os": [
@@ -1602,9 +1590,6 @@
       "cpu": [
         "x64"
       ],
-      "libc": [
-        "glibc"
-      ],
       "license": "MIT",
       "optional": true,
       "os": [
@@ -1621,9 +1606,6 @@
       "cpu": [
         "x64"
       ],
-      "libc": [
-        "musl"
-      ],
       "license": "MIT",
       "optional": true,
       "os": [
diff --git a/docs/package.json b/docs/package.json
index caff250..adeb183 100644
--- a/docs/package.json
+++ b/docs/package.json
@@ -17,7 +17,7 @@
   },
   "dependencies": {
     "@astrojs/starlight": "^0.42.6",
-    "@max-models/starlight-theme": "github:max-models/starlight-theme#v0.2.0",
+    "@max-models/starlight-theme": "github:max-models/starlight-theme#v0.4.0",
     "astro": "^7.4.0",
     "sharp": "^0.35.3"
   }