How ksrdhilip/adhils-fitness works
ADhils Fitness is a profile-based workout planning, logging, and coaching app, with shared Kotlin UI/core logic, Android platform integrations, and an optional local PC AI companion. The main user path is profile setup and check-in, session generation, set logging, and review of summaries or progress. The README also documents camera coaching, exercise guidance, backups, health integrations, and the companion. Some subsystem links are documented but their implementation was not sampled; those links are marked dashed where source evidence is unavailable.
Main entry points: FitnessApp.kt Fitness UI · WorkoutScreens.kt Workout screens · server.mjs PC coach server · Training.kt Workout planning
Components 26
App experience
- App entry
app/src/main/java/com/adhils/fitness/MainActivity.kt - Fitness UI
shared/src/commonMain/kotlin/com/adhils/fitness/FitnessApp.kt - App state
shared/src/commonMain/kotlin/com/adhils/fitness/FitnessViewModel.kt - Profile setup
shared/src/commonMain/kotlin/com/adhils/fitness/OnboardingQuestions.kt - Workout screens
shared/src/commonMain/kotlin/com/adhils/fitness/WorkoutScreens.kt - Progress views
shared/src/commonMain/kotlin/com/adhils/fitness/ExerciseProgressScreens.kt - Exercise guidance
shared/src/commonMain/kotlin/com/adhils/fitness/HowToScreen.kt - Camera coaching UI
shared/src/commonMain/kotlin/com/adhils/fitness/CameraCoachScreen.kt
Training domain
- Exercise catalog
core/src/main/kotlin/com/adhils/fitness/core/Catalog.kt - Workout planning
core/src/main/kotlin/com/adhils/fitness/core/Training.kt - Recovery analysis
core/src/main/kotlin/com/adhils/fitness/core/Recovery.kt - Coach proposals
core/src/main/kotlin/com/adhils/fitness/core/Coach.kt - Pose analysis
core/src/main/kotlin/com/adhils/fitness/core/PoseEngine.kt
Platform services
- Android camera
app/src/main/java/com/adhils/fitness/AndroidCameraPreview.kt - Health Connect
app/src/main/java/com/adhils/fitness/HealthConnectManager.kt - Wearable sync
app/src/main/java/com/adhils/fitness/HealthWearableManager.kt - Encrypted backup
core/src/jvmMain/kotlin/com/adhils/fitness/core/Backup.kt - Phone companion client
app/src/main/java/com/adhils/fitness/CompanionClient.kt
AI companion
- PC coach server
companion/src/server.mjs - Request validation
companion/src/contracts.mjs - Budget journal
companion/src/journal.mjs - AI providers
companion/src/providers.mjs - Codex client
companion/src/codex.mjs
Other components
- Fitness user
- Selected AI service
- Health Connect service
Connections 32
- Fitness user → App entry: opens
README.md - App entry → Fitness UI: launches
app/src/main/java/com/adhils/fitness/MainActivity.kt - Fitness UI → App state: uses state
shared/src/commonMain/kotlin/com/adhils/fitness/FitnessApp.kt - Fitness UI → Profile setup: routes to
shared/src/commonMain/kotlin/com/adhils/fitness/FitnessApp.kt - Fitness UI → Workout screens: routes to
shared/src/commonMain/kotlin/com/adhils/fitness/FitnessApp.kt - Fitness UI → Progress views: shows
README.md - Fitness UI → Exercise guidance: routes to
shared/src/commonMain/kotlin/com/adhils/fitness/FitnessApp.kt - Fitness UI → Camera coaching UI: routes to
shared/src/commonMain/kotlin/com/adhils/fitness/FitnessApp.kt - Workout screens → App state: updates state
shared/src/commonMain/kotlin/com/adhils/fitness/WorkoutScreens.kt - Workout screens → Workout planning: uses planning
shared/src/commonMain/kotlin/com/adhils/fitness/WorkoutScreens.kt - Workout screens → Exercise catalog: reads exercises
shared/src/commonMain/kotlin/com/adhils/fitness/WorkoutScreens.kt - Workout screens → Recovery analysis: reads recovery
shared/src/commonMain/kotlin/com/adhils/fitness/WorkoutScreens.kt - Workout screens → Coach proposals: uses proposals
shared/src/commonMain/kotlin/com/adhils/fitness/WorkoutScreens.kt - Profile setup → Workout planning: uses planning
shared/src/commonMain/kotlin/com/adhils/fitness/OnboardingQuestions.kt - Workout planning → Exercise catalog: selects exercises
core/src/main/kotlin/com/adhils/fitness/core/Training.kt - Workout planning → Recovery analysis: uses recovery
core/src/main/kotlin/com/adhils/fitness/core/Training.kt - Recovery analysis → Exercise catalog: reads exercises
core/src/main/kotlin/com/adhils/fitness/core/Recovery.kt - Coach proposals → Workout planning: calculates loads
core/src/main/kotlin/com/adhils/fitness/core/Coach.kt - Coach proposals → Exercise catalog: validates exercises
core/src/main/kotlin/com/adhils/fitness/core/Coach.kt - Camera coaching UI → App state: uses state
shared/src/commonMain/kotlin/com/adhils/fitness/CameraCoachScreen.kt - Camera coaching UI → Pose analysis: sends pose frames
shared/src/commonMain/kotlin/com/adhils/fitness/CameraCoachScreen.kt - Android camera → Camera coaching UI: provides frames
- Health Connect → Health Connect service: reads records
app/src/main/java/com/adhils/fitness/HealthConnectManager.kt - Wearable sync → Health Connect: requests vitals
app/src/main/java/com/adhils/fitness/HealthWearableManager.kt - Fitness user → Encrypted backup: exports or imports
README.md - Phone companion client → PC coach server: sends coach requests
README.md - PC coach server → Request validation: validates requests
companion/src/server.mjs - PC coach server → Budget journal: reserves budget
companion/src/server.mjs - PC coach server → AI providers: dispatches requests
- PC coach server → Codex client: dispatches requests
- AI providers → Selected AI service: calls provider
- Codex client → Selected AI service: calls Codex