# insect-cs/workout_tracking_app architecture

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

- Interactive diagram: https://gitdiagram.com/insect-cs/workout_tracking_app
- Repository: https://github.com/insect-cs/workout_tracking_app

## Overview

This is a Flutter workout app. The file tree suggests a user journey through workout entry, exercise logging or pose tracking, results, and saved workouts, with Gemini, YouTube, export, and web pose support as additional capabilities. Those runtime relationships are inferred from names rather than inspected Dart source; dashed edges mark them as unverified. The README documents Gemini configuration and the Home theme toggle, but does not describe the workout flow.

Main entry points: [`lib/screens/workout_result_screen.dart`](https://github.com/insect-cs/workout_tracking_app/blob/main/lib/screens/workout_result_screen.dart) (Workout result), [`lib/screens/home_screen.dart`](https://github.com/insect-cs/workout_tracking_app/blob/main/lib/screens/home_screen.dart) (Home), [`lib/state/workout_state.dart`](https://github.com/insect-cs/workout_tracking_app/blob/main/lib/state/workout_state.dart) (Workout state), [`lib/screens/workout_input_screen.dart`](https://github.com/insect-cs/workout_tracking_app/blob/main/lib/screens/workout_input_screen.dart) (Workout input)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["App experience"]
  node_app["App entry<br/>[main.dart]"]
  node_shell["Main shell<br/>[main_shell.dart]"]
  node_home["Home<br/>[home_screen.dart]"]
  node_theme["Theme controller"]
  node_theme_style["App theme<br/>[app_theme.dart]"]
end

subgraph group_workout["Workout workflow"]
  node_input["Workout input"]
  node_logger["Exercise logger"]
  node_pose_screen["Pose tracking"]
  node_result["Workout result"]
  node_saved["Saved workouts"]
  node_state["Workout state<br/>[workout_state.dart]"]
  node_models["Workout models"]
end

subgraph group_services["Analysis and integrations"]
  node_pose_analysis["Pose analysis"]
  node_skeleton["Skeleton painter"]
  node_gemini["Gemini service"]
  node_gemini_api{{"Gemini API"}}
  node_youtube["YouTube service"]
  node_export["Export service"]
end

subgraph group_platform["Platform support"]
  node_web_pose["Web pose adapter<br/>[web_pose_web.dart]"]
  node_web_model["MoveNet model<br/>[model.json]"]
  node_downloader["Web downloader"]
end

node_user(("User"))

node_user -.->|"opens"| node_app
node_app -.->|"starts"| node_shell
node_shell -.->|"shows"| node_home
node_user -->|"toggles theme"| node_home
node_home -->|"switches"| node_theme
node_theme -->|"updates"| node_theme_style
node_home -.->|"starts workout"| node_input
node_input -.->|"records exercise"| node_logger
node_logger -.->|"tracks pose"| node_pose_screen
node_pose_screen -.->|"analyzes pose"| node_pose_analysis
node_pose_analysis -.->|"draws pose"| node_skeleton
node_pose_screen -.->|"uses on web"| node_web_pose
node_web_pose -.->|"loads model"| node_web_model
node_logger -.->|"updates"| node_state
node_input -.->|"updates"| node_state
node_state -.->|"holds"| node_models
node_state -.->|"provides data"| node_result
node_result -.->|"saves workout"| node_saved
node_result -.->|"requests analysis"| node_gemini
node_gemini -.->|"calls"| node_gemini_api
node_result -.->|"requests videos"| node_youtube
node_result -.->|"exports"| node_export
node_export -.->|"downloads on web"| node_downloader

click node_app "https://github.com/insect-cs/workout_tracking_app/blob/main/lib/main.dart"
click node_shell "https://github.com/insect-cs/workout_tracking_app/blob/main/lib/screens/main_shell.dart"
click node_home "https://github.com/insect-cs/workout_tracking_app/blob/main/lib/screens/home_screen.dart"
click node_theme "https://github.com/insect-cs/workout_tracking_app/blob/main/lib/theme/theme_controller.dart"
click node_theme_style "https://github.com/insect-cs/workout_tracking_app/blob/main/lib/theme/app_theme.dart"
click node_input "https://github.com/insect-cs/workout_tracking_app/blob/main/lib/screens/workout_input_screen.dart"
click node_logger "https://github.com/insect-cs/workout_tracking_app/blob/main/lib/screens/exercise_logger_screen.dart"
click node_pose_screen "https://github.com/insect-cs/workout_tracking_app/blob/main/lib/screens/pose_tracking_screen.dart"
click node_result "https://github.com/insect-cs/workout_tracking_app/blob/main/lib/screens/workout_result_screen.dart"
click node_saved "https://github.com/insect-cs/workout_tracking_app/blob/main/lib/screens/saved_workouts_screen.dart"
click node_state "https://github.com/insect-cs/workout_tracking_app/blob/main/lib/state/workout_state.dart"
click node_models "https://github.com/insect-cs/workout_tracking_app/blob/main/lib/models/workout_models.dart"
click node_pose_analysis "https://github.com/insect-cs/workout_tracking_app/blob/main/lib/services/pose_analysis_service.dart"
click node_skeleton "https://github.com/insect-cs/workout_tracking_app/blob/main/lib/widgets/pose_skeleton_painter.dart"
click node_gemini "https://github.com/insect-cs/workout_tracking_app/blob/main/lib/services/gemini_service.dart"
click node_youtube "https://github.com/insect-cs/workout_tracking_app/blob/main/lib/services/youtube_service.dart"
click node_export "https://github.com/insect-cs/workout_tracking_app/blob/main/lib/services/export_service.dart"
click node_web_pose "https://github.com/insect-cs/workout_tracking_app/blob/main/lib/web/web_pose_web.dart"
click node_web_model "https://github.com/insect-cs/workout_tracking_app/blob/main/web/models/movenet_lightning/model.json"
click node_downloader "https://github.com/insect-cs/workout_tracking_app/blob/main/lib/web/file_downloader_web.dart"

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_app,node_shell,node_home,node_theme,node_theme_style,node_user toneBlue
class node_input,node_logger,node_pose_screen,node_result,node_saved,node_state,node_models toneAmber
class node_pose_analysis,node_skeleton,node_gemini,node_gemini_api,node_youtube,node_export toneMint
class node_web_pose,node_web_model,node_downloader toneRose
```

## Components

### App experience

- [App entry](https://github.com/insect-cs/workout_tracking_app/blob/main/lib/main.dart): `lib/main.dart`
- [Main shell](https://github.com/insect-cs/workout_tracking_app/blob/main/lib/screens/main_shell.dart): `lib/screens/main_shell.dart`
- [Home](https://github.com/insect-cs/workout_tracking_app/blob/main/lib/screens/home_screen.dart): `lib/screens/home_screen.dart`
- [Theme controller](https://github.com/insect-cs/workout_tracking_app/blob/main/lib/theme/theme_controller.dart): `lib/theme/theme_controller.dart`
- [App theme](https://github.com/insect-cs/workout_tracking_app/blob/main/lib/theme/app_theme.dart): `lib/theme/app_theme.dart`

### Workout workflow

- [Workout input](https://github.com/insect-cs/workout_tracking_app/blob/main/lib/screens/workout_input_screen.dart): `lib/screens/workout_input_screen.dart`
- [Exercise logger](https://github.com/insect-cs/workout_tracking_app/blob/main/lib/screens/exercise_logger_screen.dart): `lib/screens/exercise_logger_screen.dart`
- [Pose tracking](https://github.com/insect-cs/workout_tracking_app/blob/main/lib/screens/pose_tracking_screen.dart): `lib/screens/pose_tracking_screen.dart`
- [Workout result](https://github.com/insect-cs/workout_tracking_app/blob/main/lib/screens/workout_result_screen.dart): `lib/screens/workout_result_screen.dart`
- [Saved workouts](https://github.com/insect-cs/workout_tracking_app/blob/main/lib/screens/saved_workouts_screen.dart): `lib/screens/saved_workouts_screen.dart`
- [Workout state](https://github.com/insect-cs/workout_tracking_app/blob/main/lib/state/workout_state.dart): `lib/state/workout_state.dart`
- [Workout models](https://github.com/insect-cs/workout_tracking_app/blob/main/lib/models/workout_models.dart): `lib/models/workout_models.dart`

### Analysis and integrations

- [Pose analysis](https://github.com/insect-cs/workout_tracking_app/blob/main/lib/services/pose_analysis_service.dart): `lib/services/pose_analysis_service.dart`
- [Skeleton painter](https://github.com/insect-cs/workout_tracking_app/blob/main/lib/widgets/pose_skeleton_painter.dart): `lib/widgets/pose_skeleton_painter.dart`
- [Gemini service](https://github.com/insect-cs/workout_tracking_app/blob/main/lib/services/gemini_service.dart): `lib/services/gemini_service.dart`
- **Gemini API**
- [YouTube service](https://github.com/insect-cs/workout_tracking_app/blob/main/lib/services/youtube_service.dart): `lib/services/youtube_service.dart`
- [Export service](https://github.com/insect-cs/workout_tracking_app/blob/main/lib/services/export_service.dart): `lib/services/export_service.dart`

### Platform support

- [Web pose adapter](https://github.com/insect-cs/workout_tracking_app/blob/main/lib/web/web_pose_web.dart): `lib/web/web_pose_web.dart`
- [MoveNet model](https://github.com/insect-cs/workout_tracking_app/blob/main/web/models/movenet_lightning/model.json): `web/models/movenet_lightning/model.json`
- [Web downloader](https://github.com/insect-cs/workout_tracking_app/blob/main/lib/web/file_downloader_web.dart): `lib/web/file_downloader_web.dart`

### Other components

- **User**

## Connections

- User → App entry: opens
- App entry → Main shell: starts
- Main shell → Home: shows
- User → Home: toggles theme (evidence: `README.md`)
- Home → Theme controller: switches (evidence: `README.md`)
- Theme controller → App theme: updates (evidence: `README.md`)
- Home → Workout input: starts workout
- Workout input → Exercise logger: records exercise
- Exercise logger → Pose tracking: tracks pose
- Pose tracking → Pose analysis: analyzes pose
- Pose analysis → Skeleton painter: draws pose
- Pose tracking → Web pose adapter: uses on web
- Web pose adapter → MoveNet model: loads model
- Exercise logger → Workout state: updates
- Workout input → Workout state: updates
- Workout state → Workout models: holds
- Workout state → Workout result: provides data
- Workout result → Saved workouts: saves workout
- Workout result → Gemini service: requests analysis
- Gemini service → Gemini API: calls
- Workout result → YouTube service: requests videos
- Workout result → Export service: exports
- Export service → Web downloader: downloads on web
