hellth-hub/README.md
Sebastian Mayer 2436dd9cac Initial commit: Hellth Hub monorepo
Mobile-first Web-App fuer persoenliches Health-, Ernaehrungs-,
Aktivitaets- und Einkaufs-Tracking im Home-Lab-Betrieb.

Stack: pnpm Monorepo - Next.js 16 + React 19 + Tailwind (apps/admin) -
Hono + tRPC + Better Auth mit 2FA und Passkeys (packages/api) -
PostgreSQL + Drizzle ORM (packages/db) - Docker fuer Postgres und pgAdmin.

Module:
- Auth mit Login, 2FA (TOTP + Backup-Codes), Passkeys und Admin-Recovery
- Tagesansicht mit Essen, Trinken, Gewicht, Aktivitaeten und Coach-Hinweisen
- Lebensmittelkatalog mit Naehrwerten, Portionen, OCR/Barcode/Open Food Facts
- Rezepte mit Live-Naehrwertberechnung und Community-Vorschlaegen
- Essensplanung und Wochenbudget mit Sportbonus
- Einkaufslisten mit Maerkten und Laufweg-Sortierung
- Hellfireclub mit Aktivitaetspunkten und gemeinsamer Aktivitaetsplanung
- Wearables-Vorbereitung (Fitbit / Google Fit / Health Connect)

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-27 22:15:16 +02:00

1.2 KiB

Hellth Hub

Mobile-first Web-App für persönliches Health- und Ernährungstracking im Home-Lab.

Lokaler Start

docker compose -f docker/docker-compose.yml up -d db
pnpm --filter @hellth/db db:migrate
pnpm --filter @hellth/api seed:admin
pnpm --filter @hellth/api seed:health
pnpm --filter @hellth/api dev
pnpm --filter admin dev

Danach:

Aktuelle Module

  • Auth, Login, 2FA, Passkeys und Benutzerverwaltung
  • Tagesansicht mit Essen, Trinken, Gewicht, Aktivitäten und Coach-Hinweisen
  • Lebensmittelkatalog mit Nährwerten, Portionen, Favoriten und OCR-Vorbereitung
  • Rezepte mit flexiblen Mengenangaben, Bewertungen und Meal-Prep-Bezug
  • Essensplanung mit Tages- und Wochenlogik
  • Wochenbudget für Kalorien inklusive Sportbonus
  • Einkaufsliste mit Märkten, Abteilungen und Laufweg-Sortierung
  • Ziele, Onboarding und persönliche Einstellungen pro Benutzer
  • Erinnerungen, Aktivitätspunkte, Hellfireclub und Wearable-Vorbereitung

Verifikation

pnpm --filter @hellth/api test -- --test-reporter=spec
pnpm --filter admin test
NEXT_PUBLIC_API_URL=http://localhost:3002 pnpm --filter admin build