# aklenekar/gym-mermbership-react-demo architecture

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

- Interactive diagram: https://gitdiagram.com/aklenekar/gym-mermbership-react-demo
- Repository: https://github.com/aklenekar/gym-mermbership-react-demo

## Overview

This is a role-based gym management and fitness frontend: members sign in, use fitness and coaching tools, and manage their profiles; trainers and administrators access their own operational workflows. The React app routes users into those areas, while shared services make authenticated API requests. Major visible product branches include classes, workouts, progress, AI coaching, messaging, personal training, and gym administration. Source evidence is partial, so unsampled feature relationships are shown only where route wiring in App.jsx supports them; no backend internals are inferred.

Main entry points: [`src/App.jsx`](https://github.com/aklenekar/gym-mermbership-react-demo/blob/main/src/App.jsx) (Application router), [`src/services/Services.js`](https://github.com/aklenekar/gym-mermbership-react-demo/blob/main/src/services/Services.js) (API service layer), [`src/components/AICoach`](https://github.com/aklenekar/gym-mermbership-react-demo/tree/main/src/components/AICoach) (AI coach pages), [`src/routes/LoginPage.jsx`](https://github.com/aklenekar/gym-mermbership-react-demo/blob/main/src/routes/LoginPage.jsx) (Login flow)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["App and access"]
  node_app["Application router<br/>[App.jsx]"]
  node_layout["Root layout<br/>[RootLayout.jsx]"]
  node_login["Login flow<br/>[LoginPage.jsx]"]
end

subgraph group_member["Member fitness"]
  node_member_routes["Member routes<br/>[UserDashboard.jsx]"]
  node_profile["Member profile<br/>[UserProfile.jsx]"]
  node_workouts["Workout tracking"]
  node_progress["Fitness progress"]
  node_classes["Class discovery"]
  node_training["Personal training"]
  node_chat["User messaging<br/>[Chat.jsx]"]
end

subgraph group_coach["AI coaching"]
  node_coach_routes["AI coach pages"]
  node_class_plan["Class plan modal"]
  node_workout_plan["Workout plan modal"]
  node_nutrition_plan["Nutrition plan modal"]
  node_ai_chat["Floating AI chat<br/>[FloatingAiChat.jsx]"]
end

subgraph group_staff["Staff operations"]
  node_admin_routes["Admin routes"]
  node_reports["Management reports<br/>[ManageReport.jsx]"]
  node_equipment["Equipment maintenance"]
  node_payroll["Payroll management<br/>[ManagePayroll.jsx]"]
  node_trainer_routes["Trainer routes"]
end

subgraph group_shared["Shared services"]
  node_auth["Token and roles<br/>[auth.js]"]
  node_services["API service layer<br/>[Services.js]"]
end

node_visitor(("Visitor / user"))
node_api{{"Gym API"}}

node_visitor -->|"opens"| node_app
node_app -->|"routes through"| node_layout
node_app -->|"routes to"| node_login
node_app -->|"routes to"| node_member_routes
node_app -->|"routes to"| node_admin_routes
node_app -->|"routes to"| node_trainer_routes
node_app -->|"routes to"| node_coach_routes
node_login -->|"authenticates against"| node_api
node_login -->|"stores credentials"| node_auth
node_app -->|"checks access"| node_auth
node_layout -->|"renders"| node_ai_chat
node_profile -->|"loads profile"| node_services
node_services -->|"requests data"| node_api
node_services -->|"gets token"| node_auth
node_coach_routes -->|"renders"| node_class_plan
node_coach_routes -->|"renders"| node_workout_plan
node_coach_routes -->|"renders"| node_nutrition_plan
node_coach_routes -->|"requests recommendations"| node_services
node_ai_chat -->|"uses API"| node_services
node_reports -->|"fetches reports"| node_services
node_equipment -->|"loads maintenance"| node_services
node_payroll -->|"uses API"| node_services
node_trainer_routes -.->|"uses API"| node_services

click node_app "https://github.com/aklenekar/gym-mermbership-react-demo/blob/main/src/App.jsx"
click node_layout "https://github.com/aklenekar/gym-mermbership-react-demo/blob/main/src/routes/RootLayout.jsx"
click node_login "https://github.com/aklenekar/gym-mermbership-react-demo/blob/main/src/routes/LoginPage.jsx"
click node_auth "https://github.com/aklenekar/gym-mermbership-react-demo/blob/main/src/util/auth.js"
click node_services "https://github.com/aklenekar/gym-mermbership-react-demo/blob/main/src/services/Services.js"
click node_member_routes "https://github.com/aklenekar/gym-mermbership-react-demo/blob/main/src/routes/UserDashboard.jsx"
click node_profile "https://github.com/aklenekar/gym-mermbership-react-demo/blob/main/src/components/profile/UserProfile.jsx"
click node_workouts "https://github.com/aklenekar/gym-mermbership-react-demo/tree/main/src/components/workouts"
click node_progress "https://github.com/aklenekar/gym-mermbership-react-demo/tree/main/src/components/progress"
click node_classes "https://github.com/aklenekar/gym-mermbership-react-demo/tree/main/src/components/classes"
click node_training "https://github.com/aklenekar/gym-mermbership-react-demo/tree/main/src/components/personaltraining"
click node_coach_routes "https://github.com/aklenekar/gym-mermbership-react-demo/tree/main/src/components/AICoach"
click node_class_plan "https://github.com/aklenekar/gym-mermbership-react-demo/blob/main/src/components/AICoach/ClassesPlanModal.jsx"
click node_workout_plan "https://github.com/aklenekar/gym-mermbership-react-demo/blob/main/src/components/AICoach/WorkoutPlanModal.jsx"
click node_nutrition_plan "https://github.com/aklenekar/gym-mermbership-react-demo/blob/main/src/components/AICoach/NutritionPlanModal.jsx"
click node_ai_chat "https://github.com/aklenekar/gym-mermbership-react-demo/blob/main/src/components/AICoach/FloatingAiChat.jsx"
click node_admin_routes "https://github.com/aklenekar/gym-mermbership-react-demo/blob/main/src/routes/AdminDashboardPage.jsx"
click node_reports "https://github.com/aklenekar/gym-mermbership-react-demo/blob/main/src/components/reports/ManageReport.jsx"
click node_equipment "https://github.com/aklenekar/gym-mermbership-react-demo/blob/main/src/components/equipment/MaintenanceSchedule.jsx"
click node_payroll "https://github.com/aklenekar/gym-mermbership-react-demo/blob/main/src/components/payroll/ManagePayroll.jsx"
click node_trainer_routes "https://github.com/aklenekar/gym-mermbership-react-demo/blob/main/src/routes/TrainerDashboardPage.jsx"
click node_chat "https://github.com/aklenekar/gym-mermbership-react-demo/blob/main/src/components/chat/Chat.jsx"

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_layout,node_login,node_visitor toneBlue
class node_member_routes,node_profile,node_workouts,node_progress,node_classes,node_training,node_chat toneAmber
class node_coach_routes,node_class_plan,node_workout_plan,node_nutrition_plan,node_ai_chat,node_api toneMint
class node_admin_routes,node_reports,node_equipment,node_payroll,node_trainer_routes toneRose
class node_auth,node_services toneIndigo
```

## Components

### App and access

- [Application router](https://github.com/aklenekar/gym-mermbership-react-demo/blob/main/src/App.jsx): `src/App.jsx`
- [Root layout](https://github.com/aklenekar/gym-mermbership-react-demo/blob/main/src/routes/RootLayout.jsx): `src/routes/RootLayout.jsx`
- [Login flow](https://github.com/aklenekar/gym-mermbership-react-demo/blob/main/src/routes/LoginPage.jsx): `src/routes/LoginPage.jsx`

### Member fitness

- [Member routes](https://github.com/aklenekar/gym-mermbership-react-demo/blob/main/src/routes/UserDashboard.jsx): `src/routes/UserDashboard.jsx`
- [Member profile](https://github.com/aklenekar/gym-mermbership-react-demo/blob/main/src/components/profile/UserProfile.jsx): `src/components/profile/UserProfile.jsx`
- [Workout tracking](https://github.com/aklenekar/gym-mermbership-react-demo/tree/main/src/components/workouts): `src/components/workouts`
- [Fitness progress](https://github.com/aklenekar/gym-mermbership-react-demo/tree/main/src/components/progress): `src/components/progress`
- [Class discovery](https://github.com/aklenekar/gym-mermbership-react-demo/tree/main/src/components/classes): `src/components/classes`
- [Personal training](https://github.com/aklenekar/gym-mermbership-react-demo/tree/main/src/components/personaltraining): `src/components/personaltraining`
- [User messaging](https://github.com/aklenekar/gym-mermbership-react-demo/blob/main/src/components/chat/Chat.jsx): `src/components/chat/Chat.jsx`

### AI coaching

- [AI coach pages](https://github.com/aklenekar/gym-mermbership-react-demo/tree/main/src/components/AICoach): `src/components/AICoach`
- [Class plan modal](https://github.com/aklenekar/gym-mermbership-react-demo/blob/main/src/components/AICoach/ClassesPlanModal.jsx): `src/components/AICoach/ClassesPlanModal.jsx`
- [Workout plan modal](https://github.com/aklenekar/gym-mermbership-react-demo/blob/main/src/components/AICoach/WorkoutPlanModal.jsx): `src/components/AICoach/WorkoutPlanModal.jsx`
- [Nutrition plan modal](https://github.com/aklenekar/gym-mermbership-react-demo/blob/main/src/components/AICoach/NutritionPlanModal.jsx): `src/components/AICoach/NutritionPlanModal.jsx`
- [Floating AI chat](https://github.com/aklenekar/gym-mermbership-react-demo/blob/main/src/components/AICoach/FloatingAiChat.jsx): `src/components/AICoach/FloatingAiChat.jsx`

### Staff operations

- [Admin routes](https://github.com/aklenekar/gym-mermbership-react-demo/blob/main/src/routes/AdminDashboardPage.jsx): `src/routes/AdminDashboardPage.jsx`
- [Management reports](https://github.com/aklenekar/gym-mermbership-react-demo/blob/main/src/components/reports/ManageReport.jsx): `src/components/reports/ManageReport.jsx`
- [Equipment maintenance](https://github.com/aklenekar/gym-mermbership-react-demo/blob/main/src/components/equipment/MaintenanceSchedule.jsx): `src/components/equipment/MaintenanceSchedule.jsx`
- [Payroll management](https://github.com/aklenekar/gym-mermbership-react-demo/blob/main/src/components/payroll/ManagePayroll.jsx): `src/components/payroll/ManagePayroll.jsx`
- [Trainer routes](https://github.com/aklenekar/gym-mermbership-react-demo/blob/main/src/routes/TrainerDashboardPage.jsx): `src/routes/TrainerDashboardPage.jsx`

### Shared services

- [Token and roles](https://github.com/aklenekar/gym-mermbership-react-demo/blob/main/src/util/auth.js): `src/util/auth.js`
- [API service layer](https://github.com/aklenekar/gym-mermbership-react-demo/blob/main/src/services/Services.js): `src/services/Services.js`

### Other components

- **Visitor / user**
- **Gym API**

## Connections

- Visitor / user → Application router: opens
- Application router → Root layout: routes through (evidence: `src/App.jsx`)
- Application router → Login flow: routes to (evidence: `src/App.jsx`)
- Application router → Member routes: routes to (evidence: `src/App.jsx`)
- Application router → Admin routes: routes to (evidence: `src/App.jsx`)
- Application router → Trainer routes: routes to (evidence: `src/App.jsx`)
- Application router → AI coach pages: routes to (evidence: `src/App.jsx`)
- Login flow → Gym API: authenticates against (evidence: `src/routes/LoginPage.jsx`)
- Login flow → Token and roles: stores credentials (evidence: `src/routes/LoginPage.jsx`)
- Application router → Token and roles: checks access (evidence: `src/App.jsx`)
- Root layout → Floating AI chat: renders (evidence: `src/routes/RootLayout.jsx`)
- Member profile → API service layer: loads profile (evidence: `src/components/profile/UserProfile.jsx`)
- API service layer → Gym API: requests data (evidence: `src/services/Services.js`)
- API service layer → Token and roles: gets token (evidence: `src/services/Services.js`)
- AI coach pages → Class plan modal: renders (evidence: `src/components/AICoach/ClassRecommendationsPage.jsx`)
- AI coach pages → Workout plan modal: renders (evidence: `src/components/AICoach/WorkoutPlanPage.jsx`)
- AI coach pages → Nutrition plan modal: renders (evidence: `src/components/AICoach/NutritionPlanPage.jsx`)
- AI coach pages → API service layer: requests recommendations (evidence: `src/components/AICoach/ClassRecommendationsPage.jsx`)
- Floating AI chat → API service layer: uses API (evidence: `src/components/AICoach/FloatingAiChat.jsx`)
- Management reports → API service layer: fetches reports (evidence: `src/components/reports/ManageReport.jsx`)
- Equipment maintenance → API service layer: loads maintenance (evidence: `src/components/equipment/MaintenanceSchedule.jsx`)
- Payroll management → API service layer: uses API (evidence: `src/components/payroll/ManagePayroll.jsx`)
- Trainer routes → API service layer: uses API
