HealthTrack (codenamed Nexa) is a premium, production-grade Android health and wellness ecosystem. Engineered with performance, security, and scalability in mind, Nexa integrates seamlessly with Google Health Connect to provide a unified view of vitals, fitness goals, and medication adherence.
- Biometric Security: Industry-standard authentication for sensitive health data.
- Health Connect Integration: Bidirectional synchronization with the Android health ecosystem.
- Fitness Management: Dynamic goal tracking with automated reminder scheduling.
- Medication Reminders: High-precision scheduling for medication and clinical appointments.
- Vitals Tracking: Real-time monitoring of blood pressure, heart rate, and body temperature.
- Advanced Analytics: Visual insights into health trends and goal progress.
The project follows Clean Architecture principles combined with MVVM (Model-View-ViewModel) to ensure a robust, testable, and maintainable codebase.
- Domain Layer: Pure Kotlin layer containing Entities, Repositories (Interfaces), and UseCases. Business logic is encapsulated here.
- Data Layer: Contains Repository implementations, Room Database, DataStore, and External API (Health Connect) integrations.
- Presentation Layer: Jetpack Compose based UI. ViewModels manage state and interact with UseCases.
graph TD
A[Presentation: Compose UI] --> B[Presentation: ViewModels]
B --> C[Domain: UseCases]
C --> D[Domain: Repositories Interface]
E[Data: Repository Implementation] -. Implements .-> D
E --> F[Data: Persistence & APIs]
The data layer employs a robust "Local-First" architecture with background synchronization, ensuring the app remains fully functional offline while orchestrating heavy workloads in the background.
flowchart TB
subgraph Domain Layer
RI[Repository Interfaces]
end
subgraph Backend & Data Layer
R[Repository Implementations] -. Implements .-> RI
subgraph Local Persistence
R -->|Structured Entities| DB[(Room SQLite)]
R -->|App State & Prefs| DS[(DataStore)]
end
subgraph Background Orchestration
R -->|Schedule Alarms| SCH[AlarmManager Schedulers]
SCH -->|Wake & Execute| BR[Broadcast Receivers]
BR -->|Delegate Heavy Tasks| WM[WorkManager]
R -->|Enqueue Sync| WM
end
subgraph External Systems
R -->|IPC Vitals Sync| HC([Google Health Connect])
WM <-->|Eventual Consistency| FB[(Firebase Firestore)]
end
end
- UI: Jetpack Compose
- Dependency Injection: Hilt
- Local Persistence: Room Database, DataStore
- Concurrency: Kotlin Coroutines & Flow
- Health Data: Health Connect SDK
- Scheduling: WorkManager & AlarmManager
- Android Studio Hedgehog or newer.
- JDK 17.
- A device/emulator with Android 11 (API 30) or higher.
- Clone the repository:
git clone https://github.com/ronitsaha11/HealthTrack.git
- Open the project in Android Studio.
- Sync Gradle and run the
appconfiguration.
The project implements a comprehensive testing strategy:
- Unit Tests: Domain logic and ViewModels.
- Instrumentation Tests: Room DB and UI interactions.
Run tests via:
./gradlew testPlease read CONTRIBUTING.md for details on our code of conduct and the process for submitting pull requests.
This project is licensed under the MIT License - see the LICENSE file for details.