# vipusrihar/personal_wellness-fitness_tracker architecture

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

- Interactive diagram: https://gitdiagram.com/vipusrihar/personal_wellness-fitness_tracker
- Repository: https://github.com/vipusrihar/personal_wellness-fitness_tracker

## Overview

FitTrack is a browser-based personal wellness tracker whose principal workflow is signing in, recording daily health activity, and reviewing goals and trends. React routes users to separate calorie, hydration, workout, and progress stages; contexts hold session, profile, and achievement state, while services persist records in IndexedDB. The README also documents offline support, export/reset, and PWA behavior. Some feature links rely on README or SOURCE INDEX references because their source was not excerpted; uncertain implementation details are omitted.

Main entry points: [`src/AppRoutes.tsx`](https://github.com/vipusrihar/personal_wellness-fitness_tracker/blob/main/src/AppRoutes.tsx) (Route guards), [`src/database/db.ts`](https://github.com/vipusrihar/personal_wellness-fitness_tracker/blob/main/src/database/db.ts) (IndexedDB), [`src/pages/Dashboard.tsx`](https://github.com/vipusrihar/personal_wellness-fitness_tracker/blob/main/src/pages/Dashboard.tsx) (Daily dashboard), [`src/pages/Workouts.tsx`](https://github.com/vipusrihar/personal_wellness-fitness_tracker/blob/main/src/pages/Workouts.tsx) (Workout logger)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["App and navigation"]
  node_app["App providers<br/>[App.tsx]"]
  node_routes["Route guards<br/>[AppRoutes.tsx]"]
  node_home["Home<br/>[Home.tsx]"]
  node_settings["Settings and export<br/>[Settings.tsx]"]
end

subgraph group_tracking["Wellness tracking"]
  node_dashboard["Daily dashboard<br/>[Dashboard.tsx]"]
  node_calories["Calorie tracker<br/>[Calories.tsx]"]
  node_caloriesvc["Calorie service<br/>[calorieService.ts]"]
  node_hydration["Hydration tracker<br/>[Hydration.tsx]"]
  node_hydrationsvc["Hydration service"]
  node_workouts["Workout logger<br/>[Workouts.tsx]"]
  node_workoutsvc["Workout service<br/>[workoutService.ts]"]
  node_api["Quotes and exercises<br/>[apiService.ts]"]
end

subgraph group_insights["Progress and rewards"]
  node_progress["Progress charts<br/>[Progress.tsx]"]
  node_measurement["Measurements<br/>[measurement.ts]"]
  node_achievementctx["Achievement context"]
  node_achievementsvc["Achievement service"]
  node_badges["Badge definitions<br/>[badges.ts]"]
end

subgraph group_identity["Identity and profile"]
  node_authpage["Sign-in forms<br/>[Auth.tsx]"]
  node_auth["Session context<br/>[AuthContext.tsx]"]
  node_usersvc["User service<br/>[userService.ts]"]
  node_profilepage["Profile editor<br/>[Profile.tsx]"]
  node_profilectx["Profile context"]
  node_profilesvc["Profile service<br/>[profileService.ts]"]
  node_streaksvc["Streak service<br/>[streakService.ts]"]
end

subgraph group_storage["Persistence and integrations"]
  node_datasvc["Data operations<br/>[dataService.ts]"]
  node_syncqueue["Sync queue"]
  node_db[("IndexedDB<br/>[db.ts]")]
end

node_user(("User"))
node_externalapi["Public quote API"]

node_user -->|"uses"| node_routes
node_app -->|"renders"| node_routes
node_routes -->|"routes to"| node_home
node_routes -->|"routes to"| node_authpage
node_routes -->|"routes to"| node_dashboard
node_routes -->|"routes to"| node_calories
node_routes -->|"routes to"| node_hydration
node_routes -->|"routes to"| node_workouts
node_routes -->|"routes to"| node_progress
node_routes -->|"routes to"| node_profilepage
node_routes -->|"routes to"| node_settings
node_authpage -->|"authenticates"| node_auth
node_auth -->|"loads users"| node_usersvc
node_profilepage -->|"reads and updates"| node_profilectx
node_profilectx -->|"reads session"| node_auth
node_profilectx -->|"reads and writes"| node_profilesvc
node_profilectx -->|"loads streak"| node_streaksvc
node_dashboard -->|"reads totals"| node_caloriesvc
node_dashboard -->|"reads totals"| node_hydrationsvc
node_dashboard -->|"reads totals"| node_workoutsvc
node_dashboard -->|"loads quote"| node_api
node_api -->|"fetches quotes"| node_externalapi
node_calories -->|"records meals"| node_caloriesvc
node_hydration -.->|"records intake"| node_hydrationsvc
node_workouts -->|"records exercise"| node_workoutsvc
node_workouts -->|"searches exercises"| node_api
node_progress -->|"reads measurements"| node_measurement
node_progress -->|"reads history"| node_caloriesvc
node_progress -->|"reads history"| node_workoutsvc
node_achievementctx -->|"loads and unlocks"| node_achievementsvc
node_achievementctx -->|"uses definitions"| node_badges
node_calories -->|"unlocks badges"| node_achievementctx
node_workouts -->|"unlocks badges"| node_achievementctx
node_settings -.->|"exports and resets"| node_datasvc
node_caloriesvc -->|"reads and writes"| node_db
node_workoutsvc -->|"reads and writes"| node_db
node_hydrationsvc -->|"reads and writes"| node_db
node_profilesvc -->|"reads and writes"| node_db
node_usersvc -->|"reads and writes"| node_db
node_achievementsvc -->|"reads and writes"| node_db
node_measurement -.->|"reads and writes"| node_db
node_syncqueue -.->|"queues sync records"| node_db

click node_app "https://github.com/vipusrihar/personal_wellness-fitness_tracker/blob/main/src/App.tsx"
click node_routes "https://github.com/vipusrihar/personal_wellness-fitness_tracker/blob/main/src/AppRoutes.tsx"
click node_home "https://github.com/vipusrihar/personal_wellness-fitness_tracker/blob/main/src/pages/Home.tsx"
click node_authpage "https://github.com/vipusrihar/personal_wellness-fitness_tracker/blob/main/src/pages/Auth.tsx"
click node_auth "https://github.com/vipusrihar/personal_wellness-fitness_tracker/blob/main/src/contexts/AuthContext.tsx"
click node_usersvc "https://github.com/vipusrihar/personal_wellness-fitness_tracker/blob/main/src/services/userService.ts"
click node_profilepage "https://github.com/vipusrihar/personal_wellness-fitness_tracker/blob/main/src/pages/Profile.tsx"
click node_profilectx "https://github.com/vipusrihar/personal_wellness-fitness_tracker/blob/main/src/contexts/UserProfileContext.tsx"
click node_profilesvc "https://github.com/vipusrihar/personal_wellness-fitness_tracker/blob/main/src/services/profileService.ts"
click node_streaksvc "https://github.com/vipusrihar/personal_wellness-fitness_tracker/blob/main/src/services/streakService.ts"
click node_dashboard "https://github.com/vipusrihar/personal_wellness-fitness_tracker/blob/main/src/pages/Dashboard.tsx"
click node_calories "https://github.com/vipusrihar/personal_wellness-fitness_tracker/blob/main/src/pages/Calories.tsx"
click node_caloriesvc "https://github.com/vipusrihar/personal_wellness-fitness_tracker/blob/main/src/services/calorieService.ts"
click node_hydration "https://github.com/vipusrihar/personal_wellness-fitness_tracker/blob/main/src/pages/Hydration.tsx"
click node_hydrationsvc "https://github.com/vipusrihar/personal_wellness-fitness_tracker/blob/main/src/services/hydrationService.ts"
click node_workouts "https://github.com/vipusrihar/personal_wellness-fitness_tracker/blob/main/src/pages/Workouts.tsx"
click node_workoutsvc "https://github.com/vipusrihar/personal_wellness-fitness_tracker/blob/main/src/services/workoutService.ts"
click node_api "https://github.com/vipusrihar/personal_wellness-fitness_tracker/blob/main/src/services/apiService.ts"
click node_progress "https://github.com/vipusrihar/personal_wellness-fitness_tracker/blob/main/src/pages/Progress.tsx"
click node_measurement "https://github.com/vipusrihar/personal_wellness-fitness_tracker/blob/main/src/services/measurement.ts"
click node_achievementctx "https://github.com/vipusrihar/personal_wellness-fitness_tracker/blob/main/src/contexts/AchievementContext.tsx"
click node_achievementsvc "https://github.com/vipusrihar/personal_wellness-fitness_tracker/blob/main/src/services/achievementService.ts"
click node_badges "https://github.com/vipusrihar/personal_wellness-fitness_tracker/blob/main/src/constants/badges.ts"
click node_settings "https://github.com/vipusrihar/personal_wellness-fitness_tracker/blob/main/src/pages/Settings.tsx"
click node_datasvc "https://github.com/vipusrihar/personal_wellness-fitness_tracker/blob/main/src/services/dataService.ts"
click node_syncqueue "https://github.com/vipusrihar/personal_wellness-fitness_tracker/blob/main/src/services/SyncQueueService.ts"
click node_db "https://github.com/vipusrihar/personal_wellness-fitness_tracker/blob/main/src/database/db.ts"

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_routes,node_home,node_settings,node_user toneBlue
class node_dashboard,node_calories,node_caloriesvc,node_hydration,node_hydrationsvc,node_workouts,node_workoutsvc,node_api toneAmber
class node_progress,node_measurement,node_achievementctx,node_achievementsvc,node_badges,node_externalapi toneMint
class node_authpage,node_auth,node_usersvc,node_profilepage,node_profilectx,node_profilesvc,node_streaksvc toneRose
class node_datasvc,node_syncqueue,node_db toneIndigo
```

## Components

### App and navigation

- [App providers](https://github.com/vipusrihar/personal_wellness-fitness_tracker/blob/main/src/App.tsx): `src/App.tsx`
- [Route guards](https://github.com/vipusrihar/personal_wellness-fitness_tracker/blob/main/src/AppRoutes.tsx): `src/AppRoutes.tsx`
- [Home](https://github.com/vipusrihar/personal_wellness-fitness_tracker/blob/main/src/pages/Home.tsx): `src/pages/Home.tsx`
- [Settings and export](https://github.com/vipusrihar/personal_wellness-fitness_tracker/blob/main/src/pages/Settings.tsx): `src/pages/Settings.tsx`

### Wellness tracking

- [Daily dashboard](https://github.com/vipusrihar/personal_wellness-fitness_tracker/blob/main/src/pages/Dashboard.tsx): `src/pages/Dashboard.tsx`
- [Calorie tracker](https://github.com/vipusrihar/personal_wellness-fitness_tracker/blob/main/src/pages/Calories.tsx): `src/pages/Calories.tsx`
- [Calorie service](https://github.com/vipusrihar/personal_wellness-fitness_tracker/blob/main/src/services/calorieService.ts): `src/services/calorieService.ts`
- [Hydration tracker](https://github.com/vipusrihar/personal_wellness-fitness_tracker/blob/main/src/pages/Hydration.tsx): `src/pages/Hydration.tsx`
- [Hydration service](https://github.com/vipusrihar/personal_wellness-fitness_tracker/blob/main/src/services/hydrationService.ts): `src/services/hydrationService.ts`
- [Workout logger](https://github.com/vipusrihar/personal_wellness-fitness_tracker/blob/main/src/pages/Workouts.tsx): `src/pages/Workouts.tsx`
- [Workout service](https://github.com/vipusrihar/personal_wellness-fitness_tracker/blob/main/src/services/workoutService.ts): `src/services/workoutService.ts`
- [Quotes and exercises](https://github.com/vipusrihar/personal_wellness-fitness_tracker/blob/main/src/services/apiService.ts): `src/services/apiService.ts`

### Progress and rewards

- [Progress charts](https://github.com/vipusrihar/personal_wellness-fitness_tracker/blob/main/src/pages/Progress.tsx): `src/pages/Progress.tsx`
- [Measurements](https://github.com/vipusrihar/personal_wellness-fitness_tracker/blob/main/src/services/measurement.ts): `src/services/measurement.ts`
- [Achievement context](https://github.com/vipusrihar/personal_wellness-fitness_tracker/blob/main/src/contexts/AchievementContext.tsx): `src/contexts/AchievementContext.tsx`
- [Achievement service](https://github.com/vipusrihar/personal_wellness-fitness_tracker/blob/main/src/services/achievementService.ts): `src/services/achievementService.ts`
- [Badge definitions](https://github.com/vipusrihar/personal_wellness-fitness_tracker/blob/main/src/constants/badges.ts): `src/constants/badges.ts`

### Identity and profile

- [Sign-in forms](https://github.com/vipusrihar/personal_wellness-fitness_tracker/blob/main/src/pages/Auth.tsx): `src/pages/Auth.tsx`
- [Session context](https://github.com/vipusrihar/personal_wellness-fitness_tracker/blob/main/src/contexts/AuthContext.tsx): `src/contexts/AuthContext.tsx`
- [User service](https://github.com/vipusrihar/personal_wellness-fitness_tracker/blob/main/src/services/userService.ts): `src/services/userService.ts`
- [Profile editor](https://github.com/vipusrihar/personal_wellness-fitness_tracker/blob/main/src/pages/Profile.tsx): `src/pages/Profile.tsx`
- [Profile context](https://github.com/vipusrihar/personal_wellness-fitness_tracker/blob/main/src/contexts/UserProfileContext.tsx): `src/contexts/UserProfileContext.tsx`
- [Profile service](https://github.com/vipusrihar/personal_wellness-fitness_tracker/blob/main/src/services/profileService.ts): `src/services/profileService.ts`
- [Streak service](https://github.com/vipusrihar/personal_wellness-fitness_tracker/blob/main/src/services/streakService.ts): `src/services/streakService.ts`

### Persistence and integrations

- [Data operations](https://github.com/vipusrihar/personal_wellness-fitness_tracker/blob/main/src/services/dataService.ts): `src/services/dataService.ts`
- [Sync queue](https://github.com/vipusrihar/personal_wellness-fitness_tracker/blob/main/src/services/SyncQueueService.ts): `src/services/SyncQueueService.ts`
- [IndexedDB](https://github.com/vipusrihar/personal_wellness-fitness_tracker/blob/main/src/database/db.ts): `src/database/db.ts`

### Other components

- **User**
- **Public quote API**

## Connections

- User → Route guards: uses (evidence: `src/AppRoutes.tsx`)
- App providers → Route guards: renders (evidence: `src/App.tsx`)
- Route guards → Home: routes to (evidence: `src/AppRoutes.tsx`)
- Route guards → Sign-in forms: routes to (evidence: `src/AppRoutes.tsx`)
- Route guards → Daily dashboard: routes to (evidence: `src/AppRoutes.tsx`)
- Route guards → Calorie tracker: routes to (evidence: `src/AppRoutes.tsx`)
- Route guards → Hydration tracker: routes to (evidence: `src/AppRoutes.tsx`)
- Route guards → Workout logger: routes to (evidence: `src/AppRoutes.tsx`)
- Route guards → Progress charts: routes to (evidence: `src/AppRoutes.tsx`)
- Route guards → Profile editor: routes to (evidence: `src/AppRoutes.tsx`)
- Route guards → Settings and export: routes to (evidence: `src/AppRoutes.tsx`)
- Sign-in forms → Session context: authenticates (evidence: `src/pages/Auth.tsx`)
- Session context → User service: loads users (evidence: `src/contexts/AuthContext.tsx`)
- Profile editor → Profile context: reads and updates (evidence: `src/pages/Profile.tsx`)
- Profile context → Session context: reads session (evidence: `src/contexts/UserProfileContext.tsx`)
- Profile context → Profile service: reads and writes (evidence: `src/contexts/UserProfileContext.tsx`)
- Profile context → Streak service: loads streak (evidence: `src/contexts/UserProfileContext.tsx`)
- Daily dashboard → Calorie service: reads totals (evidence: `src/pages/Dashboard.tsx`)
- Daily dashboard → Hydration service: reads totals (evidence: `src/pages/Dashboard.tsx`)
- Daily dashboard → Workout service: reads totals (evidence: `src/pages/Dashboard.tsx`)
- Daily dashboard → Quotes and exercises: loads quote (evidence: `src/pages/Dashboard.tsx`)
- Quotes and exercises → Public quote API: fetches quotes (evidence: `src/services/apiService.ts`)
- Calorie tracker → Calorie service: records meals (evidence: `src/pages/Calories.tsx`)
- Hydration tracker → Hydration service: records intake (evidence: `README.md`)
- Workout logger → Workout service: records exercise (evidence: `src/pages/Workouts.tsx`)
- Workout logger → Quotes and exercises: searches exercises (evidence: `src/pages/Workouts.tsx`)
- Progress charts → Measurements: reads measurements (evidence: `src/pages/Progress.tsx`)
- Progress charts → Calorie service: reads history (evidence: `src/pages/Progress.tsx`)
- Progress charts → Workout service: reads history (evidence: `src/pages/Progress.tsx`)
- Achievement context → Achievement service: loads and unlocks (evidence: `src/contexts/AchievementContext.tsx`)
- Achievement context → Badge definitions: uses definitions (evidence: `src/contexts/AchievementContext.tsx`)
- Calorie tracker → Achievement context: unlocks badges (evidence: `src/pages/Calories.tsx`)
- Workout logger → Achievement context: unlocks badges (evidence: `src/pages/Workouts.tsx`)
- Settings and export → Data operations: exports and resets (evidence: `README.md`)
- Calorie service → IndexedDB: reads and writes (evidence: `src/services/calorieService.ts`)
- Workout service → IndexedDB: reads and writes (evidence: `src/services/workoutService.ts`)
- Hydration service → IndexedDB: reads and writes (evidence: `src/services/hydrationService.ts`)
- Profile service → IndexedDB: reads and writes (evidence: `src/services/profileService.ts`)
- User service → IndexedDB: reads and writes (evidence: `src/services/userService.ts`)
- Achievement service → IndexedDB: reads and writes (evidence: `src/services/achievementService.ts`)
- Measurements → IndexedDB: reads and writes
- Sync queue → IndexedDB: queues sync records (evidence: `README.md`)
