Star Hunter

Eine Reward-Tracking-App für Kinder und Eltern / A reward tracking app for children and parents

---

Deutsch

Beschreibung

Star Hunter ist eine Single-Page-Anwendung, die entwickelt wurde, um Kindern und Eltern zu helfen, Belohnungspunkte zu sammeln und zu verwalten. Jeder erledigte Aufgabe wird durch einen Stern repräsentiert, während unerledigte Aufgaben als schwarze Löcher dargestellt werden.

Alle Daten werden nur auf dem jeweiligen Browser gespeichert! Wenn kein Passwort gesetzt wurde, ist das Passwort einfach leerzulassen.

Hauptfunktionen

• Multi-Kind-Unterstützung: Verwalten Sie beliebig viele Kinder mit individuellen Aufgaben und Einstellungen
• Tägliche Aufgabenliste: Konfigurierbare Aufgaben für jedes Kind mit Standardaufgaben:
  • Hausaufgaben gut gemacht
  • aufgeräumt
  • spezial 1
  • spezial 2
  • gelesen
• Belohnungssystem:
  • 1 Stern = +5 Minuten Spielzeit
  • 1 Schwarzes Loch = -5 Minuten Spielzeit
  • Manuelles Reduzieren und Zeitgutschrift möglich
  • Konfigurierbarer negativer Kredit
• Ad-hoc-Belohnungen: Manuelles Hinzufügen von Sternen und schwarzen Löchern
• Passwortschutz: Bearbeitungsmodus ist passwortgeschützt und lässt sich anpassen
• Automatisches Speichern: Alle Daten werden automatisch im Browser gespeichert
• Import/Export: Daten können als JSON exportiert und importiert werden
• Responsive Design: Funktioniert auf Desktop und mobilen Geräten

Installation

1. Klonen Sie das Repository oder laden Sie die Dateien herunter
2. Navigieren Sie zum Projektverzeichnis
3. Installieren Sie die Abhängigkeiten:

   npm install

4. Starten Sie die Anwendung:

   npm start

Verwendung

1. Kind anlegen: Klicken Sie auf "Neues Kind hinzufügen" und geben Sie einen Namen ein
2. Kind auswählen: Klicken Sie auf eine Kind-Karte, um zur Tracker-Ansicht zu gelangen
3. Bearbeiten: Geben Sie das Passwort ein (standardmäßig leer) und klicken Sie auf "Bearbeiten"
4. Aufgaben bearbeiten: Konfigurieren Sie die Aufgaben und Belohnungsregeln über "Bearbeiten"-Button
5. Tagesfortschritt: Markieren Sie erledigte Aufgaben als Sterne, unerledigte als schwarze Löcher
6. Zeitmanagement: Die Spielzeit wird automatisch berechnet und kann manuell angepasst werden

Technische Details

• React mit TypeScript
• Lokaler Speicher mit localStorage
• Responsive CSS mit flexiblen Layouts
• JSON-basierter Import/Export

---

English

Description

Star Hunter is a single-page application designed to help children and parents collect and manage reward points. Each completed task is represented by a star, while uncompleted tasks are shown as black holes.

Key Features

• Multi-child support: Manage any number of children with individual tasks and settings
• Daily task list: Configurable tasks for each child with default tasks:
  • Hausaufgaben gut gemacht (Homework well done)
  • aufgeräumt (Tidied up)
  • spezial 1 (special 1)
  • spezial 2 (special 2)
  • gelesen (Read)
• Reward system:
  • 1 star = +5 minutes playtime
  • 1 black hole = -5 minutes playtime
  • Manual reduction and time credit possible
  • Configurable negative credit
• Ad-hoc rewards: Manually add stars and black holes
• Password protection: Edit mode is password-protected and customizable
• Auto-save: All data is automatically saved in the browser
• Import/Export: Data can be exported and imported as JSON
• Responsive design: Works on desktop and mobile devices

Installation

1. Clone the repository or download the files
2. Navigate to the project directory
3. Install dependencies:

   npm install

4. Start the application:

   npm start

Usage

1. Create child: Click "Neues Kind hinzufügen" and enter a name
2. Select child: Click on a child card to go to the tracker view
3. Edit: Enter the password (default empty) and click "Bearbeiten"
4. Configure tasks: Configure tasks and reward rules via the "Bearbeiten" button
5. Daily progress: Mark completed tasks as stars, uncompleted as black holes
6. Time management: Playtime is automatically calculated and can be manually adjusted

Technical Details

• React with TypeScript
• Local storage with localStorage
• Responsive CSS with flexible layouts
• JSON-based import/export

License

MIT License

AI INFO

I am no react developer! This was fully developed with (OpenCode)[https://github.com/anomalyco/opencode] for educational purposes only. I only used free model "Big Bickle". Despite some struggles with the github CLI, it only took a few - not well defined prompts - to create this result.

Gh Release for dummies:

npm run build
rm -r docs/*; cp -r build/* ./docs/
git add -A
git commit -m "ghrelease"
git push