Strive is a comprehensive fitness tracking application built with modern Android development practices. Whether you're hitting the gym or going for a run, Strive helps you plan, track, and analyze your workouts with an intuitive interface and powerful features.

Built entirely with Kotlin and Jetpack Compose, Strive demonstrates clean architecture, modern UI design, and seamless integration with Google services.

Exercise Library Browse & search exercises

Workout Templates Create custom workouts

GPS Tracking Live map & stats

Activity History Track your progress

• 🏗️ Clean Architecture - Separation of concerns across layers
• 🎯 MVVM Pattern - Reactive UI with ViewModel and StateFlow
• 💉 Dependency Injection - Dagger Hilt for modular dependencies
• 🔄 Reactive Programming - Kotlin Flow for reactive data streams

┌─────────────────────────────────────────────────────┐
│                   UI Layer                          │
│          Jetpack Compose + ViewModels               │
│              (Screens, Components)                  │
└───────────────────┬─────────────────────────────────┘
                    │ StateFlow/Events
┌───────────────────▼─────────────────────────────────┐
│                Domain Layer                         │
│         Use Cases + Repository Interfaces           │
│              (Business Logic)                       │
└───────────────────┬─────────────────────────────────┘
                    │ Models
┌───────────────────▼─────────────────────────────────┐
│                 Data Layer                          │
│      Room Database + Retrofit API + Mappers         │
│         (Local & Remote Data Sources)               │
└─────────────────────────────────────────────────────┘

Before you begin, ensure you have the following installed:

• ✅ Android Studio Hedgehog (2023.1.1) or later
• ✅ JDK 11 or higher
• ✅ Android SDK 28+ (Android 9.0 Pie)
• ✅ Google Play Services (for Maps & Location)

1. Clone the repository

   git clone https://github.com/yourusername/strive.git
   cd strive

2. Open in Android Studio

   • Launch Android Studio
   • Select "Open an Existing Project"
   • Navigate to the cloned directory

3. Configure API Keys

   Create a local.properties file in the project root (if it doesn't exist) and add:

   # Google Maps API Key (Required for Run screen)
   MAPS_API_KEY=your_google_maps_api_key_here
   
   # ExerciseDB API Key (Optional - app works offline without it)
   RAPIDAPI_KEY=your_rapidapi_key_here

   💡 Getting API Keys:

   • Google Maps: Get API Key - Enable "Maps SDK for Android"
   • ExerciseDB: RapidAPI - Free tier available

4. Sync & Build

   File → Sync Project with Gradle Files
   

5. Run the app 🚀

   • Connect an Android device or start an emulator
   • Click the "Run" button or press Shift + F10

• The app will automatically seed the exercise database on first launch
• No account or login required
• All data is stored locally on your device

1. Navigate to Workout tab
2. Tap "Create Template"
3. Add exercises from the library
4. Configure sets, reps, and rest times
5. Save and start your workout!

1. Navigate to Run tab
2. Select activity type (Running, Cycling, Walking)
3. Grant location permissions when prompted
4. Tap "Start" and begin your activity
5. View real-time stats and route on the map

Strive follows Clean Architecture principles with clear separation between layers:

📦 app
 ┣ 📂 core              → Cross-cutting concerns (DI, Utils, Location)
 ┣ 📂 data              → Data sources (Room, Retrofit, Repositories)
 ┣ 📂 domain            → Business logic (Models, Use Cases)
 ┗ 📂 ui                → Presentation (Compose Screens, ViewModels)

• ✅ Single Responsibility - Each class has one job
• ✅ Dependency Inversion - Depend on abstractions, not concretions
• ✅ Separation of Concerns - UI, Business Logic, and Data are independent
• ✅ Testability - All components are easily testable

• 🔐 No User Accounts - All data stored locally
• 🚫 No Data Collection - Your fitness data stays on your device
• 🔑 API Key Protection - Keys stored securely in build configuration
• 🛡️ R8 Obfuscation - Code protected against reverse engineering
• 🔒 HTTPS Only - All network communication is encrypted

This project was created as an academic assignment. While it's not actively seeking contributions, feel free to:

• 🐛 Report bugs by opening an issue
• 💡 Suggest features or improvements
• 🍴 Fork the project for your own experiments

It's still under development and may evolve over time.

If you want to contribute or experiment:

1. Fork the repository
2. Create a 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

This project is licensed under the MIT License - see the LICENSE file for details.

• ✅ Commercial use - You can use this code in commercial projects
• ✅ Modification - You can modify the code
• ✅ Distribution - You can distribute the code
• ✅ Private use - You can use the code privately
• ⚠️ Liability - The software is provided "as is"
• ⚠️ Warranty - No warranty is provided

If you use this project, attribution is appreciated but not required:

Strive - Fitness Tracking App
Original Author: Carl Lundholm
GitHub: https://github.com/Carlsmeister/strive

Special thanks to:

• 🏋️ ExerciseDB - Comprehensive exercise database
• 🗺️ Google Maps Platform - Maps and location services
• 🎨 Material Design - Design system and guidelines
• 🤖 Android Open Source Project - Android framework
• 🟣 Kotlin - Modern programming language
• 📚 Umeå University - Course instruction and guidance

If you encounter any issues or have questions:

1. 🐛 Search existing issues
2. 💬 Open a new issue

Future improvements planned:

• ☀️ Light theme support
• 📊 Advanced statistics and charts
• 🏆 Achievement system
• 📤 Workout sharing with friends
• ⌚ Android Wear integration
• 📱 Widget support
• 🌐 Multi-language support
• ☁️ Optional cloud backup

If you found this project helpful or interesting, please consider:

• ⭐ Starring the repository
• 🍴 Forking for your own experiments
• 📢 Sharing with others