deploy: serve explorer at Pages root, drop playground

The playground keeps deploying to truapi-playground.dot, so remove it from the
GitHub Pages build. The explorer now lives at the site root (base /truapi/),
with the Rust API docs kept under /cargo_doc/. Serve a copy of the SPA index as
404.html so React Router resolves deep links on refresh, replacing the old
?p= replay shim and the playground-404 injection.

Author: pgherveou

.github/workflows/deploy-docs.yml

@@ -42,32 +42,26 @@ jobs:
       - name: Build Rust API docs (HTML)
         run: cargo doc -p truapi --no-deps
 
-      - name: Install playground dependencies
-        working-directory: playground
-        run: yarn install --frozen-lockfile
-
-      - name: Build playground (static export)
-        working-directory: playground
-        env:
-          NEXT_PUBLIC_BASE_PATH: /truapi
-        run: yarn build
-
       - name: Install explorer dependencies
         working-directory: explorer
         run: npm ci
 
       - name: Build explorer (static export)
         working-directory: explorer
         env:
-          EXPLORER_BASE_PATH: /truapi/explorer/
+          EXPLORER_BASE_PATH: /truapi/
         run: npm run build
 
       - name: Assemble GitHub Pages site
         run: |
           rm -rf site
           mkdir -p site
-          # Playground at root.
-          cp -R playground/out/. site/
+          # Explorer SPA at the site root.
+          cp -R explorer/dist/. site/
+          # GitHub Pages serves the site-root 404.html for every missing path.
+          # Serving a copy of the SPA index lets React Router resolve explorer
+          # deep links (e.g. /truapi/v/main/method/foo) on a fresh load.
+          cp site/index.html site/404.html
           # truapi crate's cargo doc mounted at /cargo_doc/ with the crate's
           # pages flattened (no /truapi/ prefix). rustdoc HTMLs reference
           # static.files via `../../../static.files/`, which from
@@ -76,18 +70,8 @@ jobs:
           mkdir -p site/cargo_doc
           cp -RL target/doc/truapi/. site/cargo_doc/
           cp -RL target/doc/static.files site/static.files
-          # Explorer mounted at /explorer/ (its Vite `base` path).
-          mkdir -p site/explorer
-          cp -R explorer/dist/. site/explorer/
           touch site/.nojekyll
 
-      - name: Add explorer SPA fallback to root 404
-        # GitHub Pages serves only the site-root 404.html (the playground's
-        # Next.js not-found) for every missing path, including the explorer's
-        # client routes. Inject a shim that replays /explorer/* deep links into
-        # the explorer index; other paths keep the playground 404.
-        run: node scripts/inject-explorer-404.mjs site/404.html
-
       - name: Upload Pages artifact
         uses: actions/upload-pages-artifact@v3
         with:

CLAUDE.md

@@ -100,4 +100,4 @@ Alternatively, with a deployed Polkadot Desktop Host installed, navigate to
 ## Deployment
 
 Pushes to `main` trigger `.github/workflows/deploy-playground.yml`, which builds `playground/` and publishes the static export to `truapi-playground.dot` via `bulletin-deploy`.
-Pushes to `main` also trigger `.github/workflows/deploy-docs.yml`, which publishes the Rust API docs to GitHub Pages.
+Pushes to `main` also trigger `.github/workflows/deploy-docs.yml`, which publishes the explorer (at the Pages root) and the Rust API docs (under `/cargo_doc/`) to GitHub Pages.

explorer/public/404.html

@@ -4,22 +4,9 @@ import { BrowserRouter } from "react-router-dom";
 import "./index.css";
 import App from "./App";
 
-// Mount path, e.g. "/explorer" or "/truapi/explorer", derived from Vite's base.
+// Mount path, e.g. "/truapi", derived from Vite's base.
 const basename = import.meta.env.BASE_URL.replace(/\/$/, "");
 
-// Replay a `?p=/<path>` query produced by the GH Pages 404 shim before the
-// router mounts.
-const params = new URLSearchParams(window.location.search);
-const replay = params.get("p");
-if (replay) {
-  const rest = new URLSearchParams(window.location.search);
-  rest.delete("p");
-  const tail = rest.toString();
-  const next =
-    basename + replay + (tail ? `?${tail}` : "") + window.location.hash;
-  window.history.replaceState(null, "", next);
-}
-
 createRoot(document.getElementById("root")!).render(
   <StrictMode>
     <BrowserRouter basename={basename}>