Bombadil — Event-Quiz App

Themen-agnostische, offline-fähige Quiz-App für Veranstaltungen. Beamer-optimiert, bis zu 4 Teams, quizmaster-gesteuert.

Schnellstart

Für Entwickler

npm install
npm run dev

Für Moderatoren (Quiz-Paket)

1. Den build/-Ordner auf den Quiz-Laptop kopieren
2. start.bat (Windows) oder start.sh (Mac/Linux) doppelklicken
3. Browser öffnet sich automatisch

Voraussetzung: Python muss installiert sein (für den lokalen Webserver).

Neues Quiz erstellen

1. data/_template.json kopieren und umbenennen (z.B. mein-quiz-runde1.json)
2. Die JSON-Datei bearbeiten:
   • meta.title — Titel des Quiz
   • meta.subtitle — Datum oder Anlass
   • meta.theme — Theme-Name (ocm, default, oder eigenes)
   • categories — Kategorien mit Fragen füllen
3. Bilder in assets/img/ ablegen
4. Dateiname in data/manifest.json eintragen
5. Fertig!

Fragetypen

Beispiel-Frage (solution)

{
  "type": "solution",
  "difficulty": 2,
  "media": { "type": "image", "src": "assets/img/c64.jpg" },
  "answer": { "text": "Commodore 64", "detail": "1982, 17 Mio. verkauft" }
}

Eigenes Theme erstellen

1. Neuen Ordner in themes/ anlegen (z.B. themes/firmenquiz/)
2. theme.json erstellen mit Farben, Logo, Font
3. Logo als SVG/PNG in den Ordner legen
4. In der Quiz-JSON: "meta": { "theme": "firmenquiz" }

Siehe themes/ocm/theme.json als Vorlage.

Tastatur-Steuerung

Scoring

Konfigurierbar pro Runde in der JSON:

"scoring": {
  "mode": "formula",
  "baseScore": 128,
  "multiplier": 1,
  "display": "decimal"
}

• mode: formula (baseScore × Schwierigkeit × Multiplier) oder fixed (jede Frage hat eigenen points-Wert)
• display: decimal, binary, octal, hex

Tech-Stack

Svelte 5 · SvelteKit (SSG) · TypeScript · Vite · Tailwind CSS · Zod