# bhuvanchebrolu/foodloop_frontend architecture

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

- Interactive diagram: https://gitdiagram.com/bhuvanchebrolu/foodloop_frontend
- Repository: https://github.com/bhuvanchebrolu/foodloop_frontend

## Overview

FoodLoop is a React application for managing household food and coordinating food sharing. Users authenticate, enter the protected app, and work with pantry items; they can also share food, manage requests, and view alerts and analytics. Administrative screens cover users, apartments, shares, and reports. The frontend uses service modules to make authenticated API requests, with a separate Firebase messaging path for push notifications. The README is a Vite template and documents no product capabilities; this map reflects the supplied source index and excerpts, so backend behavior is not described.

Main entry points: [`src/routes/AppRoutes.jsx`](https://github.com/bhuvanchebrolu/foodloop_frontend/blob/main/src/routes/AppRoutes.jsx) (Route dispatch), [`src/services/api.js`](https://github.com/bhuvanchebrolu/foodloop_frontend/blob/main/src/services/api.js) (HTTP client), [`src/pages/HomePage.jsx`](https://github.com/bhuvanchebrolu/foodloop_frontend/blob/main/src/pages/HomePage.jsx) (Pantry dashboard), [`src/hooks/useAuth.js`](https://github.com/bhuvanchebrolu/foodloop_frontend/blob/main/src/hooks/useAuth.js) (Auth hook)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Application and identity"]
  node_routes["Route dispatch<br/>[AppRoutes.jsx]"]
  node_auth_context["Session state<br/>[AuthContext.jsx]"]
  node_auth_hook["Auth hook<br/>[useAuth.js]"]
  node_login["Sign in<br/>[LoginPage.jsx]"]
  node_profile["Profile settings<br/>[ProfilePage.jsx]"]
end

subgraph group_pantry["Pantry management"]
  node_home["Pantry dashboard<br/>[HomePage.jsx]"]
  node_food_hook["Food state<br/>[useFoods.js]"]
  node_food_entry["Add food<br/>[AddFoodPage.jsx]"]
  node_food_service["Food operations<br/>[foodService.js]"]
  node_consumption_service["Consumption records"]
  node_waste_service["Waste records<br/>[wasteService.js]"]
  node_alerts["Food alerts<br/>[AlertsPage.jsx]"]
end

subgraph group_sharing["Community sharing"]
  node_share_entry["Publish food<br/>[ShareFoodPage.jsx]"]
  node_community["Community feed<br/>[CommunityPage.jsx]"]
  node_share_service["Sharing operations<br/>[shareService.js]"]
  node_report_service["Community reports<br/>[reportService.js]"]
end

subgraph group_operations["Insights and administration"]
  node_analytics["Analytics<br/>[AnalyticsPage.jsx]"]
  node_admin["Admin console<br/>[AdminPage.jsx]"]
  node_admin_service["Admin operations<br/>[adminService.js]"]
end

subgraph group_platform["API and notifications"]
  node_api["HTTP client<br/>[api.js]"]
  node_auth_service["Authentication API<br/>[authService.js]"]
  node_user_service["User API<br/>[userService.js]"]
  node_messaging["Push messaging<br/>[messaging.js]"]
  node_device_service["Device registration<br/>[deviceService.js]"]
end

node_backend[("Application backend")]
node_firebase["Firebase messaging"]

node_routes -->|"routes to"| node_login
node_routes -->|"routes to"| node_home
node_routes -->|"routes to"| node_food_entry
node_routes -->|"routes to"| node_alerts
node_routes -->|"routes to"| node_share_entry
node_routes -->|"routes to"| node_community
node_routes -->|"routes to"| node_profile
node_routes -->|"routes to"| node_analytics
node_routes -->|"routes to"| node_admin
node_login -->|"uses"| node_auth_hook
node_auth_hook -->|"reads"| node_auth_context
node_auth_context -->|"authenticates with"| node_auth_service
node_auth_context -->|"loads settings"| node_user_service
node_profile -->|"uses"| node_auth_hook
node_profile -->|"configures push"| node_messaging
node_home -->|"uses"| node_auth_hook
node_home -->|"loads pantry"| node_food_hook
node_food_hook -->|"fetches and changes"| node_food_service
node_food_entry -->|"edits pantry"| node_food_hook
node_home -->|"records consumption"| node_consumption_service
node_home -->|"records waste"| node_waste_service
node_alerts -->|"uses"| node_consumption_service
node_alerts -->|"uses"| node_waste_service
node_alerts -->|"uses"| node_food_service
node_share_entry -->|"loads food"| node_food_service
node_share_entry -->|"publishes shares"| node_share_service
node_community -->|"manages requests"| node_share_service
node_community -->|"submits reports"| node_report_service
node_community -->|"uses"| node_auth_hook
node_analytics -.->|"loads analytics"| node_backend
node_admin -->|"manages platform"| node_admin_service
node_food_service -->|"sends requests"| node_api
node_consumption_service -->|"sends requests"| node_api
node_waste_service -->|"sends requests"| node_api
node_share_service -->|"sends requests"| node_api
node_report_service -->|"sends requests"| node_api
node_admin_service -->|"sends requests"| node_api
node_auth_service -->|"sends requests"| node_api
node_user_service -->|"sends requests"| node_api
node_api -->|"HTTP requests"| node_backend
node_messaging -->|"registers token"| node_device_service
node_device_service -->|"sends requests"| node_api
node_messaging -->|"uses messaging"| node_firebase

click node_routes "https://github.com/bhuvanchebrolu/foodloop_frontend/blob/main/src/routes/AppRoutes.jsx"
click node_auth_context "https://github.com/bhuvanchebrolu/foodloop_frontend/blob/main/src/contexts/AuthContext.jsx"
click node_auth_hook "https://github.com/bhuvanchebrolu/foodloop_frontend/blob/main/src/hooks/useAuth.js"
click node_login "https://github.com/bhuvanchebrolu/foodloop_frontend/blob/main/src/pages/LoginPage.jsx"
click node_profile "https://github.com/bhuvanchebrolu/foodloop_frontend/blob/main/src/pages/ProfilePage.jsx"
click node_home "https://github.com/bhuvanchebrolu/foodloop_frontend/blob/main/src/pages/HomePage.jsx"
click node_food_hook "https://github.com/bhuvanchebrolu/foodloop_frontend/blob/main/src/hooks/useFoods.js"
click node_food_entry "https://github.com/bhuvanchebrolu/foodloop_frontend/blob/main/src/pages/AddFoodPage.jsx"
click node_food_service "https://github.com/bhuvanchebrolu/foodloop_frontend/blob/main/src/services/foodService.js"
click node_consumption_service "https://github.com/bhuvanchebrolu/foodloop_frontend/blob/main/src/services/consumptionService.js"
click node_waste_service "https://github.com/bhuvanchebrolu/foodloop_frontend/blob/main/src/services/wasteService.js"
click node_alerts "https://github.com/bhuvanchebrolu/foodloop_frontend/blob/main/src/pages/AlertsPage.jsx"
click node_share_entry "https://github.com/bhuvanchebrolu/foodloop_frontend/blob/main/src/pages/ShareFoodPage.jsx"
click node_community "https://github.com/bhuvanchebrolu/foodloop_frontend/blob/main/src/pages/CommunityPage.jsx"
click node_share_service "https://github.com/bhuvanchebrolu/foodloop_frontend/blob/main/src/services/shareService.js"
click node_report_service "https://github.com/bhuvanchebrolu/foodloop_frontend/blob/main/src/services/reportService.js"
click node_analytics "https://github.com/bhuvanchebrolu/foodloop_frontend/blob/main/src/pages/AnalyticsPage.jsx"
click node_admin "https://github.com/bhuvanchebrolu/foodloop_frontend/blob/main/src/pages/AdminPage.jsx"
click node_admin_service "https://github.com/bhuvanchebrolu/foodloop_frontend/blob/main/src/services/adminService.js"
click node_api "https://github.com/bhuvanchebrolu/foodloop_frontend/blob/main/src/services/api.js"
click node_auth_service "https://github.com/bhuvanchebrolu/foodloop_frontend/blob/main/src/services/authService.js"
click node_user_service "https://github.com/bhuvanchebrolu/foodloop_frontend/blob/main/src/services/userService.js"
click node_messaging "https://github.com/bhuvanchebrolu/foodloop_frontend/blob/main/src/firebase/messaging.js"
click node_device_service "https://github.com/bhuvanchebrolu/foodloop_frontend/blob/main/src/services/deviceService.js"

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_routes,node_auth_context,node_auth_hook,node_login,node_profile toneBlue
class node_home,node_food_hook,node_food_entry,node_food_service,node_consumption_service,node_waste_service,node_alerts,node_backend toneAmber
class node_share_entry,node_community,node_share_service,node_report_service toneMint
class node_analytics,node_admin,node_admin_service toneRose
class node_api,node_auth_service,node_user_service,node_messaging,node_device_service,node_firebase toneIndigo
```

## Components

### Application and identity

- [Route dispatch](https://github.com/bhuvanchebrolu/foodloop_frontend/blob/main/src/routes/AppRoutes.jsx): `src/routes/AppRoutes.jsx`
- [Session state](https://github.com/bhuvanchebrolu/foodloop_frontend/blob/main/src/contexts/AuthContext.jsx): `src/contexts/AuthContext.jsx`
- [Auth hook](https://github.com/bhuvanchebrolu/foodloop_frontend/blob/main/src/hooks/useAuth.js): `src/hooks/useAuth.js`
- [Sign in](https://github.com/bhuvanchebrolu/foodloop_frontend/blob/main/src/pages/LoginPage.jsx): `src/pages/LoginPage.jsx`
- [Profile settings](https://github.com/bhuvanchebrolu/foodloop_frontend/blob/main/src/pages/ProfilePage.jsx): `src/pages/ProfilePage.jsx`

### Pantry management

- [Pantry dashboard](https://github.com/bhuvanchebrolu/foodloop_frontend/blob/main/src/pages/HomePage.jsx): `src/pages/HomePage.jsx`
- [Food state](https://github.com/bhuvanchebrolu/foodloop_frontend/blob/main/src/hooks/useFoods.js): `src/hooks/useFoods.js`
- [Add food](https://github.com/bhuvanchebrolu/foodloop_frontend/blob/main/src/pages/AddFoodPage.jsx): `src/pages/AddFoodPage.jsx`
- [Food operations](https://github.com/bhuvanchebrolu/foodloop_frontend/blob/main/src/services/foodService.js): `src/services/foodService.js`
- [Consumption records](https://github.com/bhuvanchebrolu/foodloop_frontend/blob/main/src/services/consumptionService.js): `src/services/consumptionService.js`
- [Waste records](https://github.com/bhuvanchebrolu/foodloop_frontend/blob/main/src/services/wasteService.js): `src/services/wasteService.js`
- [Food alerts](https://github.com/bhuvanchebrolu/foodloop_frontend/blob/main/src/pages/AlertsPage.jsx): `src/pages/AlertsPage.jsx`

### Community sharing

- [Publish food](https://github.com/bhuvanchebrolu/foodloop_frontend/blob/main/src/pages/ShareFoodPage.jsx): `src/pages/ShareFoodPage.jsx`
- [Community feed](https://github.com/bhuvanchebrolu/foodloop_frontend/blob/main/src/pages/CommunityPage.jsx): `src/pages/CommunityPage.jsx`
- [Sharing operations](https://github.com/bhuvanchebrolu/foodloop_frontend/blob/main/src/services/shareService.js): `src/services/shareService.js`
- [Community reports](https://github.com/bhuvanchebrolu/foodloop_frontend/blob/main/src/services/reportService.js): `src/services/reportService.js`

### Insights and administration

- [Analytics](https://github.com/bhuvanchebrolu/foodloop_frontend/blob/main/src/pages/AnalyticsPage.jsx): `src/pages/AnalyticsPage.jsx`
- [Admin console](https://github.com/bhuvanchebrolu/foodloop_frontend/blob/main/src/pages/AdminPage.jsx): `src/pages/AdminPage.jsx`
- [Admin operations](https://github.com/bhuvanchebrolu/foodloop_frontend/blob/main/src/services/adminService.js): `src/services/adminService.js`

### API and notifications

- [HTTP client](https://github.com/bhuvanchebrolu/foodloop_frontend/blob/main/src/services/api.js): `src/services/api.js`
- [Authentication API](https://github.com/bhuvanchebrolu/foodloop_frontend/blob/main/src/services/authService.js): `src/services/authService.js`
- [User API](https://github.com/bhuvanchebrolu/foodloop_frontend/blob/main/src/services/userService.js): `src/services/userService.js`
- [Push messaging](https://github.com/bhuvanchebrolu/foodloop_frontend/blob/main/src/firebase/messaging.js): `src/firebase/messaging.js`
- [Device registration](https://github.com/bhuvanchebrolu/foodloop_frontend/blob/main/src/services/deviceService.js): `src/services/deviceService.js`

### Other components

- **Application backend**
- **Firebase messaging**

## Connections

- Route dispatch → Sign in: routes to (evidence: `src/routes/AppRoutes.jsx`)
- Route dispatch → Pantry dashboard: routes to (evidence: `src/routes/AppRoutes.jsx`)
- Route dispatch → Add food: routes to (evidence: `src/routes/AppRoutes.jsx`)
- Route dispatch → Food alerts: routes to (evidence: `src/routes/AppRoutes.jsx`)
- Route dispatch → Publish food: routes to (evidence: `src/routes/AppRoutes.jsx`)
- Route dispatch → Community feed: routes to (evidence: `src/routes/AppRoutes.jsx`)
- Route dispatch → Profile settings: routes to (evidence: `src/routes/AppRoutes.jsx`)
- Route dispatch → Analytics: routes to (evidence: `src/routes/AppRoutes.jsx`)
- Route dispatch → Admin console: routes to (evidence: `src/routes/AppRoutes.jsx`)
- Sign in → Auth hook: uses (evidence: `src/pages/LoginPage.jsx`)
- Auth hook → Session state: reads (evidence: `src/hooks/useAuth.js`)
- Session state → Authentication API: authenticates with (evidence: `src/contexts/AuthContext.jsx`)
- Session state → User API: loads settings (evidence: `src/contexts/AuthContext.jsx`)
- Profile settings → Auth hook: uses (evidence: `src/pages/ProfilePage.jsx`)
- Profile settings → Push messaging: configures push (evidence: `src/pages/ProfilePage.jsx`)
- Pantry dashboard → Auth hook: uses (evidence: `src/pages/HomePage.jsx`)
- Pantry dashboard → Food state: loads pantry (evidence: `src/pages/HomePage.jsx`)
- Food state → Food operations: fetches and changes (evidence: `src/hooks/useFoods.js`)
- Add food → Food state: edits pantry (evidence: `src/pages/AddFoodPage.jsx`)
- Pantry dashboard → Consumption records: records consumption (evidence: `src/pages/HomePage.jsx`)
- Pantry dashboard → Waste records: records waste (evidence: `src/pages/HomePage.jsx`)
- Food alerts → Consumption records: uses (evidence: `src/pages/AlertsPage.jsx`)
- Food alerts → Waste records: uses (evidence: `src/pages/AlertsPage.jsx`)
- Food alerts → Food operations: uses (evidence: `src/pages/AlertsPage.jsx`)
- Publish food → Food operations: loads food (evidence: `src/pages/ShareFoodPage.jsx`)
- Publish food → Sharing operations: publishes shares (evidence: `src/pages/ShareFoodPage.jsx`)
- Community feed → Sharing operations: manages requests (evidence: `src/pages/CommunityPage.jsx`)
- Community feed → Community reports: submits reports (evidence: `src/pages/CommunityPage.jsx`)
- Community feed → Auth hook: uses (evidence: `src/pages/CommunityPage.jsx`)
- Analytics → Application backend: loads analytics
- Admin console → Admin operations: manages platform (evidence: `src/pages/AdminPage.jsx`)
- Food operations → HTTP client: sends requests (evidence: `src/services/foodService.js`)
- Consumption records → HTTP client: sends requests (evidence: `src/services/consumptionService.js`)
- Waste records → HTTP client: sends requests (evidence: `src/services/wasteService.js`)
- Sharing operations → HTTP client: sends requests (evidence: `src/services/shareService.js`)
- Community reports → HTTP client: sends requests (evidence: `src/services/reportService.js`)
- Admin operations → HTTP client: sends requests (evidence: `src/services/adminService.js`)
- Authentication API → HTTP client: sends requests (evidence: `src/services/authService.js`)
- User API → HTTP client: sends requests (evidence: `src/services/userService.js`)
- HTTP client → Application backend: HTTP requests (evidence: `src/services/api.js`)
- Push messaging → Device registration: registers token (evidence: `src/firebase/messaging.js`)
- Device registration → HTTP client: sends requests (evidence: `src/services/deviceService.js`)
- Push messaging → Firebase messaging: uses messaging (evidence: `src/firebase/messaging.js`)
