RunningTrackerApp - Advanced Fitness Activity Tracker

RunningTrackerApp is a sophisticated Android fitness tracking application built with modern technologies including Jetpack Compose, MVVM architecture, and Google Maps integration. The app enables users to monitor their running activities in real-time, visualize routes on interactive maps, and maintain comprehensive activity statistics using Room database persistence.

Key Features

• Real-time GPS Tracking: Monitor your running activities with precise GPS tracking
• Interactive Route Visualization: View your running path in real-time using the Google Maps Compose library
• Background Tracking: Continuous activity monitoring via Foreground Service, even when the app is closed or removed from the background
• Comprehensive Data Storage: Persistent storage of running statistics with Room database
• Advanced Navigation: Seamless nested navigation, deep linking, and conditional navigation to onboarding screens via Jetpack Navigation Component
• Permission-free Image Selection: Integrated Jetpack Compose image picker for hassle-free image selection without additional permissions
• Efficient Data Loading: Integrated Paging3 for smooth, efficient data presentation

Getting Started

Basic Setup

1. Clone the repository

git clone https://github.com/adityaxxz/RunningTrackerApp

3. Open the project in Android Studio

Screenshots

Architecture & Package Structure

RunningTrackerApp follows the MVVM architecture with Unidirectional Data Flow (UDF) and clean architecture principles. The project is organized into the following key packages:

• background: Manages background processes including services
• data: Responsible for data production and management
  • tracking: Handles location tracking and activity monitoring
• di: Contains Hilt dependency injection modules
• domain: Houses common use cases and interfaces
• ui: Manages the application's user interface
  • nav: App navigation and destination management
  • screen: UI implementation components
  • theme: Material 3 theming components
  • common: UI utilities and shared components
• common: Cross-application utility classes

Technology Stack

• Kotlin: Modern, concise programming language
• Jetpack Compose: Declarative UI framework
• Jetpack Navigation: Screen navigation and deep linking
• Google Maps API: Location tracking and map visualization