fix(docs): add GITHUB_REPOSITORY fallback to build-docs.js

build-docs.js was defaulting to localhost:4321 when SITE_URL wasn't
set, bypassing the GITHUB_REPOSITORY fallback in site-url.js. This
caused CSS paths to be missing the /BMAD-METHOD/ base path on fork
deployments.

Now both files have the same URL resolution logic:
SITE_URL -> GITHUB_REPOSITORY -> localhost:4321

Author: alexeyv

tools/build-docs.js

@@ -21,8 +21,16 @@ const archiver = require('archiver');
 const PROJECT_ROOT = path.dirname(__dirname);
 const BUILD_DIR = path.join(PROJECT_ROOT, 'build');
 
-// For local builds, use localhost. Production URL set via SITE_URL env var in CI.
-const SITE_URL = process.env.SITE_URL || 'http://localhost:4321';
+// Same logic as website/src/lib/site-url.js - duplicated to avoid CJS/ESM complexity
+function getSiteUrl() {
+  if (process.env.SITE_URL) return process.env.SITE_URL;
+  if (process.env.GITHUB_REPOSITORY) {
+    const [owner, repo] = process.env.GITHUB_REPOSITORY.split('/');
+    return `https://${owner}.github.io/${repo}`;
+  }
+  return 'http://localhost:4321';
+}
+const SITE_URL = getSiteUrl();
 const REPO_URL = 'https://github.com/bmad-code-org/BMAD-METHOD';
 
 const LLM_MAX_CHARS = 600_000;

website/src/lib/site-url.js

@@ -2,7 +2,7 @@
  * Resolve the site's base URL using cascading environment defaults.
  *
  * Preference order: use SITE_URL if set; otherwise derive a GitHub Pages URL from GITHUB_REPOSITORY; otherwise use the local development URL.
- * @returns {string} The resolved site URL (SITE_URL override, or `https://{owner}.github.io/{repo}`, or `http://localhost:3000`).
+ * @returns {string} The resolved site URL (SITE_URL override, or `https://{owner}.github.io/{repo}`, or `http://localhost:4321`).
  */
 export function getSiteUrl() {
   // Explicit override (works in both local and GitHub Actions)
@@ -20,6 +20,6 @@ export function getSiteUrl() {
     return `https://${owner}.github.io/${repo}`;
   }
 
-  // Local development: use dev server
-  return 'http://localhost:3000';
+  // Local development: use Astro dev server
+  return 'http://localhost:4321';
 }