fitti

Progressive Web App für das Training auf dem iPhone: Trainingspläne aus einem JSON-Katalog wählen, Sätze mit Timer und Sprachansagen abarbeiten, Ergebnisse im lokalen Logbuch behalten.

Live: https://schdief.github.io/fitti/

Funktionsumfang (Ausbau)

• Katalog – Pläne als JSON, filterbar nach Dauer und Muskelgruppen
• Training – Start-/Mittelpositions-Grafiken, Satzerfassung, Pausentimer, Sprach-Cues, Spotify-Steuerung
• Logbuch – Liste und Kalender, lokale Speicherung, Vorschlagswerte aus der Historie, optionaler Export nach Apple Health über einen Kurzbefehl

Entwicklung

npm install
npm run icons   # PNG-Icons aus assets/icon.svg erzeugen
npm run dev

Befehl	Zweck
npm run dev	Dev-Server auf http://localhost:5173/fitti/
npm run build	Katalog-Index, Typecheck und Produktionsbuild nach dist/
npm run preview	Produktionsbuild lokal testen (inkl. Service Worker)
npm run typecheck	nur Typprüfung
npm run validate	Pläne und Figuren gegen das Schema und die Querverweise prüfen
npm run catalog	public/plans/index.json neu erzeugen
npm run schema	JSON Schema und Vokabular für den Copilot-Skill exportieren
npm run icons	App-Icons neu rendern

Der Service Worker ist im Dev-Modus deaktiviert. Zum Testen des Offline-Verhaltens npm run build und npm run preview verwenden.

Trainingspläne

Pläne liegen als JSON in public/plans/, die Strichfiguren der Übungen in public/figures/. Beides erzeugt der Copilot-Skill unter .github/skills/trainingsplan-erstellen/ aus natürlicher Sprache. Das Zod-Schema in src/lib/plan/schema.ts ist die einzige Wahrheit; JSON Schema und Vokabular für den Skill werden daraus generiert.

Nach jeder Änderung an Plänen:

npm run validate && npm run catalog

Deployment

Push auf main startet den Workflow .github/workflows/deploy.yml, der baut und nach GitHub Pages veröffentlicht. Einmalig nötig: in den Repo-Einstellungen unter Pages als Quelle GitHub Actions wählen.

Der Basispfad /fitti/ ist in vite.config.ts gesetzt und muss zum Repository-Namen passen.

Struktur

assets/          Quell-SVG für die Icons
scripts/         Build-Hilfsskripte
src/app/         Routing und Layout
src/components/  gemeinsame UI-Bausteine
src/features/    catalog, logbook, settings
src/lib/         geteilte Typen und Helfer