Files
werkbaum/.github/workflows/pages.yml
T
mhoennigandClaude Opus 4.8 0f27bab905 frontend/ci: Build-Hinweis in die App-Quelle, env-gesteuert; Prod-Build ohne
Der Latest-Build-Hinweis wandert vom Workflow-sed in die App (app.js,
mountBuildBadge), damit ihn auch der Dev-Server zeigt — ein Post-Build-sed
erreicht den Dev-Server nicht. Logik umgekehrt: Hinweis ist der Normalfall,
nur die produktive Installation schaltet ihn ab.

Drei Zustaende ueber Vite-Env VITE_BUILD_BADGE (Auswertung in app.js):
- Dev-Server (import.meta.env.DEV) -> 🔧 "Vorschau/lokaler Entwicklungsstand"
- Default `npm run build` (Env ungesetzt) -> 🚧 "latest build"; der Pages-
  Deploy nutzt den Default und traegt den Hinweis dadurch automatisch (die
  sed-Injektion entfaellt).
- `npm run build:prod` (Vite-Modus prod, .env.prod: VITE_BUILD_BADGE=none)
  -> KEIN Badge; esbuild eliminiert den Zweig als toten Code.

Verifiziert zur Laufzeit (Dev + `vite preview` auf beiden Builds): 🔧 im Dev,
🚧 im Default-Build, gar nichts im Prod-Build (Titel sauber "Werkbaum").
34 Vitest-Tests gruen, Workflow-YAML/Shell gueltig.

Doku: D16 fortgeschrieben (quellbasiert/env statt sed, Begruendung); README
(de/en) mit Prod-Build-Anleitung inkl. LICENSE-/Versions-Caveats; frontend/
CLAUDE.md; .claude/launch.json bekommt einen frontend-dist-Preview (vite
preview, Port 8138) zum Verifizieren gebauter Dateien.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-07-22 05:56:59 +02:00

106 lines
4.3 KiB
YAML

name: Deploy to GitHub Pages
# Veröffentlicht den Frontend-Editor als statische Seite auf GitHub Pages.
# Einmalige Voraussetzung: Repo-Settings → Pages → Source = "GitHub Actions"
# (Repo muss dafür öffentlich sein). Siehe README.md, Abschnitt „Deployment".
on:
push:
branches: [main]
workflow_dispatch:
# Nur Leserechte auf den Code, plus die für die Pages-Deployment-Actions
# nötigen Sonderrechte: pages (Deployment schreiben) und id-token (OIDC-Token,
# das actions/deploy-pages zur Authentifizierung braucht).
permissions:
contents: read
pages: write
id-token: write
# Läuft immer nur ein Deployment gleichzeitig; neue Pushes warten, laufende
# werden nicht abgebrochen (cancel-in-progress: false), damit ein Deploy nicht
# mittendrin unterbrochen wird.
concurrency:
group: pages
cancel-in-progress: false
jobs:
build:
runs-on: ubuntu-latest
steps:
- name: Checkout
uses: actions/checkout@v4
with:
# Volle Historie: die Micro-Version wird aus der Commit-Anzahl
# abgeleitet (Standard wäre ein flacher Klon mit nur einem Commit).
fetch-depth: 0
# Node einrichten und den Vite-Build fahren (D19): der Editor liegt jetzt
# als ES-Module unter frontend/src/, Vite bündelt sie zu EINER
# self-contained frontend/dist/index.html (JS+CSS+Favicon inline). Tests
# laufen zuerst — schlägt Vitest fehl, wird nicht deployt.
# Hinweis: der Default-`npm run build` trägt den 🚧-„latest build"-Hinweis
# hinter dem Titel automatisch in sich (app.js/mountBuildBadge, D16) — der
# Pages-Deploy ist bewusst der latest build. Nur `build:prod` ließe ihn weg.
- name: Node einrichten
uses: actions/setup-node@v4
with:
node-version: 20
cache: npm
cache-dependency-path: frontend/package-lock.json
- name: Abhängigkeiten installieren
run: npm ci --prefix frontend
- name: Tests
run: npm test --prefix frontend
- name: Build (Vite)
run: npm run build --prefix frontend
# Site-Ordner zusammenstellen: die gebaute dist/index.html an die
# Wurzel-URL, dazu LICENSE für den MIT-Link im Footer. Das Favicon ist im
# Build bereits als data:-URI inline (kein docs/brand-Kopieren mehr nötig).
# Im Footer werden gesetzt:
# - die Versionsnummer: Major.Minor aus der VERSION-Datei (per
# Bump-Commit gepflegt), die Micro-Stelle aus der Anzahl der Commits
# seit dem letzten VERSION-Bump — steigt also je Commit und beginnt
# nach einem Bump wieder bei 0 (z. B. 1.0.7).
# - der Link der Versionsnummer: zeigt exakt auf den deployten Commit
# (…/commit/<sha>). „Werkbaum" selbst verlinkt weiter die Repo-
# Startseite. Braucht die volle Historie (fetch-depth: 0).
# Der ../LICENSE-Link ist eine Laufzeit-Verknüpfung (kein Vite-Asset) und
# zeigt von der Wurzel-URL aus sonst über die Site hinaus — daher hier auf
# der Kopie geradegezogen.
- name: Site zusammenstellen
run: |
MAJORMINOR="$(tr -d '[:space:]' < VERSION)"
BASE="$(git log -1 --format=%H -- VERSION)" # letzter Bump-Commit
[ -z "$BASE" ] && BASE="$(git rev-list --max-parents=0 HEAD | tail -1)"
MICRO="$(git rev-list --count "${BASE}..HEAD")" # Commits seit dem Bump
BUILD_VERSION="${MAJORMINOR}.${MICRO}"
COMMIT_URL="https://github.com/mhoennig/werkbaum/commit/$(git rev-parse HEAD)"
echo "Footer-Version: ${BUILD_VERSION} -> ${COMMIT_URL}"
mkdir -p site
sed -e 's#\.\./LICENSE#LICENSE#g' \
-e "s#\(<a class=\"ver\" href=\"\)[^\"]*#\1${COMMIT_URL}#" \
-e "s#\(<a class=\"ver\"[^>]*>\)[0-9.]\+</a>#\1${BUILD_VERSION}</a>#" \
frontend/dist/index.html > site/index.html
cp LICENSE site/LICENSE
- name: Pages-Konfiguration
uses: actions/configure-pages@v5
- name: Artefakt hochladen
uses: actions/upload-pages-artifact@v3
with:
path: site
deploy:
needs: build
runs-on: ubuntu-latest
environment:
name: github-pages
url: ${{ steps.deployment.outputs.page_url }}
steps:
- name: Auf GitHub Pages deployen
id: deployment
uses: actions/deploy-pages@v4