Deploy to Github Pages

Author: Andrew Marcuse

.github/workflows/ghpages-deploy.yaml

@@ -0,0 +1,48 @@
+name: deploy
+
+on:
+  push:
+    branches:
+      - main
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+jobs:
+  deploy:
+    environment:
+      name: github-pages
+      url: ${{steps.deployment.outputs.page_url}}
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Node
+        uses: actions/setup-node@v4
+        with:
+          node-version: 24
+          cache: 'npm'
+
+      - name: Install dependencies
+        run: |
+          sudo apt-get install -y jq moreutils
+          npm install
+
+      - name: Set Status Info
+        run: |
+          ./bin/set_status.sh
+
+      - name: Build
+        run: |
+          npm run build
+
+      - name: Upload Artifact
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: ./dist
+
+      - name: Deploy GitHub Pages
+        uses: actions/deploy-pages@v4

.gitignore

@@ -22,3 +22,7 @@ dist-ssr
 *.njsproj
 *.sln
 *.sw?
+
+public/status.json
+tmp
+*tmp

bin/set_status.sh

@@ -0,0 +1,41 @@
+#!/usr/bin/env bash
+#
+# Update status.json with the current build values
+#
+
+set -o nounset
+set -o errexit
+set -o pipefail
+
+SCRIPT_HOME="$( cd "$( dirname "$0" )" && pwd )"
+BASE_DIR=$(realpath "${SCRIPT_HOME}/..")
+
+# check that jq is installed
+if ! command -v jq &> /dev/null; then
+	echo "ERROR: jq is not installed. Please install jq to continue."
+	exit 1
+fi
+
+# check that sponge is installed
+if ! command -v sponge &> /dev/null; then
+	echo "ERROR: sponge is not installed. Please install sponge (from moreutils) to continue."
+	exit 1
+fi
+
+STATUS_FILE="${BASE_DIR}/public/status.json"
+
+LASTMOD=$(date -u +"%Y-%m-%dT%H:%M:%SZ")
+TECH="NodeJS $(node --version)"
+COMMIT=$(git -C "${BASE_DIR}" rev-parse --short HEAD)
+
+echo "INFO: updating status file ${STATUS_FILE}"
+
+echo "{}" | jq \
+	--arg lastmod "${LASTMOD}" \
+	--arg tech "${TECH}" \
+	--arg commit "${COMMIT}" \
+	--compact-output \
+	'.lastmod = $lastmod | .tech = $tech | .commit = $commit' \
+	>"${STATUS_FILE}"
+
+echo "INFO: completed at $(date -u +"%Y-%m-%dT%H:%M:%SZ")"