# erikafdahl/liftingtracker architecture

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

- Interactive diagram: https://gitdiagram.com/erikafdahl/liftingtracker
- Repository: https://github.com/erikafdahl/liftingtracker

## Overview

L.S.D. is a Flask workout-tracking app: lifters manage programs, log sets, and review recommendations and progress. Its main runtime is concentrated in `lsdApp.py`, which contains account handling and the workout, program, log, settings, comparison, and analytics features; `db.py` provides Supabase access. The README documents major features whose route implementations were not sampled, so those are represented at the app-module level. Edges are limited to documented rendering and storage relationships; the database schema is not included.

Main entry points: [`db.py`](https://github.com/erikafdahl/liftingtracker/blob/main/db.py) (Data access), [`lsdApp.py`](https://github.com/erikafdahl/liftingtracker/blob/main/lsdApp.py) (Run workout), [`templates`](https://github.com/erikafdahl/liftingtracker/tree/main/templates) (HTML views)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_users["Lifters"]
  node_lifter(("Lifter"))
end

subgraph group_workouts["Workout tracking"]
  node_programs["Program management<br/>[lsdApp.py]"]
  node_run["Run workout<br/>[lsdApp.py]"]
  node_recommendations["Recommendations<br/>[lsdApp.py]"]
  node_logging["Set logging<br/>[lsdApp.py]"]
  node_resume["Resume and indexing<br/>[lsdApp.py]"]
end

subgraph group_insights["Progress and insights"]
  node_comparison["Session comparison<br/>[lsdApp.py]"]
  node_analytics["Logs and charts<br/>[lsdApp.py]"]
end

subgraph group_platform["App and storage"]
  node_accounts["Accounts<br/>[lsdApp.py]"]
  node_settings["User settings<br/>[lsdApp.py]"]
  node_feedback["Feedback<br/>[lsdApp.py]"]
  node_templates["HTML views"]
  node_data_access["Data access<br/>[db.py]"]
  node_supabase[("Supabase database")]
end

node_lifter -->|"uses app"| node_accounts
node_accounts -.-> node_programs
node_accounts -.-> node_run
node_run -->|"calculates"| node_recommendations
node_run -.-> node_logging
node_run -->|"advances exercise"| node_resume
node_lifter -->|"compares sessions"| node_comparison
node_lifter -->|"reviews progress"| node_analytics
node_lifter -->|"configures"| node_settings
node_lifter -->|"submits feedback"| node_feedback
node_run -->|"renders run view"| node_templates
node_accounts -->|"reads and writes"| node_data_access
node_programs -->|"reads and writes"| node_data_access
node_run -->|"reads and writes"| node_data_access
node_comparison -.-> node_data_access
node_analytics -.-> node_data_access
node_settings -.-> node_data_access
node_feedback -.-> node_data_access
node_data_access -->|"queries"| node_supabase

click node_accounts "https://github.com/erikafdahl/liftingtracker/blob/main/lsdApp.py"
click node_programs "https://github.com/erikafdahl/liftingtracker/blob/main/lsdApp.py"
click node_run "https://github.com/erikafdahl/liftingtracker/blob/main/lsdApp.py"
click node_recommendations "https://github.com/erikafdahl/liftingtracker/blob/main/lsdApp.py"
click node_logging "https://github.com/erikafdahl/liftingtracker/blob/main/lsdApp.py"
click node_resume "https://github.com/erikafdahl/liftingtracker/blob/main/lsdApp.py"
click node_comparison "https://github.com/erikafdahl/liftingtracker/blob/main/lsdApp.py"
click node_analytics "https://github.com/erikafdahl/liftingtracker/blob/main/lsdApp.py"
click node_settings "https://github.com/erikafdahl/liftingtracker/blob/main/lsdApp.py"
click node_feedback "https://github.com/erikafdahl/liftingtracker/blob/main/lsdApp.py"
click node_templates "https://github.com/erikafdahl/liftingtracker/tree/main/templates"
click node_data_access "https://github.com/erikafdahl/liftingtracker/blob/main/db.py"

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_lifter toneBlue
class node_programs,node_run,node_recommendations,node_logging,node_resume toneAmber
class node_comparison,node_analytics toneMint
class node_accounts,node_settings,node_feedback,node_templates,node_data_access,node_supabase toneRose
```

## Components

### Lifters

- **Lifter**

### Workout tracking

- [Program management](https://github.com/erikafdahl/liftingtracker/blob/main/lsdApp.py): `lsdApp.py`
- [Run workout](https://github.com/erikafdahl/liftingtracker/blob/main/lsdApp.py): `lsdApp.py`
- [Recommendations](https://github.com/erikafdahl/liftingtracker/blob/main/lsdApp.py): `lsdApp.py`
- [Set logging](https://github.com/erikafdahl/liftingtracker/blob/main/lsdApp.py): `lsdApp.py`
- [Resume and indexing](https://github.com/erikafdahl/liftingtracker/blob/main/lsdApp.py): `lsdApp.py`

### Progress and insights

- [Session comparison](https://github.com/erikafdahl/liftingtracker/blob/main/lsdApp.py): `lsdApp.py`
- [Logs and charts](https://github.com/erikafdahl/liftingtracker/blob/main/lsdApp.py): `lsdApp.py`

### App and storage

- [Accounts](https://github.com/erikafdahl/liftingtracker/blob/main/lsdApp.py): `lsdApp.py`
- [User settings](https://github.com/erikafdahl/liftingtracker/blob/main/lsdApp.py): `lsdApp.py`
- [Feedback](https://github.com/erikafdahl/liftingtracker/blob/main/lsdApp.py): `lsdApp.py`
- [HTML views](https://github.com/erikafdahl/liftingtracker/tree/main/templates): `templates`
- [Data access](https://github.com/erikafdahl/liftingtracker/blob/main/db.py): `db.py`
- **Supabase database**

## Connections

- Lifter → Accounts: uses app (evidence: `README.md`)
- Accounts → Program management (evidence: `lsdApp.py`)
- Accounts → Run workout (evidence: `lsdApp.py`)
- Run workout → Recommendations: calculates (evidence: `lsdApp.py`)
- Run workout → Set logging (evidence: `lsdApp.py`)
- Run workout → Resume and indexing: advances exercise (evidence: `lsdApp.py`)
- Lifter → Session comparison: compares sessions (evidence: `README.md`)
- Lifter → Logs and charts: reviews progress (evidence: `README.md`)
- Lifter → User settings: configures (evidence: `README.md`)
- Lifter → Feedback: submits feedback (evidence: `README.md`)
- Run workout → HTML views: renders run view (evidence: `lsdApp.py`)
- Accounts → Data access: reads and writes (evidence: `lsdApp.py`)
- Program management → Data access: reads and writes (evidence: `lsdApp.py`)
- Run workout → Data access: reads and writes (evidence: `lsdApp.py`)
- Session comparison → Data access (evidence: `lsdApp.py`)
- Logs and charts → Data access (evidence: `lsdApp.py`)
- User settings → Data access (evidence: `lsdApp.py`)
- Feedback → Data access (evidence: `lsdApp.py`)
- Data access → Supabase database: queries (evidence: `db.py`)
