Skip to content

bitbreaker/ultimative-trainer

Repository files navigation

🧠 DER ULTIMATIVE TRAINER

Ein retro-inspirierter Lerntrainer im DOS-Stil – komplett per Tastatur steuerbar.

© 2026 Jörn Priebe. All rights reserved.

Status Tech UI License: MIT


✨ Features

  • 🎮 Komplett per Tastatur steuerbar

    • ↑ ↓ Navigation
    • Enter auswählen / prüfen
    • ESC zurück
  • 🧠 Adaptive Lernlogik

    • Schwierige Fragen kommen häufiger
    • basierend auf Fehlerquote & Historie
  • 📊 Detaillierte Statistik

    • gesehen / richtig / falsch
    • Erfolgsquote pro Frage
    • Top schwierigste Fragen
  • 🎨 Retro DOS UI

    • Monospace Font
    • ASCII-Rahmen
    • Blau / Weiß / Gelb Farbpalette
  • Offline-fähig

    • läuft komplett im Browser
    • ideal für Raspberry Pi

🧱 Tech Stack

  • React
  • TypeScript
  • Vite
  • LocalStorage (für Persistenz)

📂 Projektstruktur

src/
  components/
  hooks/
  lib/
  types/
  data/
    sbf-see.json

📚 Datenformat

{
  "id": "sbf-see",
  "title": "SBF See",
  "mode": "multiple-choice",
  "questions": [
    {
      "id": "q1",
      "question": "...",
      "options": [
        { "id": "a", "text": "..." }
      ],
      "correctOptionIds": ["a"]
    }
  ]
}

🧠 Lernlogik

Fragen werden dynamisch priorisiert basierend auf:

  • ❌ Fehlerquote
  • 🔁 Anzahl falscher Antworten
  • 👁️ Häufigkeit

👉 Ziel: Fokus auf schwache Themen


🚀 Getting Started

npm install
npm run dev

Dann im Browser öffnen:

http://localhost:5173

⌨️ Steuerung

Taste Funktion
↑ ↓ Navigation
Enter Auswahl / prüfen
ESC zurück

🛠 Roadmap

  • „Nur schwache Fragen“-Modus
  • Vokabeltrainer
  • Bildfragen
  • Fortschritt zurücksetzen
  • Spaced Repetition (Anki-Style)

📦 Deployment

Build:

npm run build

Danach statisch hostbar (z. B. Raspberry Pi, Nginx, GitHub Pages).


🧑‍💻 Autor

Jörn Priebe (c) 2026


⚡ Idee

Minimalistisch. Schnell. Fokussiert.

👉 Lernen ohne Ablenkung.


🧪 Status

🚧 Aktive Entwicklung – Feedback willkommen

License

The application source code in this repository is licensed under the MIT License. See LICENSE.

Official SBF See question text, derived question data, and extracted media assets are not covered by the MIT License. See NOTICE.md for details.

Packages

 
 
 

Contributors

Languages