fix: use relative paths for GitHub Pages subpath deployment

Mearman · Mearman · commit 3ea54e428dea · 2026-05-27T04:26:50.000+01:00
All asset references (bundle.js, sw.js, manifest.json, workers, icons)
used absolute paths from root (/) which broke when served from
/agent-comms/ on GitHub Pages. Switch to relative paths (./) that
resolve correctly regardless of deployment base path.
diff --git a/src/bridges/user/web/frontend/index.html b/src/bridges/user/web/frontend/index.html
@@ -5,15 +5,15 @@
 <meta name="viewport" content="width=device-width, initial-scale=1">
 <title>Agent Comms</title>
 <meta name="theme-color" content="#16213e">
-<link rel="manifest" href="/manifest.json">
+<link rel="manifest" href="./manifest.json">
 </head>
 <body>
 <div id="root"></div>
-<script src="/bundle.js"></script>
+<script src="./bundle.js"></script>
 <script>
 if ("serviceWorker" in navigator) {
   window.addEventListener("load", function () {
-    navigator.serviceWorker.register("/sw.js");
+    navigator.serviceWorker.register("./sw.js");
   });
 }
 </script>
diff --git a/src/bridges/user/web/frontend/manifest.json b/src/bridges/user/web/frontend/manifest.json
@@ -2,23 +2,23 @@
   "name": "Agent Comms",
   "short_name": "Comms",
   "description": "Cross-harness LLM agent communication mesh",
-  "start_url": "/",
+  "start_url": "./",
   "display": "standalone",
   "background_color": "#1a1a2e",
   "theme_color": "#16213e",
   "icons": [
     {
-      "src": "/icons/icon-96x96.svg",
+      "src": "./icons/icon-96x96.svg",
       "sizes": "96x96",
       "type": "image/svg+xml"
     },
     {
-      "src": "/icons/icon-192x192.svg",
+      "src": "./icons/icon-192x192.svg",
       "sizes": "192x192",
       "type": "image/svg+xml"
     },
     {
-      "src": "/icons/icon-512x512.svg",
+      "src": "./icons/icon-512x512.svg",
       "sizes": "512x512",
       "type": "image/svg+xml"
     }
diff --git a/src/bridges/user/web/frontend/mesh-client.ts b/src/bridges/user/web/frontend/mesh-client.ts
@@ -54,7 +54,7 @@ export class MeshClient {
   connect(): void {
     if (this.worker) return;
 
-    const worker = new SharedWorker("/mesh-worker.js");
+    const worker = new SharedWorker("./mesh-worker.js");
     this.worker = worker;
 
     worker.port.onmessage = (event: MessageEvent) => {
diff --git a/src/bridges/user/web/frontend/relay-client.ts b/src/bridges/user/web/frontend/relay-client.ts
@@ -45,7 +45,7 @@ export class RelayClient {
   connect(): void {
     if (this.worker) return;
 
-    const worker = new SharedWorker("/relay-worker.js");
+    const worker = new SharedWorker("./relay-worker.js");
     this.worker = worker;
 
     worker.port.onmessage = (event: MessageEvent) => {
diff --git a/src/bridges/user/web/frontend/sw.ts b/src/bridges/user/web/frontend/sw.ts
@@ -101,13 +101,13 @@ declare const self: ServiceWorkerGlobalScope;
 const CACHE_NAME = "agent-comms-v1";
 
 const APP_SHELL = [
-  "/",
-  "/bundle.js",
-  "/sw.js",
-  "/manifest.json",
-  "/icons/icon-96x96.svg",
-  "/icons/icon-192x192.svg",
-  "/icons/icon-512x512.svg",
+  "./",
+  "./bundle.js",
+  "./sw.js",
+  "./manifest.json",
+  "./icons/icon-96x96.svg",
+  "./icons/icon-192x192.svg",
+  "./icons/icon-512x512.svg",
 ];
 
 // ---------------------------------------------------------------------------
