From 0196c30a9a938b6a0f8c6ae177b4286d7362ff39 Mon Sep 17 00:00:00 2001
From: Ajay Rajera <newajay.11r@gmail.com>
Date: Fri, 10 Jul 2026 17:53:23 +0530
Subject: [PATCH] fix: resolve 404 error on page reload for GitHub Pages SPA
 routing

---
 index.html      | 20 ++++++++++++++++++++
 public/404.html | 28 ++++++++++++++++++++++++++++
 2 files changed, 48 insertions(+)
 create mode 100644 public/404.html
diff --git a/index.html b/index.html
index 8c90966..ee355bb 100644
--- a/index.html
+++ b/index.html
@@ -48,6 +48,26 @@
 
   <link rel="preconnect" href="https://api.github.com" />
   <link rel="dns-prefetch" href="https://api.github.com" />
+
+  <!-- Single Page Apps for GitHub Pages: restore route after 404 redirect -->
+  <!-- https://github.com/rafgraph/spa-github-pages -->
+  <script>
+    (function(l) {
+      if (l.search[1] === '/') {
+        var decoded = l.search.slice(1).split('&').map(function(s) {
+          return s.replace(/~and~/g, '&');
+        });
+        window.history.replaceState(
+          null,
+          null,
+          l.pathname.slice(0, -1) +
+            decoded[0] +
+            (decoded[1] ? '?' + decoded[1] : '') +
+            l.hash
+        );
+      }
+    }(window.location));
+  </script>
   <link rel="stylesheet" href="https://cdn.jsdelivr.net/gh/AOSSIE-Org/SocialShareButton/src/social-share-button.css"
     crossorigin="anonymous" />
   <script defer src="https://cdn.jsdelivr.net/gh/AOSSIE-Org/SocialShareButton/src/social-share-button.js"
diff --git a/public/404.html b/public/404.html
new file mode 100644
index 0000000..b1d0241
--- /dev/null
+++ b/public/404.html
@@ -0,0 +1,28 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8" />
+  <title>OrgExplorer</title>
+  <script>
+    // Single Page Apps for GitHub Pages
+    // https://github.com/rafgraph/spa-github-pages
+    //
+    // When GitHub Pages serves a 404 for any path that isn't a real file,
+    // this page intercepts the request, encodes the full URL as a query
+    // string parameter, and redirects back to the root index.html so that
+    // React Router can handle the route client-side.
+    var pathSegmentsToKeep = 0; // set to 1 if the app is served under a subpath (e.g. /repo-name/)
+
+    var l = window.location;
+    l.replace(
+      l.protocol + '//' + l.hostname + (l.port ? ':' + l.port : '') +
+      l.pathname.split('/').slice(0, 1 + pathSegmentsToKeep).join('/') + '/?/' +
+      l.pathname.slice(1).split('/').slice(pathSegmentsToKeep).join('/').replace(/&/g, '~and~') +
+      (l.search ? '&' + l.search.slice(1).replace(/&/g, '~and~') : '') +
+      l.hash
+    );
+  </script>
+</head>
+<body>
+</body>
+</html>
