Fix Pages base for user.github.io repos; pass GITHUB_REPOSITORY in CI

Co-authored-by: Cursor <cursoragent@cursor.com>

Author: monapdx

.github/workflows/deploy-pages.yml

@@ -25,6 +25,9 @@ jobs:
           cache: npm
       - run: npm ci
       - run: npm run build
+        env:
+          # Ensure Vite sees the repo id (project Pages need /<repo>/ base).
+          GITHUB_REPOSITORY: ${{ github.repository }}
       # No configure-pages: it calls the Pages API and 404s until Settings → Pages
       # uses "GitHub Actions". Static Vite output does not need that action anyway.
       - uses: actions/upload-pages-artifact@v3

README.md

@@ -26,6 +26,12 @@ This repo includes a workflow that builds with Vite and publishes the `dist` fol
 
 To rebuild manually, use **Actions → Deploy to GitHub Pages → Run workflow**.
 
+### Site looks blank (white page)
+
+1. **Project site URL** — For a normal repo named `zine-maker`, the app lives at `https://<user>.github.io/zine-maker/` (with the repo slug in the path). Opening only `https://<user>.github.io/` will not load this app.
+2. **User/org Pages repo** — If the repo is named `<user>.github.io` or `<org>.github.io`, the site is served from the domain root (`/`). The build sets Vite `base` to `/` automatically in that case.
+3. In the browser, open DevTools → **Network**, reload, and check whether `*.js` / `*.css` return **404**. Wrong `base` usually shows every asset as 404.
+
 ### Custom base path (optional)
 
 Override the asset prefix when building:

vite.config.ts

@@ -1,10 +1,23 @@
 import { defineConfig } from 'vite'
 import react from '@vitejs/plugin-react'
 
-// GitHub Pages project sites are served from /<repo>/; Actions sets GITHUB_REPOSITORY=owner/repo.
-const repo = process.env.GITHUB_REPOSITORY?.split('/')[1]
-const base =
-  process.env.VITE_BASE_PATH ?? (repo ? `/${repo}/` : '/')
+// GitHub Pages: project sites use /<repo>/; user/org sites use the special <owner>.github.io repo at /.
+function resolveBase(): string {
+  if (process.env.VITE_BASE_PATH) return process.env.VITE_BASE_PATH
+  const full = process.env.GITHUB_REPOSITORY
+  if (!full?.includes('/')) return '/'
+  const [owner, repo] = full.split('/')
+  if (
+    owner &&
+    repo &&
+    repo.toLowerCase() === `${owner.toLowerCase()}.github.io`
+  ) {
+    return '/'
+  }
+  return `/${repo}/`
+}
+
+const base = resolveBase()
 
 // https://vite.dev/config/
 export default defineConfig({