# biswalanish2005-ops/fittrack architecture

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

- Interactive diagram: https://gitdiagram.com/biswalanish2005-ops/fittrack
- Repository: https://github.com/biswalanish2005-ops/fittrack

## Overview

FitTrack AI is a personal fitness and nutrition tracker. Users register or sign in, then use protected app pages to log food, set goals, and review health and progress data. The frontend routes these experiences through shared authentication and Firebase-backed data access; nutrition search and barcode scanning add external food-data lookups, while diet recommendations use Gemini. The README describes local setup rather than product capabilities, so feature coverage and relationships rely on the source index and the excerpts provided; unsampled implementation details are not inferred.

Main entry points: [`src/App.tsx`](https://github.com/biswalanish2005-ops/fittrack/blob/main/src/App.tsx) (App router), [`src/context/AuthContext.tsx`](https://github.com/biswalanish2005-ops/fittrack/blob/main/src/context/AuthContext.tsx) (Auth context), [`src/lib/db.ts`](https://github.com/biswalanish2005-ops/fittrack/blob/main/src/lib/db.ts) (Fitness data access), [`src/pages/NutritionTracker.tsx`](https://github.com/biswalanish2005-ops/fittrack/blob/main/src/pages/NutritionTracker.tsx) (Nutrition tracker)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["App experience"]
  node_app["App router<br/>[App.tsx]"]
  node_navbar["Navigation<br/>[Navbar.tsx]"]
  node_landing["Landing page<br/>[Landing.tsx]"]
  node_login["Login<br/>[Login.tsx]"]
  node_register["Registration<br/>[Register.tsx]"]
  node_profile["Profile<br/>[Profile.tsx]"]
  node_theme["Theme state<br/>[ThemeContext.tsx]"]
end

subgraph group_health["Health tracking"]
  node_dashboard["Dashboard<br/>[Dashboard.tsx]"]
  node_tracker["Nutrition tracker"]
  node_goals["Goal planner<br/>[GoalPlanner.tsx]"]
  node_diet["Diet recommendations"]
  node_progress["Progress photos<br/>[ProgressPhotos.tsx]"]
  node_analytics["Analytics<br/>[Analytics.tsx]"]
  node_motivation["Daily motivation"]
end

subgraph group_platform["Identity and data"]
  node_authctx["Auth context<br/>[AuthContext.tsx]"]
  node_db["Fitness data access<br/>[db.ts]"]
  node_firebase["Firebase client<br/>[firebase.ts]"]
  node_firestore[("Firestore")]
end

subgraph group_integrations["Nutrition integrations"]
  node_foodsearch["Food search<br/>[FoodSearch.tsx]"]
  node_scanner["Barcode scanner<br/>[BarcodeScanner.tsx]"]
  node_nutritioncard["Nutrition card<br/>[NutritionCard.tsx]"]
  node_nutritionapi["Nutrition API client<br/>[nutritionApi.ts]"]
  node_api["Nutrition search endpoint<br/>[server.ts]"]
  node_usda["USDA FoodData"]
  node_off["Open Food Facts"]
  node_gemini["Gemini client<br/>[gemini.ts]"]
  node_geminiservice["Gemini service"]
end

node_user(("User"))

node_user -->|"opens app"| node_app
node_app -->|"renders"| node_navbar
node_app -->|"routes to"| node_landing
node_app -->|"routes to"| node_login
node_app -->|"routes to"| node_register
node_app -->|"routes to"| node_dashboard
node_app -->|"routes to"| node_tracker
node_app -->|"routes to"| node_goals
node_app -->|"routes to"| node_diet
node_app -->|"routes to"| node_progress
node_app -->|"routes to"| node_analytics
node_app -->|"routes to"| node_profile
node_app -->|"provides"| node_theme
node_app -->|"provides"| node_authctx
node_navbar -->|"reads and toggles"| node_theme
node_login -->|"uses"| node_authctx
node_register -->|"uses"| node_authctx
node_profile -->|"uses"| node_authctx
node_authctx -->|"uses auth and database"| node_firebase
node_authctx -->|"reads and writes users"| node_firestore
node_dashboard -->|"loads tracking data"| node_db
node_dashboard -->|"renders"| node_motivation
node_goals -->|"loads and saves goals"| node_db
node_analytics -->|"loads recent logs"| node_db
node_db -->|"uses database client"| node_firebase
node_db -->|"reads and writes tracking data"| node_firestore
node_tracker -->|"renders"| node_foodsearch
node_tracker -->|"renders"| node_scanner
node_tracker -->|"reads and writes meals"| node_firestore
node_foodsearch -->|"renders results"| node_nutritioncard
node_foodsearch -->|"checks and saves cache"| node_firestore
node_foodsearch -->|"requests search"| node_api
node_api -->|"uses"| node_nutritionapi
node_nutritionapi -->|"searches foods"| node_usda
node_scanner -->|"looks up barcode"| node_nutritionapi
node_nutritionapi -->|"fetches product data"| node_off
node_scanner -->|"checks and saves cache"| node_firestore
node_diet -->|"requests recommendations"| node_gemini
node_gemini -.->|"calls model service"| node_geminiservice
node_progress -.->|"uses storage client"| node_firebase

click node_app "https://github.com/biswalanish2005-ops/fittrack/blob/main/src/App.tsx"
click node_navbar "https://github.com/biswalanish2005-ops/fittrack/blob/main/src/components/layout/Navbar.tsx"
click node_landing "https://github.com/biswalanish2005-ops/fittrack/blob/main/src/pages/Landing.tsx"
click node_login "https://github.com/biswalanish2005-ops/fittrack/blob/main/src/pages/Login.tsx"
click node_register "https://github.com/biswalanish2005-ops/fittrack/blob/main/src/pages/Register.tsx"
click node_profile "https://github.com/biswalanish2005-ops/fittrack/blob/main/src/pages/Profile.tsx"
click node_theme "https://github.com/biswalanish2005-ops/fittrack/blob/main/src/context/ThemeContext.tsx"
click node_dashboard "https://github.com/biswalanish2005-ops/fittrack/blob/main/src/pages/Dashboard.tsx"
click node_tracker "https://github.com/biswalanish2005-ops/fittrack/blob/main/src/pages/NutritionTracker.tsx"
click node_goals "https://github.com/biswalanish2005-ops/fittrack/blob/main/src/pages/GoalPlanner.tsx"
click node_diet "https://github.com/biswalanish2005-ops/fittrack/blob/main/src/pages/DietRecommendation.tsx"
click node_progress "https://github.com/biswalanish2005-ops/fittrack/blob/main/src/pages/ProgressPhotos.tsx"
click node_analytics "https://github.com/biswalanish2005-ops/fittrack/blob/main/src/pages/Analytics.tsx"
click node_motivation "https://github.com/biswalanish2005-ops/fittrack/blob/main/src/components/DailyMotivation.tsx"
click node_authctx "https://github.com/biswalanish2005-ops/fittrack/blob/main/src/context/AuthContext.tsx"
click node_db "https://github.com/biswalanish2005-ops/fittrack/blob/main/src/lib/db.ts"
click node_firebase "https://github.com/biswalanish2005-ops/fittrack/blob/main/src/lib/firebase.ts"
click node_foodsearch "https://github.com/biswalanish2005-ops/fittrack/blob/main/src/components/nutrition/FoodSearch.tsx"
click node_scanner "https://github.com/biswalanish2005-ops/fittrack/blob/main/src/components/nutrition/BarcodeScanner.tsx"
click node_nutritioncard "https://github.com/biswalanish2005-ops/fittrack/blob/main/src/components/nutrition/NutritionCard.tsx"
click node_nutritionapi "https://github.com/biswalanish2005-ops/fittrack/blob/main/src/lib/nutritionApi.ts"
click node_api "https://github.com/biswalanish2005-ops/fittrack/blob/main/server.ts"
click node_gemini "https://github.com/biswalanish2005-ops/fittrack/blob/main/src/lib/gemini.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_navbar,node_landing,node_login,node_register,node_profile,node_theme,node_user toneBlue
class node_dashboard,node_tracker,node_goals,node_diet,node_progress,node_analytics,node_motivation toneAmber
class node_authctx,node_db,node_firebase,node_firestore toneMint
class node_foodsearch,node_scanner,node_nutritioncard,node_nutritionapi,node_api,node_usda,node_off,node_gemini,node_geminiservice toneRose
```

## Components

### App experience

- [App router](https://github.com/biswalanish2005-ops/fittrack/blob/main/src/App.tsx): `src/App.tsx`
- [Navigation](https://github.com/biswalanish2005-ops/fittrack/blob/main/src/components/layout/Navbar.tsx): `src/components/layout/Navbar.tsx`
- [Landing page](https://github.com/biswalanish2005-ops/fittrack/blob/main/src/pages/Landing.tsx): `src/pages/Landing.tsx`
- [Login](https://github.com/biswalanish2005-ops/fittrack/blob/main/src/pages/Login.tsx): `src/pages/Login.tsx`
- [Registration](https://github.com/biswalanish2005-ops/fittrack/blob/main/src/pages/Register.tsx): `src/pages/Register.tsx`
- [Profile](https://github.com/biswalanish2005-ops/fittrack/blob/main/src/pages/Profile.tsx): `src/pages/Profile.tsx`
- [Theme state](https://github.com/biswalanish2005-ops/fittrack/blob/main/src/context/ThemeContext.tsx): `src/context/ThemeContext.tsx`

### Health tracking

- [Dashboard](https://github.com/biswalanish2005-ops/fittrack/blob/main/src/pages/Dashboard.tsx): `src/pages/Dashboard.tsx`
- [Nutrition tracker](https://github.com/biswalanish2005-ops/fittrack/blob/main/src/pages/NutritionTracker.tsx): `src/pages/NutritionTracker.tsx`
- [Goal planner](https://github.com/biswalanish2005-ops/fittrack/blob/main/src/pages/GoalPlanner.tsx): `src/pages/GoalPlanner.tsx`
- [Diet recommendations](https://github.com/biswalanish2005-ops/fittrack/blob/main/src/pages/DietRecommendation.tsx): `src/pages/DietRecommendation.tsx`
- [Progress photos](https://github.com/biswalanish2005-ops/fittrack/blob/main/src/pages/ProgressPhotos.tsx): `src/pages/ProgressPhotos.tsx`
- [Analytics](https://github.com/biswalanish2005-ops/fittrack/blob/main/src/pages/Analytics.tsx): `src/pages/Analytics.tsx`
- [Daily motivation](https://github.com/biswalanish2005-ops/fittrack/blob/main/src/components/DailyMotivation.tsx): `src/components/DailyMotivation.tsx`

### Identity and data

- [Auth context](https://github.com/biswalanish2005-ops/fittrack/blob/main/src/context/AuthContext.tsx): `src/context/AuthContext.tsx`
- [Fitness data access](https://github.com/biswalanish2005-ops/fittrack/blob/main/src/lib/db.ts): `src/lib/db.ts`
- [Firebase client](https://github.com/biswalanish2005-ops/fittrack/blob/main/src/lib/firebase.ts): `src/lib/firebase.ts`
- **Firestore**

### Nutrition integrations

- [Food search](https://github.com/biswalanish2005-ops/fittrack/blob/main/src/components/nutrition/FoodSearch.tsx): `src/components/nutrition/FoodSearch.tsx`
- [Barcode scanner](https://github.com/biswalanish2005-ops/fittrack/blob/main/src/components/nutrition/BarcodeScanner.tsx): `src/components/nutrition/BarcodeScanner.tsx`
- [Nutrition card](https://github.com/biswalanish2005-ops/fittrack/blob/main/src/components/nutrition/NutritionCard.tsx): `src/components/nutrition/NutritionCard.tsx`
- [Nutrition API client](https://github.com/biswalanish2005-ops/fittrack/blob/main/src/lib/nutritionApi.ts): `src/lib/nutritionApi.ts`
- [Nutrition search endpoint](https://github.com/biswalanish2005-ops/fittrack/blob/main/server.ts): `server.ts`
- **USDA FoodData**
- **Open Food Facts**
- [Gemini client](https://github.com/biswalanish2005-ops/fittrack/blob/main/src/lib/gemini.ts): `src/lib/gemini.ts`
- **Gemini service**

### Other components

- **User**

## Connections

- User → App router: opens app (evidence: `src/App.tsx`)
- App router → Navigation: renders (evidence: `src/App.tsx`)
- App router → Landing page: routes to (evidence: `src/App.tsx`)
- App router → Login: routes to (evidence: `src/App.tsx`)
- App router → Registration: routes to (evidence: `src/App.tsx`)
- App router → Dashboard: routes to (evidence: `src/App.tsx`)
- App router → Nutrition tracker: routes to (evidence: `src/App.tsx`)
- App router → Goal planner: routes to (evidence: `src/App.tsx`)
- App router → Diet recommendations: routes to (evidence: `src/App.tsx`)
- App router → Progress photos: routes to (evidence: `src/App.tsx`)
- App router → Analytics: routes to (evidence: `src/App.tsx`)
- App router → Profile: routes to (evidence: `src/App.tsx`)
- App router → Theme state: provides (evidence: `src/App.tsx`)
- App router → Auth context: provides (evidence: `src/App.tsx`)
- Navigation → Theme state: reads and toggles (evidence: `src/components/layout/Navbar.tsx`)
- Login → Auth context: uses (evidence: `src/pages/Login.tsx`)
- Registration → Auth context: uses (evidence: `src/pages/Register.tsx`)
- Profile → Auth context: uses (evidence: `src/pages/Profile.tsx`)
- Auth context → Firebase client: uses auth and database (evidence: `src/context/AuthContext.tsx`)
- Auth context → Firestore: reads and writes users (evidence: `src/context/AuthContext.tsx`)
- Dashboard → Fitness data access: loads tracking data (evidence: `src/pages/Dashboard.tsx`)
- Dashboard → Daily motivation: renders (evidence: `src/pages/Dashboard.tsx`)
- Goal planner → Fitness data access: loads and saves goals (evidence: `src/pages/GoalPlanner.tsx`)
- Analytics → Fitness data access: loads recent logs (evidence: `src/pages/Analytics.tsx`)
- Fitness data access → Firebase client: uses database client (evidence: `src/lib/db.ts`)
- Fitness data access → Firestore: reads and writes tracking data (evidence: `src/lib/db.ts`)
- Nutrition tracker → Food search: renders (evidence: `src/pages/NutritionTracker.tsx`)
- Nutrition tracker → Barcode scanner: renders (evidence: `src/pages/NutritionTracker.tsx`)
- Nutrition tracker → Firestore: reads and writes meals (evidence: `src/pages/NutritionTracker.tsx`)
- Food search → Nutrition card: renders results (evidence: `src/components/nutrition/FoodSearch.tsx`)
- Food search → Firestore: checks and saves cache (evidence: `src/components/nutrition/FoodSearch.tsx`)
- Food search → Nutrition search endpoint: requests search (evidence: `src/components/nutrition/FoodSearch.tsx`)
- Nutrition search endpoint → Nutrition API client: uses (evidence: `server.ts`)
- Nutrition API client → USDA FoodData: searches foods (evidence: `src/lib/nutritionApi.ts`)
- Barcode scanner → Nutrition API client: looks up barcode (evidence: `src/components/nutrition/BarcodeScanner.tsx`)
- Nutrition API client → Open Food Facts: fetches product data (evidence: `src/lib/nutritionApi.ts`)
- Barcode scanner → Firestore: checks and saves cache (evidence: `src/components/nutrition/BarcodeScanner.tsx`)
- Diet recommendations → Gemini client: requests recommendations (evidence: `src/pages/DietRecommendation.tsx`)
- Gemini client → Gemini service: calls model service
- Progress photos → Firebase client: uses storage client (evidence: `src/pages/ProgressPhotos.tsx`)
