# anepchidi/tyler-made-fitness architecture

> Architecture diagram of the GitHub repository anepchidi/tyler-made-fitness, 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/anepchidi/tyler-made-fitness
- Repository: https://github.com/anepchidi/tyler-made-fitness

## Overview

This is a workout and fitness tracking application: users sign in, record workouts, and review history and progress, with nutrition, templates, and social sharing as additional capabilities. The React app routes users to feature views through App and a shared API client; FastAPI routers handle feature requests and use SQLAlchemy models for persistence. The nutrition router also integrates with FatSecret. The README is empty, so feature scope comes from the source index and sampled code; unsampled frontend and router details are represented only where the index supports their existence, not speculative call paths.

Main entry points: [`frontend/src/App.jsx`](https://github.com/anepchidi/tyler-made-fitness/blob/main/frontend/src/App.jsx) (App navigation), [`backend/main.py`](https://github.com/anepchidi/tyler-made-fitness/blob/main/backend/main.py) (HTTP application), [`frontend/src/api/client.js`](https://github.com/anepchidi/tyler-made-fitness/blob/main/frontend/src/api/client.js) (API client), [`backend/dependencies.py`](https://github.com/anepchidi/tyler-made-fitness/blob/main/backend/dependencies.py) (Auth and DB dependencies)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Frontend"]
  node_app["App navigation<br/>[App.jsx]"]
  node_authview["Sign-in view<br/>[AuthPage.jsx]"]
  node_workoutui["Workout logging<br/>[WorkoutLogger.jsx]"]
  node_dashboard["Dashboard<br/>[Dashboard.jsx]"]
  node_history["Workout history<br/>[History.jsx]"]
  node_analytics["Exercise analytics"]
  node_templatesui["Workout templates<br/>[Templates.jsx]"]
  node_nutritionui["Nutrition tracking<br/>[Nutrition.jsx]"]
  node_profile["Profile settings<br/>[Profile.jsx]"]
  node_socialui["Social feed<br/>[SocialFeed.jsx]"]
  node_presets["Food presets<br/>[presets.js]"]
  node_client["API client<br/>[client.js]"]
end

subgraph group_api["Backend API"]
  node_server["HTTP application<br/>[main.py]"]
  node_auth["Authentication<br/>[auth.py]"]
  node_library["Exercise library<br/>[library.py]"]
  node_workouts["Workout records<br/>[workouts.py]"]
  node_templates["Template and progress<br/>[templates.py]"]
  node_nutrition["Nutrition service<br/>[nutrition.py]"]
  node_settings["Account settings<br/>[settings.py]"]
  node_social["Social features<br/>[social.py]"]
end

subgraph group_domain["Domain and persistence"]
  node_schemas["Request schemas<br/>[schemas.py]"]
  node_dependencies["Auth and DB dependencies<br/>[dependencies.py]"]
  node_models["Domain models<br/>[models.py]"]
  node_database[("Relational database<br/>[database.py]")]
  node_config["Runtime configuration<br/>[config.py]"]
end

subgraph group_integrations["External services"]
  node_fatsecret{{"FatSecret API"}}
end

node_user(("User"))

node_user -->|"uses"| node_app
node_app -->|"renders"| node_authview
node_app -->|"renders"| node_dashboard
node_app -->|"renders"| node_workoutui
node_app -->|"renders"| node_history
node_app -->|"renders"| node_analytics
node_app -->|"renders"| node_templatesui
node_app -->|"renders"| node_nutritionui
node_app -->|"renders"| node_profile
node_app -->|"renders"| node_socialui
node_app -->|"loads library and history"| node_client
node_authview -->|"requests auth"| node_client
node_workoutui -->|"requests data"| node_client
node_history -->|"requests data"| node_client
node_analytics -->|"requests data"| node_client
node_templatesui -->|"requests data"| node_client
node_nutritionui -->|"requests data"| node_client
node_nutritionui -->|"uses presets"| node_presets
node_profile -->|"requests data"| node_client
node_socialui -->|"requests data"| node_client
node_client -->|"sends HTTP requests"| node_server
node_server -->|"registers router"| node_auth
node_server -->|"registers router"| node_library
node_server -->|"registers router"| node_workouts
node_server -->|"registers router"| node_settings
node_server -->|"registers router"| node_templates
node_server -->|"registers router"| node_nutrition
node_server -->|"registers router"| node_social
node_server -->|"creates tables"| node_database
node_server -->|"loads settings"| node_config
node_server -->|"seeds exercise data"| node_library
node_auth -->|"creates token"| node_dependencies
node_auth -->|"validates input"| node_schemas
node_auth -->|"reads and writes users"| node_models
node_workouts -->|"requires user"| node_dependencies
node_workouts -->|"validates records"| node_schemas
node_workouts -->|"reads and writes"| node_models
node_templates -->|"requires user"| node_dependencies
node_templates -->|"validates and shapes"| node_schemas
node_templates -->|"reads and writes"| node_models
node_nutrition -->|"requires user"| node_dependencies
node_nutrition -->|"validates entries"| node_schemas
node_nutrition -->|"reads and writes"| node_models
node_nutrition -->|"queries foods"| node_fatsecret
node_social -->|"requires user"| node_dependencies
node_social -->|"shapes responses"| node_schemas
node_social -->|"reads and writes"| node_models
node_library -->|"requires DB"| node_dependencies

click node_app "https://github.com/anepchidi/tyler-made-fitness/blob/main/frontend/src/App.jsx"
click node_authview "https://github.com/anepchidi/tyler-made-fitness/blob/main/frontend/src/components/AuthPage.jsx"
click node_workoutui "https://github.com/anepchidi/tyler-made-fitness/blob/main/frontend/src/components/WorkoutLogger.jsx"
click node_dashboard "https://github.com/anepchidi/tyler-made-fitness/blob/main/frontend/src/components/Dashboard.jsx"
click node_history "https://github.com/anepchidi/tyler-made-fitness/blob/main/frontend/src/components/History.jsx"
click node_analytics "https://github.com/anepchidi/tyler-made-fitness/blob/main/frontend/src/components/ExerciseAnalytics.jsx"
click node_templatesui "https://github.com/anepchidi/tyler-made-fitness/blob/main/frontend/src/components/Templates.jsx"
click node_nutritionui "https://github.com/anepchidi/tyler-made-fitness/blob/main/frontend/src/components/Nutrition.jsx"
click node_profile "https://github.com/anepchidi/tyler-made-fitness/blob/main/frontend/src/components/Profile.jsx"
click node_socialui "https://github.com/anepchidi/tyler-made-fitness/blob/main/frontend/src/components/SocialFeed.jsx"
click node_presets "https://github.com/anepchidi/tyler-made-fitness/blob/main/frontend/src/data/presets.js"
click node_client "https://github.com/anepchidi/tyler-made-fitness/blob/main/frontend/src/api/client.js"
click node_server "https://github.com/anepchidi/tyler-made-fitness/blob/main/backend/main.py"
click node_auth "https://github.com/anepchidi/tyler-made-fitness/blob/main/backend/routers/auth.py"
click node_library "https://github.com/anepchidi/tyler-made-fitness/blob/main/backend/routers/library.py"
click node_workouts "https://github.com/anepchidi/tyler-made-fitness/blob/main/backend/routers/workouts.py"
click node_templates "https://github.com/anepchidi/tyler-made-fitness/blob/main/backend/routers/templates.py"
click node_nutrition "https://github.com/anepchidi/tyler-made-fitness/blob/main/backend/routers/nutrition.py"
click node_settings "https://github.com/anepchidi/tyler-made-fitness/blob/main/backend/routers/settings.py"
click node_social "https://github.com/anepchidi/tyler-made-fitness/blob/main/backend/routers/social.py"
click node_schemas "https://github.com/anepchidi/tyler-made-fitness/blob/main/backend/schemas.py"
click node_dependencies "https://github.com/anepchidi/tyler-made-fitness/blob/main/backend/dependencies.py"
click node_models "https://github.com/anepchidi/tyler-made-fitness/blob/main/backend/models.py"
click node_database "https://github.com/anepchidi/tyler-made-fitness/blob/main/backend/database.py"
click node_config "https://github.com/anepchidi/tyler-made-fitness/blob/main/backend/config.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_app,node_authview,node_workoutui,node_dashboard,node_history,node_analytics,node_templatesui,node_nutritionui,node_profile,node_socialui,node_presets,node_client,node_user toneBlue
class node_server,node_auth,node_library,node_workouts,node_templates,node_nutrition,node_settings,node_social toneAmber
class node_schemas,node_dependencies,node_models,node_database,node_config toneMint
class node_fatsecret toneRose
```

## Components

### Frontend

- [App navigation](https://github.com/anepchidi/tyler-made-fitness/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Sign-in view](https://github.com/anepchidi/tyler-made-fitness/blob/main/frontend/src/components/AuthPage.jsx): `frontend/src/components/AuthPage.jsx`
- [Workout logging](https://github.com/anepchidi/tyler-made-fitness/blob/main/frontend/src/components/WorkoutLogger.jsx): `frontend/src/components/WorkoutLogger.jsx`
- [Dashboard](https://github.com/anepchidi/tyler-made-fitness/blob/main/frontend/src/components/Dashboard.jsx): `frontend/src/components/Dashboard.jsx`
- [Workout history](https://github.com/anepchidi/tyler-made-fitness/blob/main/frontend/src/components/History.jsx): `frontend/src/components/History.jsx`
- [Exercise analytics](https://github.com/anepchidi/tyler-made-fitness/blob/main/frontend/src/components/ExerciseAnalytics.jsx): `frontend/src/components/ExerciseAnalytics.jsx`
- [Workout templates](https://github.com/anepchidi/tyler-made-fitness/blob/main/frontend/src/components/Templates.jsx): `frontend/src/components/Templates.jsx`
- [Nutrition tracking](https://github.com/anepchidi/tyler-made-fitness/blob/main/frontend/src/components/Nutrition.jsx): `frontend/src/components/Nutrition.jsx`
- [Profile settings](https://github.com/anepchidi/tyler-made-fitness/blob/main/frontend/src/components/Profile.jsx): `frontend/src/components/Profile.jsx`
- [Social feed](https://github.com/anepchidi/tyler-made-fitness/blob/main/frontend/src/components/SocialFeed.jsx): `frontend/src/components/SocialFeed.jsx`
- [Food presets](https://github.com/anepchidi/tyler-made-fitness/blob/main/frontend/src/data/presets.js): `frontend/src/data/presets.js`
- [API client](https://github.com/anepchidi/tyler-made-fitness/blob/main/frontend/src/api/client.js): `frontend/src/api/client.js`

### Backend API

- [HTTP application](https://github.com/anepchidi/tyler-made-fitness/blob/main/backend/main.py): `backend/main.py`
- [Authentication](https://github.com/anepchidi/tyler-made-fitness/blob/main/backend/routers/auth.py): `backend/routers/auth.py`
- [Exercise library](https://github.com/anepchidi/tyler-made-fitness/blob/main/backend/routers/library.py): `backend/routers/library.py`
- [Workout records](https://github.com/anepchidi/tyler-made-fitness/blob/main/backend/routers/workouts.py): `backend/routers/workouts.py`
- [Template and progress](https://github.com/anepchidi/tyler-made-fitness/blob/main/backend/routers/templates.py): `backend/routers/templates.py`
- [Nutrition service](https://github.com/anepchidi/tyler-made-fitness/blob/main/backend/routers/nutrition.py): `backend/routers/nutrition.py`
- [Account settings](https://github.com/anepchidi/tyler-made-fitness/blob/main/backend/routers/settings.py): `backend/routers/settings.py`
- [Social features](https://github.com/anepchidi/tyler-made-fitness/blob/main/backend/routers/social.py): `backend/routers/social.py`

### Domain and persistence

- [Request schemas](https://github.com/anepchidi/tyler-made-fitness/blob/main/backend/schemas.py): `backend/schemas.py`
- [Auth and DB dependencies](https://github.com/anepchidi/tyler-made-fitness/blob/main/backend/dependencies.py): `backend/dependencies.py`
- [Domain models](https://github.com/anepchidi/tyler-made-fitness/blob/main/backend/models.py): `backend/models.py`
- [Relational database](https://github.com/anepchidi/tyler-made-fitness/blob/main/backend/database.py): `backend/database.py`
- [Runtime configuration](https://github.com/anepchidi/tyler-made-fitness/blob/main/backend/config.py): `backend/config.py`

### External services

- **FatSecret API**

### Other components

- **User**

## Connections

- User → App navigation: uses (evidence: `frontend/src/App.jsx`)
- App navigation → Sign-in view: renders (evidence: `frontend/src/App.jsx`)
- App navigation → Dashboard: renders (evidence: `frontend/src/App.jsx`)
- App navigation → Workout logging: renders (evidence: `frontend/src/App.jsx`)
- App navigation → Workout history: renders (evidence: `frontend/src/App.jsx`)
- App navigation → Exercise analytics: renders (evidence: `frontend/src/App.jsx`)
- App navigation → Workout templates: renders (evidence: `frontend/src/App.jsx`)
- App navigation → Nutrition tracking: renders (evidence: `frontend/src/App.jsx`)
- App navigation → Profile settings: renders (evidence: `frontend/src/App.jsx`)
- App navigation → Social feed: renders (evidence: `frontend/src/App.jsx`)
- App navigation → API client: loads library and history (evidence: `frontend/src/App.jsx`)
- Sign-in view → API client: requests auth (evidence: `frontend/src/components/AuthPage.jsx`)
- Workout logging → API client: requests data (evidence: `frontend/src/api/client.js`)
- Workout history → API client: requests data (evidence: `frontend/src/components/History.jsx`)
- Exercise analytics → API client: requests data (evidence: `frontend/src/components/ExerciseAnalytics.jsx`)
- Workout templates → API client: requests data (evidence: `frontend/src/components/Templates.jsx`)
- Nutrition tracking → API client: requests data (evidence: `frontend/src/components/Nutrition.jsx`)
- Nutrition tracking → Food presets: uses presets (evidence: `frontend/src/components/Nutrition.jsx`)
- Profile settings → API client: requests data (evidence: `frontend/src/components/Profile.jsx`)
- Social feed → API client: requests data (evidence: `frontend/src/components/SocialFeed.jsx`)
- API client → HTTP application: sends HTTP requests (evidence: `frontend/src/api/client.js`)
- HTTP application → Authentication: registers router (evidence: `backend/main.py`)
- HTTP application → Exercise library: registers router (evidence: `backend/main.py`)
- HTTP application → Workout records: registers router (evidence: `backend/main.py`)
- HTTP application → Account settings: registers router (evidence: `backend/main.py`)
- HTTP application → Template and progress: registers router (evidence: `backend/main.py`)
- HTTP application → Nutrition service: registers router (evidence: `backend/main.py`)
- HTTP application → Social features: registers router (evidence: `backend/main.py`)
- HTTP application → Relational database: creates tables (evidence: `backend/main.py`)
- HTTP application → Runtime configuration: loads settings (evidence: `backend/main.py`)
- HTTP application → Exercise library: seeds exercise data (evidence: `backend/main.py`)
- Authentication → Auth and DB dependencies: creates token (evidence: `backend/routers/auth.py`)
- Authentication → Request schemas: validates input (evidence: `backend/routers/auth.py`)
- Authentication → Domain models: reads and writes users (evidence: `backend/routers/auth.py`)
- Workout records → Auth and DB dependencies: requires user (evidence: `backend/routers/workouts.py`)
- Workout records → Request schemas: validates records (evidence: `backend/routers/workouts.py`)
- Workout records → Domain models: reads and writes (evidence: `backend/routers/workouts.py`)
- Template and progress → Auth and DB dependencies: requires user (evidence: `backend/routers/templates.py`)
- Template and progress → Request schemas: validates and shapes (evidence: `backend/routers/templates.py`)
- Template and progress → Domain models: reads and writes (evidence: `backend/routers/templates.py`)
- Nutrition service → Auth and DB dependencies: requires user (evidence: `backend/routers/nutrition.py`)
- Nutrition service → Request schemas: validates entries (evidence: `backend/routers/nutrition.py`)
- Nutrition service → Domain models: reads and writes (evidence: `backend/routers/nutrition.py`)
- Nutrition service → FatSecret API: queries foods (evidence: `backend/routers/nutrition.py`)
- Social features → Auth and DB dependencies: requires user (evidence: `backend/routers/social.py`)
- Social features → Request schemas: shapes responses (evidence: `backend/routers/social.py`)
- Social features → Domain models: reads and writes (evidence: `backend/routers/social.py`)
- Exercise library → Auth and DB dependencies: requires DB (evidence: `backend/routers/library.py`)
