# chan2121420/fither architecture

> Architecture diagram of the GitHub repository chan2121420/fither, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-01). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/chan2121420/fither
- Repository: https://github.com/chan2121420/fither

## Overview

Fither is an Android fitness app for browsing exercises, building or selecting workout plans, completing timed workouts, and tracking activity, measurements, and nutrition. The main flow runs from workout browsing or building through an active session to saved workout history. ViewModels mediate screen requests to a repository, which uses Room-backed data access. The graph includes documented-by-source exercise tutorials and tracking screens; the empty README and unsampled modules limit evidence for reminders, seeding, and Supabase wiring.

Main entry points: [`app/src/main/java/com/fitherapp/database/AppDatabase.java`](https://github.com/chan2121420/fither/blob/master/app/src/main/java/com/fitherapp/database/AppDatabase.java) (Room database), [`app/src/main/java/com/fitherapp/viewmodels/MainViewModel.java`](https://github.com/chan2121420/fither/blob/master/app/src/main/java/com/fitherapp/viewmodels/MainViewModel.java) (App ViewModel), [`app/src/main/java/com/fitherapp/activities/ActiveWorkoutActivity.java`](https://github.com/chan2121420/fither/blob/master/app/src/main/java/com/fitherapp/activities/ActiveWorkoutActivity.java) (Active session), [`app/src/main/java/com/fitherapp/activities/WorkoutBuilderActivity.java`](https://github.com/chan2121420/fither/blob/master/app/src/main/java/com/fitherapp/activities/WorkoutBuilderActivity.java) (Workout builder)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_screens["App screens"]
  node_main["Main activity<br/>[MainActivity.java]"]
  node_home["Home screen<br/>[HomeFragment.java]"]
  node_workouts["Workout browser"]
  node_library["Exercise library"]
  node_tutorial["Exercise tutorial"]
end

subgraph group_workouts["Workout flow"]
  node_builder["Workout builder"]
  node_active["Active session"]
  node_complete["Workout completion"]
end

subgraph group_appdata["App data"]
  node_viewmodel["App ViewModel<br/>[MainViewModel.java]"]
  node_workoutvm["Workout ViewModel"]
  node_repository["Workout repository"]
  node_database[("Room database<br/>[AppDatabase.java]")]
  node_daos["Data access objects"]
  node_exercise["Exercise data<br/>[Exercise.java]"]
  node_plan["Workout plan data<br/>[WorkoutPlan.java]"]
  node_workoutexercise["Plan exercise data"]
  node_history["Workout history data"]
  node_session["Workout session data"]
  node_measurementdata["Measurement data"]
  node_nutritiondata["Nutrition data<br/>[NutritionLog.java]"]
  node_userprofile["User profile data<br/>[User.java]"]
  node_workoutday["Workout day data<br/>[WorkoutDay.java]"]
  node_exercise_details["Exercise plan details"]
end

subgraph group_tracking["Progress tracking"]
  node_nutrition["Nutrition log"]
  node_progress["Progress screen"]
  node_measurement["Measurement input"]
end

node_user(("User"))

node_user -->|"opens app"| node_main
node_home -->|"requests data"| node_viewmodel
node_workouts -->|"requests data"| node_viewmodel
node_library -->|"requests exercises"| node_viewmodel
node_library -->|"opens tutorial"| node_tutorial
node_workouts -->|"opens builder"| node_builder
node_workouts -->|"starts session"| node_active
node_home -->|"starts session"| node_active
node_home -->|"opens exercise details"| node_tutorial
node_builder -->|"saves plan"| node_viewmodel
node_builder -->|"opens tutorial"| node_tutorial
node_builder -->|"selects exercises"| node_exercise
node_active -->|"loads and saves"| node_viewmodel
node_active -->|"opens completion"| node_complete
node_active -->|"creates record"| node_history
node_nutrition -->|"reads and logs"| node_viewmodel
node_progress -->|"reads measurements"| node_viewmodel
node_progress -->|"opens input"| node_measurement
node_viewmodel -->|"delegates data"| node_repository
node_workoutvm -->|"delegates data"| node_repository
node_repository -->|"gets database"| node_database
node_database -->|"provides accessors"| node_daos
node_repository -->|"queries and writes"| node_daos
node_active -->|"uses plan details"| node_exercise_details
node_database -->|"stores entity"| node_exercise
node_database -->|"stores entity"| node_plan
node_database -->|"stores entity"| node_workoutexercise
node_database -->|"stores entity"| node_history
node_database -->|"stores entity"| node_session
node_database -->|"stores entity"| node_measurementdata
node_database -->|"stores entity"| node_nutritiondata
node_database -->|"stores entity"| node_userprofile
node_database -->|"stores entity"| node_workoutday

click node_main "https://github.com/chan2121420/fither/blob/master/app/src/main/java/com/fitherapp/activities/MainActivity.java"
click node_home "https://github.com/chan2121420/fither/blob/master/app/src/main/java/com/fitherapp/fragments/HomeFragment.java"
click node_workouts "https://github.com/chan2121420/fither/blob/master/app/src/main/java/com/fitherapp/fragments/WorkoutsFragment.java"
click node_library "https://github.com/chan2121420/fither/blob/master/app/src/main/java/com/fitherapp/fragments/ExerciseLibraryFragment.java"
click node_tutorial "https://github.com/chan2121420/fither/blob/master/app/src/main/java/com/fitherapp/activities/ExerciseTutorialActivity.java"
click node_nutrition "https://github.com/chan2121420/fither/blob/master/app/src/main/java/com/fitherapp/fragments/NutritionFragment.java"
click node_progress "https://github.com/chan2121420/fither/blob/master/app/src/main/java/com/fitherapp/fragments/ProgressFragment.java"
click node_measurement "https://github.com/chan2121420/fither/blob/master/app/src/main/java/com/fitherapp/fragments/MeasurementInputFragment.java"
click node_builder "https://github.com/chan2121420/fither/blob/master/app/src/main/java/com/fitherapp/activities/WorkoutBuilderActivity.java"
click node_active "https://github.com/chan2121420/fither/blob/master/app/src/main/java/com/fitherapp/activities/ActiveWorkoutActivity.java"
click node_complete "https://github.com/chan2121420/fither/blob/master/app/src/main/java/com/fitherapp/activities/WorkoutCompleteActivity.java"
click node_viewmodel "https://github.com/chan2121420/fither/blob/master/app/src/main/java/com/fitherapp/viewmodels/MainViewModel.java"
click node_workoutvm "https://github.com/chan2121420/fither/blob/master/app/src/main/java/com/fitherapp/viewmodels/WorkoutViewModel.java"
click node_repository "https://github.com/chan2121420/fither/blob/master/app/src/main/java/com/fitherapp/repository/WorkoutRepository.java"
click node_database "https://github.com/chan2121420/fither/blob/master/app/src/main/java/com/fitherapp/database/AppDatabase.java"
click node_daos "https://github.com/chan2121420/fither/tree/master/app/src/main/java/com/fitherapp/database"
click node_exercise "https://github.com/chan2121420/fither/blob/master/app/src/main/java/com/fitherapp/models/Exercise.java"
click node_plan "https://github.com/chan2121420/fither/blob/master/app/src/main/java/com/fitherapp/models/WorkoutPlan.java"
click node_workoutexercise "https://github.com/chan2121420/fither/blob/master/app/src/main/java/com/fitherapp/models/WorkoutExercise.java"
click node_history "https://github.com/chan2121420/fither/blob/master/app/src/main/java/com/fitherapp/models/WorkoutHistory.java"
click node_session "https://github.com/chan2121420/fither/blob/master/app/src/main/java/com/fitherapp/models/WorkoutSession.java"
click node_measurementdata "https://github.com/chan2121420/fither/blob/master/app/src/main/java/com/fitherapp/models/BodyMeasurement.java"
click node_nutritiondata "https://github.com/chan2121420/fither/blob/master/app/src/main/java/com/fitherapp/models/NutritionLog.java"
click node_userprofile "https://github.com/chan2121420/fither/blob/master/app/src/main/java/com/fitherapp/models/User.java"
click node_workoutday "https://github.com/chan2121420/fither/blob/master/app/src/main/java/com/fitherapp/models/WorkoutDay.java"
click node_exercise_details "https://github.com/chan2121420/fither/blob/master/app/src/main/java/com/fitherapp/models/ExerciseWithDetails.java"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_main,node_home,node_workouts,node_library,node_tutorial,node_user toneBlue
class node_builder,node_active,node_complete toneAmber
class node_viewmodel,node_workoutvm,node_repository,node_database,node_daos,node_exercise,node_plan,node_workoutexercise,node_history,node_session,node_measurementdata,node_nutritiondata,node_userprofile,node_workoutday,node_exercise_details toneMint
class node_nutrition,node_progress,node_measurement toneRose
```

## Components

### App screens

- [Main activity](https://github.com/chan2121420/fither/blob/master/app/src/main/java/com/fitherapp/activities/MainActivity.java): `app/src/main/java/com/fitherapp/activities/MainActivity.java`
- [Home screen](https://github.com/chan2121420/fither/blob/master/app/src/main/java/com/fitherapp/fragments/HomeFragment.java): `app/src/main/java/com/fitherapp/fragments/HomeFragment.java`
- [Workout browser](https://github.com/chan2121420/fither/blob/master/app/src/main/java/com/fitherapp/fragments/WorkoutsFragment.java): `app/src/main/java/com/fitherapp/fragments/WorkoutsFragment.java`
- [Exercise library](https://github.com/chan2121420/fither/blob/master/app/src/main/java/com/fitherapp/fragments/ExerciseLibraryFragment.java): `app/src/main/java/com/fitherapp/fragments/ExerciseLibraryFragment.java`
- [Exercise tutorial](https://github.com/chan2121420/fither/blob/master/app/src/main/java/com/fitherapp/activities/ExerciseTutorialActivity.java): `app/src/main/java/com/fitherapp/activities/ExerciseTutorialActivity.java`

### Workout flow

- [Workout builder](https://github.com/chan2121420/fither/blob/master/app/src/main/java/com/fitherapp/activities/WorkoutBuilderActivity.java): `app/src/main/java/com/fitherapp/activities/WorkoutBuilderActivity.java`
- [Active session](https://github.com/chan2121420/fither/blob/master/app/src/main/java/com/fitherapp/activities/ActiveWorkoutActivity.java): `app/src/main/java/com/fitherapp/activities/ActiveWorkoutActivity.java`
- [Workout completion](https://github.com/chan2121420/fither/blob/master/app/src/main/java/com/fitherapp/activities/WorkoutCompleteActivity.java): `app/src/main/java/com/fitherapp/activities/WorkoutCompleteActivity.java`

### App data

- [App ViewModel](https://github.com/chan2121420/fither/blob/master/app/src/main/java/com/fitherapp/viewmodels/MainViewModel.java): `app/src/main/java/com/fitherapp/viewmodels/MainViewModel.java`
- [Workout ViewModel](https://github.com/chan2121420/fither/blob/master/app/src/main/java/com/fitherapp/viewmodels/WorkoutViewModel.java): `app/src/main/java/com/fitherapp/viewmodels/WorkoutViewModel.java`
- [Workout repository](https://github.com/chan2121420/fither/blob/master/app/src/main/java/com/fitherapp/repository/WorkoutRepository.java): `app/src/main/java/com/fitherapp/repository/WorkoutRepository.java`
- [Room database](https://github.com/chan2121420/fither/blob/master/app/src/main/java/com/fitherapp/database/AppDatabase.java): `app/src/main/java/com/fitherapp/database/AppDatabase.java`
- [Data access objects](https://github.com/chan2121420/fither/tree/master/app/src/main/java/com/fitherapp/database): `app/src/main/java/com/fitherapp/database`
- [Exercise data](https://github.com/chan2121420/fither/blob/master/app/src/main/java/com/fitherapp/models/Exercise.java): `app/src/main/java/com/fitherapp/models/Exercise.java`
- [Workout plan data](https://github.com/chan2121420/fither/blob/master/app/src/main/java/com/fitherapp/models/WorkoutPlan.java): `app/src/main/java/com/fitherapp/models/WorkoutPlan.java`
- [Plan exercise data](https://github.com/chan2121420/fither/blob/master/app/src/main/java/com/fitherapp/models/WorkoutExercise.java): `app/src/main/java/com/fitherapp/models/WorkoutExercise.java`
- [Workout history data](https://github.com/chan2121420/fither/blob/master/app/src/main/java/com/fitherapp/models/WorkoutHistory.java): `app/src/main/java/com/fitherapp/models/WorkoutHistory.java`
- [Workout session data](https://github.com/chan2121420/fither/blob/master/app/src/main/java/com/fitherapp/models/WorkoutSession.java): `app/src/main/java/com/fitherapp/models/WorkoutSession.java`
- [Measurement data](https://github.com/chan2121420/fither/blob/master/app/src/main/java/com/fitherapp/models/BodyMeasurement.java): `app/src/main/java/com/fitherapp/models/BodyMeasurement.java`
- [Nutrition data](https://github.com/chan2121420/fither/blob/master/app/src/main/java/com/fitherapp/models/NutritionLog.java): `app/src/main/java/com/fitherapp/models/NutritionLog.java`
- [User profile data](https://github.com/chan2121420/fither/blob/master/app/src/main/java/com/fitherapp/models/User.java): `app/src/main/java/com/fitherapp/models/User.java`
- [Workout day data](https://github.com/chan2121420/fither/blob/master/app/src/main/java/com/fitherapp/models/WorkoutDay.java): `app/src/main/java/com/fitherapp/models/WorkoutDay.java`
- [Exercise plan details](https://github.com/chan2121420/fither/blob/master/app/src/main/java/com/fitherapp/models/ExerciseWithDetails.java): `app/src/main/java/com/fitherapp/models/ExerciseWithDetails.java`

### Progress tracking

- [Nutrition log](https://github.com/chan2121420/fither/blob/master/app/src/main/java/com/fitherapp/fragments/NutritionFragment.java): `app/src/main/java/com/fitherapp/fragments/NutritionFragment.java`
- [Progress screen](https://github.com/chan2121420/fither/blob/master/app/src/main/java/com/fitherapp/fragments/ProgressFragment.java): `app/src/main/java/com/fitherapp/fragments/ProgressFragment.java`
- [Measurement input](https://github.com/chan2121420/fither/blob/master/app/src/main/java/com/fitherapp/fragments/MeasurementInputFragment.java): `app/src/main/java/com/fitherapp/fragments/MeasurementInputFragment.java`

### Other components

- **User**

## Connections

- User → Main activity: opens app
- Home screen → App ViewModel: requests data (evidence: `app/src/main/java/com/fitherapp/fragments/HomeFragment.java`)
- Workout browser → App ViewModel: requests data (evidence: `app/src/main/java/com/fitherapp/fragments/WorkoutsFragment.java`)
- Exercise library → App ViewModel: requests exercises (evidence: `app/src/main/java/com/fitherapp/fragments/ExerciseLibraryFragment.java`)
- Exercise library → Exercise tutorial: opens tutorial (evidence: `app/src/main/java/com/fitherapp/fragments/ExerciseLibraryFragment.java`)
- Workout browser → Workout builder: opens builder (evidence: `app/src/main/java/com/fitherapp/fragments/WorkoutsFragment.java`)
- Workout browser → Active session: starts session (evidence: `app/src/main/java/com/fitherapp/fragments/WorkoutsFragment.java`)
- Home screen → Active session: starts session (evidence: `app/src/main/java/com/fitherapp/fragments/HomeFragment.java`)
- Home screen → Exercise tutorial: opens exercise details (evidence: `app/src/main/java/com/fitherapp/fragments/HomeFragment.java`)
- Workout builder → App ViewModel: saves plan (evidence: `app/src/main/java/com/fitherapp/activities/WorkoutBuilderActivity.java`)
- Workout builder → Exercise tutorial: opens tutorial (evidence: `app/src/main/java/com/fitherapp/activities/WorkoutBuilderActivity.java`)
- Workout builder → Exercise data: selects exercises (evidence: `app/src/main/java/com/fitherapp/activities/WorkoutBuilderActivity.java`)
- Active session → App ViewModel: loads and saves (evidence: `app/src/main/java/com/fitherapp/activities/ActiveWorkoutActivity.java`)
- Active session → Workout completion: opens completion (evidence: `app/src/main/java/com/fitherapp/activities/ActiveWorkoutActivity.java`)
- Active session → Workout history data: creates record (evidence: `app/src/main/java/com/fitherapp/activities/ActiveWorkoutActivity.java`)
- Nutrition log → App ViewModel: reads and logs (evidence: `app/src/main/java/com/fitherapp/fragments/NutritionFragment.java`)
- Progress screen → App ViewModel: reads measurements (evidence: `app/src/main/java/com/fitherapp/fragments/ProgressFragment.java`)
- Progress screen → Measurement input: opens input (evidence: `app/src/main/java/com/fitherapp/fragments/ProgressFragment.java`)
- App ViewModel → Workout repository: delegates data (evidence: `app/src/main/java/com/fitherapp/viewmodels/MainViewModel.java`)
- Workout ViewModel → Workout repository: delegates data (evidence: `app/src/main/java/com/fitherapp/viewmodels/WorkoutViewModel.java`)
- Workout repository → Room database: gets database (evidence: `app/src/main/java/com/fitherapp/repository/WorkoutRepository.java`)
- Room database → Data access objects: provides accessors (evidence: `app/src/main/java/com/fitherapp/database/AppDatabase.java`)
- Workout repository → Data access objects: queries and writes (evidence: `app/src/main/java/com/fitherapp/repository/WorkoutRepository.java`)
- Active session → Exercise plan details: uses plan details (evidence: `app/src/main/java/com/fitherapp/activities/ActiveWorkoutActivity.java`)
- Room database → Exercise data: stores entity (evidence: `app/src/main/java/com/fitherapp/database/AppDatabase.java`)
- Room database → Workout plan data: stores entity (evidence: `app/src/main/java/com/fitherapp/database/AppDatabase.java`)
- Room database → Plan exercise data: stores entity (evidence: `app/src/main/java/com/fitherapp/database/AppDatabase.java`)
- Room database → Workout history data: stores entity (evidence: `app/src/main/java/com/fitherapp/database/AppDatabase.java`)
- Room database → Workout session data: stores entity (evidence: `app/src/main/java/com/fitherapp/database/AppDatabase.java`)
- Room database → Measurement data: stores entity (evidence: `app/src/main/java/com/fitherapp/database/AppDatabase.java`)
- Room database → Nutrition data: stores entity (evidence: `app/src/main/java/com/fitherapp/database/AppDatabase.java`)
- Room database → User profile data: stores entity (evidence: `app/src/main/java/com/fitherapp/database/AppDatabase.java`)
- Room database → Workout day data: stores entity (evidence: `app/src/main/java/com/fitherapp/database/AppDatabase.java`)
