fix: add basePath for GitHub Pages deployment

The static site was deployed to /innate-executable/ but all assets
referenced absolute paths like /_next/static/... which 404'd on
GitHub Pages. Added:
- basePath/assetPrefix in next.config.ts via NEXT_BASE_PATH env var
- getBasePath() helper in tutorial-scanner for fetch() calls
- NEXT_PUBLIC_BASE_PATH in GitHub Actions for client-side access
- trailingSlash for clean GitHub Pages URL resolution

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>

Author: qdriven

.github/workflows/deploy-static.yml

@@ -38,6 +38,9 @@ jobs:
 
       - name: Build static site
         working-directory: playground/apps/desktop
+        env:
+          NEXT_BASE_PATH: /innate-executable
+          NEXT_PUBLIC_BASE_PATH: /innate-executable
         run: pnpm build
 
       - name: Upload artifact

playground/apps/desktop/next.config.ts

@@ -1,5 +1,7 @@
 import type { NextConfig } from "next";
 
+const basePath = process.env.NEXT_BASE_PATH || "";
+
 const nextConfig: NextConfig = {
   output: "export",
   distDir: "out",
@@ -10,6 +12,10 @@ const nextConfig: NextConfig = {
     ignoreBuildErrors: true,
   },
   transpilePackages: ["@innate/ui", "@innate/utils"],
+  trailingSlash: true,
+  ...(basePath
+    ? { basePath, assetPrefix: basePath }
+    : {}),
 };
 
 export default nextConfig;

playground/apps/desktop/public/skills-manifest.json

@@ -1,5 +1,5 @@
 {
-  "generatedAt": "2026-05-04T03:49:20.647Z",
+  "generatedAt": "2026-05-04T04:23:43.810Z",
   "count": 14,
   "skills": [
     {

playground/apps/desktop/src/lib/tutorial-scanner.ts

@@ -45,6 +45,16 @@ interface SkillsManifest {
   courses: CourseFile[];
 }
 
+// ─── Base Path Helper ────────────────────────────────────
+
+function getBasePath(): string {
+  if (typeof window !== "undefined") {
+    const base = document.querySelector("base");
+    if (base?.getAttribute("href")) return base.getAttribute("href")!.replace(/\/$/, "");
+  }
+  return process.env.NEXT_PUBLIC_BASE_PATH || "";
+}
+
 // ─── Manifest Loader ─────────────────────────────────────
 
 let _cachedManifest: SkillsManifest | null = null;
@@ -53,7 +63,7 @@ async function loadManifest(): Promise<SkillsManifest> {
   if (_cachedManifest) return _cachedManifest;
 
   try {
-    const response = await fetch("/skills-manifest.json");
+    const response = await fetch(`${getBasePath()}/skills-manifest.json`);
     if (response.ok) {
       const manifest: SkillsManifest = await response.json();
       _cachedManifest = manifest;
@@ -153,7 +163,7 @@ export async function loadSkillContent(
   const skill = manifest.skills.find((s) => s.slug === slug);
   if (skill?.localPath) {
     try {
-      const response = await fetch(skill.localPath);
+      const response = await fetch(`${getBasePath()}${skill.localPath}`);
       if (response.ok) {
         const content = await response.text();
         return { content, path: skill.localPath };
@@ -166,7 +176,7 @@ export async function loadSkillContent(
   // Fallback: try common path patterns directly
   for (const ext of [".mdx", ".md"]) {
     try {
-      const response = await fetch(`/skills/${slug}${ext}`);
+      const response = await fetch(`${getBasePath()}/skills/${slug}${ext}`);
       if (response.ok) {
         const content = await response.text();
         return { content, path: `/skills/${slug}${ext}` };