HelloHealth is a premier, privacy-centric health and fitness ecosystem for Android. Designed for the modern user, it transforms fragmented health data into a unified, actionable, and visually stunning experience. By leveraging the Android Health Connect SDK, HelloHealth aggregates metrics from diverse wearables and apps, providing deep insights without compromising user privacy.
- Centralized Dashboard: A comprehensive overview of daily steps, calorie expenditure, and active duration.
- Health Connect Sync: Bi-directional synchronization with the Android health ecosystem, ensuring your data is never siloed.
- Interactive Sessions: Detailed breakdown of every workout with interactive time-series charts.
- Performance Metrics: Track Heart Rate, Pace, and Elevation profiles with scrubbable graph indicators.
- Geospatial Tracking: Visualized workout routes powered by Google Maps, showing start/finish markers and path geometry.
- Weekly Trends: Comparative analysis of your performance against previous weeks.
- Data-Driven Feedback: Visual indicators for activity trends (increasing/decreasing) across various health markers.
- Dynamic Goal Setting: Fine-tune your daily targets for steps, calories, and active minutes with intuitive UI controls.
- Dietary Preferences: Manage food preferences and nutritional focus areas (e.g., Protein-rich, Low-carb).
- Secure Identity: Frictionless onboarding via Google Identity and Android Credential Manager.
HelloHealth is engineered with a strict adherence to Clean Architecture and SOLID principles, ensuring the codebase is modular, testable, and maintainable.
graph TD
subgraph "UI Layer (Jetpack Compose)"
View[Screens/Composables] --> VM[ViewModels]
VM --> State[UI State]
end
subgraph "Domain Layer (Business Logic)"
VM --> UC[Use Cases]
UC --> Models[Domain Models]
UC --> Repos[Repository Interfaces]
end
subgraph "Data Layer (Implementation)"
Repos --> Impl[Repository Impl]
Impl --> HC[Health Connect Manager]
Impl --> Remote[Supabase / Ktor]
Impl --> Local[Room Database]
end
- Core: Kotlin (Coroutines, Flow, Serialization)
- UI Framework: Jetpack Compose (Material 3, Dynamic Color)
- Navigation: Compose Navigation with Type-safe arguments.
- Dependency Injection: Hilt
- Persistence: Room for offline-first caching.
- Backend: Supabase (Auth, Postgrest)
- Health Integration: Health Connect SDK
- Maps: Google Maps Compose SDK
- Image Loading: Coil
| Dashboard | Workout Analytics | Health Insights |
|---|---|---|
- Android Studio Ladybug (or newer)
- JDK 17
- Health Connect installed on the device (Standard on Android 14+, available on Play Store for 9-13)
-
Clone the Repository
git clone https://github.com/Pranay-AntiGravity/HelloHealth.git
-
Environment Configuration Create a
local.propertiesfile in the root directory:SUPABASE_URL=https://your-project.supabase.co SUPABASE_ANON_KEY=your-anon-key GOOGLE_WEB_CLIENT_ID=your-google-client-id.apps.googleusercontent.com GOOGLE_MAPS_API_KEY=your-maps-api-key
-
Google Cloud Platform Setup
- Enable Google Maps SDK for Android.
- Configure Google Sign-In and obtain the Web Client ID for Credential Manager integration.
-
Health Connect Permissions Upon first launch, the app will request read/write access to various health data types. Ensure these are granted for full functionality.
- Core Health Connect Integration
- Interactive Workout Charts & Maps
- Weekly Insight Engine
- 🥗 Nutrition Tracking: Direct logging of macro/micronutrients.
- 🤖 AI Coaching: Personalized health advice using LLM-based analysis of activity data.
- ⌚ Wear OS Companion: Standalone tracking for watches.
Copyright (c) 2024 HelloHealth Team. Licensed under the MIT License.
Developed with 💚 by the HelloHealth Team.