Fitness Workout App – Kotlin Jetpack Compose Source Code

Description

A complete home workout app built with modern Android tools: Kotlin, Jetpack Compose, Material 3, Navigation Compose, MVVM with StateFlow, Room and DataStore. Programs, exercise library, a real workout player with timers and progress charts, ready to rebrand and publish on Google Play.

Features

• Home dashboard: weekly goal ring, streak, total minutes and calories, recommended program, recent workouts
• 6 workout programs (Beginner, Intermediate, Advanced) with level filter
• Program details with sets, reps or time and rest, estimated duration
• Exercise library: 16 exercises, search, muscle group filter, step by step instructions
• Workout player: countdown ring for timed sets, rep counter, automatic rest with Up next, pause, previous, next, finish early
• Workout summary with time, calories (MET based) and sets, saved to the log
• Progress: 7 day minutes bar chart, body weight line chart, Log weight dialog
• Settings: name, theme, weekly goal, rest override, kg or lb, delete all data
• Offline: Room for workouts and weight, DataStore for preferences
• Unit tests and Paparazzi screenshot tests

Tech stack

• Kotlin 1.9, Jetpack Compose (BOM 2024.06), Material 3
• Navigation Compose
• Room 2.6 with KSP
• Jetpack DataStore Preferences
• ViewModel + StateFlow (MVVM), coroutine based timer
• Gradle Kotlin DSL, AGP 8.5, minSdk 24, targetSdk 34

Requirements

• Android Studio Koala (2024.1) or newer
• JDK 17
• Android SDK 34, minSdk 24 (Android 7.0+)

How to install and run

1. Unzip the archive and open the folder in Android Studio
2. Wait for Gradle sync and press Run
3. Or build from the command line with ./gradlew assembleDebug
4. Run unit tests with ./gradlew testDebugUnitTest, render screenshots with ./gradlew recordPaparazziDebug

How to rebrand

• App name: res/values/strings.xml
• Colors: ui/theme/Theme.kt (BrandPrimary, BrandSecondary, light and dark schemes)
• Icon: res/drawable/ic_launcher_foreground.xml, res/values/ic_launcher_background.xml, res/mipmap-* or File > New > Image Asset
• Package id: applicationId and namespace in app/build.gradle.kts, then Refactor > Rename (current: com.appforge.fitpulse)
• Programs and exercises: data/Catalog.kt, defaults in data/SettingsStore.kt

What’s included

• Full Android Studio project with Kotlin source code and Gradle wrapper
• Unit tests and Paparazzi screenshot tests
• README.md with setup, rebranding and project structure
• LICENSE file
• Screenshots folder

Screenshots

License

Commercial license: use the source code in one end product (one app) for yourself or one client, free or paid. Reselling or redistributing the source code as a template is not allowed. Full text in the LICENSE file.