fix: set base /ts-stack/ for GitHub Pages subdirectory deployment

Without base, Vite emits /assets/... paths which 404 on GitHub Pages
(served under /ts-stack/). Also fixes React Router basename so NavLink
renders correct hrefs, iframe asyncapi src, pagefind load path, and
Footer plain <a> → Link.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

Author: sirdeggen

docs-site/src/components/Footer.tsx

@@ -1,3 +1,4 @@
+import { Link } from 'react-router-dom'
 import styles from './Footer.module.css'
 
 export default function Footer() {
@@ -10,8 +11,8 @@ export default function Footer() {
         </span>
         <nav className={styles.links} aria-label="Footer navigation">
           <a href="https://github.com/bsv-blockchain/ts-stack">GitHub</a>
-          <a href="/about/contributing/">Contributing</a>
-          <a href="/about/versioning/">Versioning</a>
+          <Link to="/about/contributing/">Contributing</Link>
+          <Link to="/about/versioning/">Versioning</Link>
         </nav>
       </div>
     </footer>

docs-site/src/components/SearchBox.tsx

@@ -21,7 +21,8 @@ let pagefindPromise: Promise<Pagefind> | null = null
 
 function loadPagefind(): Promise<Pagefind> {
   if (!pagefindPromise) {
-    pagefindPromise = import(/* @vite-ignore */ '/_pagefind/pagefind.js') as Promise<Pagefind>
+    const base = import.meta.env.BASE_URL.replace(/\/$/, '')
+    pagefindPromise = import(/* @vite-ignore */ `${base}/_pagefind/pagefind.js`) as Promise<Pagefind>
   }
   return pagefindPromise
 }

docs-site/src/main.tsx

@@ -5,4 +5,4 @@ import './styles/reset.css'
 import './styles/code.css'
 import './styles/callout.css'
 
-export const createRoot = ViteReactSSG({ routes })
+export const createRoot = ViteReactSSG({ routes, basename: import.meta.env.BASE_URL })

docs-site/vite.config.ts

@@ -50,7 +50,10 @@ const stripAudioComments: import('vite').Plugin = {
   },
 }
 
+const BASE = '/ts-stack/'
+
 export default defineConfig({
+  base: BASE,
   plugins: [
     stripAudioComments,
     {
@@ -63,7 +66,7 @@ export default defineConfig({
               type: 'element',
               tagName: 'iframe',
               properties: {
-                src: `/assets/asyncapi/${node.slug}/index.html`,
+                src: `${BASE}assets/asyncapi/${node.slug}/index.html`,
                 style: 'width: 100%; min-height: 900px; border: none; background: #011627; border-radius: 8px;',
                 title: `AsyncAPI Specification (${node.slug})`,
                 loading: 'lazy',