Zum Inhalt springen
Zauberjournal Docs

Lokale Entwicklung

Voraussetzungen

Abschnitt betitelt „Voraussetzungen“
  • Node.js 22+
  • Ein KI-API-Key (optional)

Setup

Abschnitt betitelt „Setup“
Terminal-Fenster
# Repository klonen
git clone <repo-url> zauberjournal
cd zauberjournal


# Umgebungsvariablen konfigurieren
cp .env.example .env
# .env bearbeiten: JWT_SECRET und optional KIMI_API_KEY eintragen

Backend starten

Abschnitt betitelt „Backend starten“
Terminal-Fenster
cd backend
npm install
npm run dev          # → http://localhost:3001

Frontend starten (neues Terminal)

Abschnitt betitelt „Frontend starten (neues Terminal)“
Terminal-Fenster
cd frontend
npm install
npm run dev          # → http://localhost:5173

Landing Page / Docs starten

Abschnitt betitelt „Landing Page / Docs starten“
Terminal-Fenster
cd landingpage
npm install
npm run dev          # → http://localhost:4321/zauberjournal/

PWA / Offline-Modus testen

Abschnitt betitelt „PWA / Offline-Modus testen“

Der Service Worker wird nur im Production Build vollständig generiert. So testest du den Offline-Modus lokal:

Terminal-Fenster
# Backend starten
cd backend && node src/server.js &


# Frontend bauen + Preview-Server starten
cd frontend && npm run preview:offline   # → http://localhost:4173
  1. Seite einmal bei aktivem Netzwerk laden (Service Worker installiert sich)
  2. In Chrome DevTools → Application → Service Workers prüfen, ob der SW aktiv ist
  3. Netzwerk trennen (DevTools → Network → Offline) und Seite neu laden
  4. Die App sollte vollständig funktionieren (Einkaufsliste, Wochenplan)