Deploy to GH pages

Author: andriilazebnyi

.github/workflows/deploy.yml

@@ -0,0 +1,54 @@
+name: Deploy to GitHub Pages
+
+on:
+  push:
+    branches: [ main ]
+  workflow_dispatch: {}
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: pages
+  cancel-in-progress: true
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Node
+        uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          cache: 'npm'
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Build
+        env:
+          # Serve under /<repo>/ for project Pages
+          BASE_PATH: "/${{ github.event.repository.name }}/"
+        run: npm run build
+
+      - name: Upload Pages artifact
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: dist
+
+  deploy:
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4
+

README.local.md

@@ -8,6 +8,16 @@ Quickstart
 - Dev: `npm run dev` then open the printed URL.
 - Build: `npm run build` and `npm run preview`.
 
+Deploy to GitHub Pages
+- Push this repo to GitHub (default branch `main`).
+- GitHub Actions workflow `.github/workflows/deploy.yml` builds and publishes to Pages.
+- Enable Pages: Repo Settings → Pages → Build and deployment → Source: GitHub Actions.
+- Your site will be at `https://<user>.github.io/<repo>/`.
+
+Notes on hosting
+- Vite `base` is set from `BASE_PATH`. The workflow sets it to `/<repo>/` so assets resolve correctly on Pages.
+- WebGPU does not require COOP/COEP. If you later use WASM multithreading, GitHub Pages cannot set COOP/COEP headers.
+
 Notes
 - First load downloads model artifacts (hundreds of MB). They are cached for subsequent runs.
 - Model menu defaults to tiny options (1–2B params) for smoother UX. Larger models may be slow or fail on low‑VRAM GPUs.
@@ -23,4 +33,3 @@ Project Structure
 - `src/ui/model/models.ts`: Model presets. Adjust as needed.
 - `src/ui/chat/*`: Chat state and UI.
 - `src/utils/useIndexedDB.ts`: Minimal IndexedDB helper used to persist chats per model.
-

package-lock.json

@@ -15,9 +15,10 @@
     "react-dom": "^18.3.1"
   },
   "devDependencies": {
-    "@vitejs/plugin-react": "^4.3.1",
+    "@types/node": "^24.3.1",
     "@types/react": "^18.3.5",
     "@types/react-dom": "^18.3.0",
+    "@vitejs/plugin-react": "^4.3.1",
     "typescript": "^5.5.4",
     "vite": "^5.4.0"
   }

package.json

@@ -3,10 +3,11 @@ import react from '@vitejs/plugin-react';
 
 // https://vitejs.dev/config/
 export default defineConfig({
+  // Allow deploying under a subpath (e.g., GitHub Pages /<repo>/)
+  base: process.env.BASE_PATH ?? '/',
   plugins: [react()],
   server: {
     port: 5173,
     strictPort: true
   }
 });
-