bustin makes me feel good

.github/workflows/deploy.yml

@@ -48,6 +48,10 @@ jobs:
           echo "VITE_GLOBAL_PROGRESS_BAR=false" >> .env
           echo "VITE_REQUIRES_GITHUB_AUTHENTICATION=false" >> .env
           echo "BASE_URL=${{ secrets.WORKSHOP_BASE_URL }}" >> .env
+          echo "VITE_BUILD_ID=${{ github.sha }}" >> .env
+
+      - name: Write version file
+        run: echo '{"build":"${{ github.sha }}"}' > public/version.json
 
       - name: Install dependencies
         run: npm ci

src/main.jsx

@@ -2,6 +2,10 @@ import React from 'react'
 import ReactDOM from 'react-dom/client'
 import App from './App'
 import './index.css'
+import { checkVersion } from './version-check'
+
+//this runs a browser reload if we have an older version; make sure it never breaks things
+try { checkVersion() } catch { /* ignore */ }
 
 // Create root and render
 ReactDOM.createRoot(document.getElementById('root')).render(

src/version-check.js

@@ -0,0 +1,19 @@
+
+//this busts Github Pages 10 minute cache scheme
+//if browser is running stale code, versions won't match and we reload once.
+const BUILD = import.meta.env.VITE_BUILD_ID;
+const RELOAD_KEY = 'version-check:reloaded-for';
+
+export function checkVersion() {
+  if (!BUILD) return; // local build, nothing to compare against
+
+  fetch(`${import.meta.env.BASE_URL}version.json?_=${Date.now()}`, { cache: 'no-store' })
+    .then((r) => r.json())
+    .then(({ build }) => {
+      if (!build || build === BUILD) return;
+      if (sessionStorage.getItem(RELOAD_KEY) === build) return; // already reloaded for this one
+      sessionStorage.setItem(RELOAD_KEY, build);
+      location.reload();
+    })
+    .catch(() => {});
+}