Hypertrack is an offline-first Flutter app for workout, nutrition, measurements, steps, sleep, supplements, and one-way health-platform export.
This README is intentionally implementation-focused and reflects the current working copy of the codebase. Planned work toward 1.0 is listed separately and is not described as implemented behavior.
Note: Hypertrack is built with heavy AI assistance across implementation, refactoring, and documentation. I’m very happy with the result, but as with any fast-moving AI-assisted codebase, I cannot guarantee that every detail is perfect.
- Project Overview
- Statistics Module (Current Implementation)
- Sleep Module (Current Source of Truth)
- Sleep Health Score V2 (Current Canonical)
- System Architecture
- Data Models & Storage
- UI & Widgets
- Health Steps Module (Current Implementation)
- One-way Health Export (Current Implementation)
- Shared Analytics Definitions (Legacy Reference)
- Logging full workout sessions
- Exercise-by-exercise set tracking
- Support for set types such as warm-up, normal, failure, and dropset
- Tracking of reps, weight, and RIR
- Workout history and session review
- Session-level export to Apple Health and Google Health Connect
- Logging foods and nutrition entries
- Tracking calories and core macros
- Tracking additional nutrition fields such as fiber, sugar, and salt/sodium where available
- Optional AI-assisted meal tracking
- BYOK (bring your own API key) only
- user-controlled provider + model setup
- providers: OpenAI, Gemini, Anthropic/Claude, Mistral, xAI/Grok
- test status in current working copy: OpenAI + Gemini tested; Anthropic, Mistral, and xAI not yet end-to-end verified in this environment
- provider-native login/billing is intentionally not implemented
- Aggregate nutrition export to Apple Health and Google Health Connect
- Logging body measurements and body-weight-related entries
- Tracking values over time in charts
- Export of supported measurements to Apple Health and Google Health Connect
- Tracking caffeine and creatine
- Support for user-defined custom supplements
- Supplement logging over time
- Step data import and aggregation
- Sleep data import, processing, scoring, and visualization
- Sleep day/week/month views and detail screens
- Sleep statistics integration
- Workout and body analytics
- Performance and consistency views
- Muscle-volume-related analysis
- Body/nutrition analysis
- Sleep and steps integration in the statistics area
- One-way health-platform sync/export to Apple Health and Google Health Connect
- Export of app-recorded measurements, aggregate nutrition, hydration, and session-level workouts
- CSV export
- Automatic backups
- Offline-first local data handling
- Workout tracking
- Nutrition tracking
- Measurement tracking
- Supplement tracking
- Steps import and aggregation
- Sleep import, processing, and scoring
- One-way export to Apple Health / Google Health Connect
- Automatic backups
- CSV export
- Export/sync of supported app-recorded health data
- Optional AI-assisted meal tracking with user-provided API key
- No back-sync/import from Apple Health or Google Health Connect into Hypertrack
- No bidirectional merge/conflict handling
- No ingredient-level meal export
- No detailed workout-structure export (sets/exercises/RIR/supersets as structured health-platform data)
- Statistics hub includes:
- steps
- sleep
- recovery
- consistency
- performance
- muscle volume
- body/nutrition analytics
- Sleep tracking defaults to disabled in settings (
sleep_tracking_enableddefaultfalse) - Steps tracking defaults to enabled (
steps_tracking_enableddefaulttrue)
- Adaptive calorie target / TDEE guidance
- goal selection
- weekly target rate
- recommendation from intake + weight trend
- Onboarding (including TDEE guidance) and tutorial
- Widgets
- App Store release
- Google Play release
- Open Food Facts for food database coverage
- wger for the workout database foundation