zahlzerlegung/README.md

Zahlzerlegung

Eine kleine Lern-App für Grundschulkinder, die Zahlzerlegungen von 4 bis 10 üben.

Das Kind sieht eine Zielzahl (z. B. 7) und eine vorgegebene Zerlegungszahl (z. B. 2) und tippt aus mehreren Antwortmöglichkeiten die passende Ergänzung an (5). Bei jeder richtigen Antwort steigt eine Rakete weiter nach oben — am Boden los, dann zum Luftballon, in die Wolken, zum Mond, zu den Sternen und schließlich ins Regenbogenland. Wer in der vorgegebenen Zeit das Regenbogenland erreicht, hat die Runde gewonnen.

Die App ist absichtlich textfrei und funktioniert komplett über große, gut tippbare Symbole — auch für Kinder, die noch nicht lesen können. Falsche Antworten werden nicht bestraft, das Spiel geht direkt mit der nächsten Aufgabe weiter.

Für jede Zielzahl wird sichtbar, wie weit das Kind in den letzten fünf Runden gekommen ist. So bleibt der Fortschritt motivierend und individuell — verglichen wird das Kind nur mit sich selbst.

Funktionsumfang

• Zielzahlen 4 bis 10, einzeln auswählbar
• Rundenzeit einstellbar (30 / 60 / 90 / 120 Sekunden)
• Sound an/aus über Lautsprecher-Knopf
• Highscore-Anzeige je Zielzahl mit Krone für die beste Runde
• Läuft offline und kann als App installiert werden (PWA)

Installation und Start

Voraussetzung: Node.js (Version 20 oder neuer) und npm.

git clone <repo-url> zahlzerlegung
cd zahlzerlegung
npm install

Im Browser starten (Entwicklung)

npm run dev

Dann http://localhost:5173/ öffnen — am besten auf einem Tablet oder im Browser mit aktivierter Touch-Emulation.

Als eigenständige App installieren

npm run build
npm run preview

Beim Aufruf der Adresse im Browser auf dem Endgerät erscheint ein Hinweis "Zur Startseite hinzufügen" / "Installieren". Nach der Installation läuft die App ohne Browserleiste und auch ohne Internetverbindung.

Für eine dauerhafte Bereitstellung kann der Inhalt von dist/ (nach npm run build) auf jeden statischen Webserver kopiert werden.