FitTrack 🏃‍♂️

FitTrack is a modern, privacy-focused Android fitness tracking application designed to help you track your runs, monitor your progress, and stay motivated. Built with Jetpack Compose and Material Design 3.

✨ Features

• 📍 Real-time Tracking: Track your run path, speed, distance, and duration using Google Maps API.
• 📊 Comprehensive Dashboard: Get quick insights into your total kilometers, calories burned, and average speed at a glance.
• 🔒 Privacy First: All data is stored locally on your device using Room Database. No cloud account required.
• 🌙 Modern UI: stunning Dark Theme interface built with Material Design 3 guidelines.
• 📝 Run History: Review your past activities with detailed statistics and map snapshots.
• 🏃‍♂️ Personalized Profile: Manage your profile and weight settings to get accurate calorie burn estimates.

🛠 Tech Stack

• Language: Kotlin
• UI Framework: Jetpack Compose (Material 3)
• Architecture: MVVM (Model-View-ViewModel) + Clean Architecture
• Dependency Injection: Dagger Hilt
• Local Database: Room & DataStore
• Maps: Google Maps SDK for Android
• Asynchronicity: Coroutines & Flow
• Navigation: Compose Navigation

🚀 Getting Started

Prerequisites

• Android Studio Iguana or newer
• JDK 17+
• A Google Maps API Key to enable map features.

Setup

1. Clone the repository:

   git clone https://github.com/yourusername/FitTrack.git

2. Configure API Key:

   • Get an API Key from the Google Cloud Console.
   • Add it to your local.properties file (this file is git-ignored for security):

     MAPS_API_KEY=your_api_key_here

   • Note: The app expects this key to be injected via build configuration.

3. Build and Run:

   • Open the project in Android Studio.
   • Sync Gradle.
   • Run the app on an Emulator or Physical Device.

📸 Screenshots

(Add your screenshots in a screenshots/ folder in the root directory)

Dashboard	Tracking	Activities

🤝 Contributing

Contributions are welcome! Please fork the repository and create a pull request with your changes.

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

📄 License

Distributed under the MIT License. See LICENSE for more information.

---