chore(ci): enable github pages deployment

Author: skulidropek

.github/workflows/jekyll-gh-pages.yml

@@ -1,44 +1,43 @@
-# Sample workflow for building and deploying a Jekyll site to GitHub Pages
-name: Deploy Jekyll with GitHub Pages dependencies preinstalled
+name: Deploy Vite app to GitHub Pages
 
 on:
-  # Runs on pushes targeting the default branch
   push:
     branches: ["main"]
-
-  # Allows you to run this workflow manually from the Actions tab
   workflow_dispatch:
 
-# Sets permissions of the GITHUB_TOKEN to allow deployment to GitHub Pages
 permissions:
   contents: read
   pages: write
   id-token: write
 
-# Allow only one concurrent deployment, skipping runs queued between the run in-progress and latest queued.
-# However, do NOT cancel in-progress runs as we want to allow these production deployments to complete.
 concurrency:
   group: "pages"
   cancel-in-progress: false
 
 jobs:
-  # Build job
   build:
     runs-on: ubuntu-latest
     steps:
       - name: Checkout
         uses: actions/checkout@v4
       - name: Setup Pages
         uses: actions/configure-pages@v5
-      - name: Build with Jekyll
-        uses: actions/jekyll-build-pages@v1
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
         with:
-          source: ./
-          destination: ./_site
+          node-version: 22
+          cache: npm
+      - name: Install dependencies
+        run: npm ci
+      - name: Build static site
+        run: npm run build -- --mode github-pages
+      - name: Disable Jekyll on Pages
+        run: touch dist/.nojekyll
       - name: Upload artifact
         uses: actions/upload-pages-artifact@v3
+        with:
+          path: dist
 
-  # Deployment job
   deploy:
     environment:
       name: github-pages

vite.config.ts

@@ -24,7 +24,23 @@ const buildPlugins = (mode: string): PluginOption[] => {
   )
 }
 
+type DeployBase = '/' | `/${string}/`
+const GITHUB_PAGES_BASE: DeployBase = '/gitmeta/'
+
+// CHANGE: выбираем префикс путей сборки в зависимости от среды деплоя
+// WHY: GitHub Pages публикует проект под /gitmeta/, поэтому абсолютные ссылки должны быть префиксованы
+// QUOTE(ТЗ): "а как сделать что бы всё работало в github pages?"
+// REF: user request about GitHub Pages assets returning 404
+// SOURCE: https://vite.dev/guide/static-deploy.html#github-pages
+// FORMAT THEOREM: ∀mode ∈ {"github-pages", dev}: mode = "github-pages" → base = "/gitmeta/"
+// PURITY: CORE
+// INVARIANT: mode === "github-pages" ⇒ resolvedBase === "/gitmeta/"
+// COMPLEXITY: O(1)/O(1)
+const resolveBase = (mode: string): DeployBase =>
+  mode === 'github-pages' ? GITHUB_PAGES_BASE : '/'
+
 // https://vite.dev/config/
 export default defineConfig(({ mode }) => ({
+  base: resolveBase(mode),
   plugins: buildPlugins(mode),
 }))