build: deploy docs from Cloudflare Pages

Author: chhoumann

.github/workflows/documentation.yml

@@ -6,16 +6,21 @@ on:
       - 'master'
     paths:
       - 'docs/**'
+      - '.github/workflows/documentation.yml'
+      - 'wrangler.jsonc'
 
 jobs:
-  deploy:
+  build:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v2
-      - uses: actions/setup-python@v2
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
         with:
           python-version: 3.x
-      - run: |
-          cd docs
-          pip install mkdocs-material 
-          mkdocs gh-deploy --force
+
+      - name: Install documentation dependencies
+        run: python -m pip install -r docs/requirements.txt
+
+      - name: Build documentation
+        run: npm run docs:build

.gitignore

@@ -21,4 +21,7 @@ data.json
 # Exclude macOS Finder (System Explorer) View States
 .DS_Store
 
-__snapshots__
+__snapshots__
+
+# Documentation build output
+docs/site

docs/requirements.txt

@@ -0,0 +1,2 @@
+mkdocs==1.6.1
+mkdocs-material==9.7.6

manifest.json

@@ -8,4 +8,4 @@
 	"authorUrl": "https://bagerbach.com",
 	"fundingUrl": "https://buymeacoffee.com/chhoumann",
 	"isDesktopOnly": false
-}
+}

package.json

@@ -12,7 +12,9 @@
 		"version": "node version-bump.mjs && git add manifest.json versions.json",
 		"semantic-release": "semantic-release",
 		"test": "npm run check:a11y && vitest",
-		"check:a11y": "svelte-check --fail-on-warnings"
+		"check:a11y": "svelte-check --fail-on-warnings",
+		"docs:build": "mkdocs build -f docs/mkdocs.yml -d site",
+		"docs:deploy": "npm run docs:build && npx wrangler pages deploy docs/site --project-name podnotes --branch master"
 	},
 	"keywords": [],
 	"author": "Christian Bager Bach Houmann",

vercel.json

@@ -0,0 +1,5 @@
+{
+	"name": "podnotes",
+	"compatibility_date": "2026-04-30",
+	"pages_build_output_dir": "./docs/site"
+}