# aaryankasaudhan91-dev/mealers-connect architecture

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

- Interactive diagram: https://gitdiagram.com/aaryankasaudhan91-dev/mealers-connect
- Repository: https://github.com/aaryankasaudhan91-dev/mealers-connect

## Overview

Mealer connects donors, volunteers, and beneficiary organizations through a donation lifecycle: users authenticate, create or browse listings, coordinate pickup and delivery, and track impact. The React app is the main user-facing product; its storage service talks to an Express API backed by MongoDB. AI analysis, mapping, chat, verification, routing, and tracking support the core workflow. An Android app is also documented, but the sampled activity excerpt does not show its configured destination. Relationships involving unsampled subsystems are included only where the README or source index supports them.

Main entry points: [`Frontend/App.tsx`](https://github.com/aaryankasaudhan91-dev/mealers-connect/blob/master/Frontend/App.tsx) (Application shell), [`Frontend/services/storageService.ts`](https://github.com/aaryankasaudhan91-dev/mealers-connect/blob/master/Frontend/services/storageService.ts) (API client), [`Frontend/services/geminiService.ts`](https://github.com/aaryankasaudhan91-dev/mealers-connect/blob/master/Frontend/services/geminiService.ts) (Gemini services), [`Frontend/components/LoginPage.tsx`](https://github.com/aaryankasaudhan91-dev/mealers-connect/blob/master/Frontend/components/LoginPage.tsx) (Sign-in and roles)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["Web experience"]
  node_app["Application shell<br/>[App.tsx]"]
  node_auth["Sign-in and roles<br/>[LoginPage.tsx]"]
  node_profiles["Profiles and settings<br/>[ProfileView.tsx]"]
end

subgraph group_donations["Donation workflow"]
  node_create["Donation creation"]
  node_listing["Donation lifecycle<br/>[FoodCard.tsx]"]
  node_verification["Pickup verification"]
  node_rating["Delivery ratings<br/>[RatingModal.tsx]"]
end

subgraph group_coordination["Coordination and maps"]
  node_browse["Posting map<br/>[PostingsMap.tsx]"]
  node_tracking["Live tracking"]
  node_chat["Donation chat<br/>[ChatModal.tsx]"]
  node_radar["Predictive radar"]
  node_routing["Route planning"]
end

subgraph group_platform["Services and data"]
  node_api["REST API<br/>[server.js]"]
  node_storage["API client<br/>[storageService.ts]"]
  node_models["Data models<br/>[models.js]"]
  node_database[("MongoDB<br/>[db.js]")]
  node_ai["Gemini services<br/>[geminiService.ts]"]
  node_firebase["Firebase auth<br/>[firebaseConfig.ts]"]
end

subgraph group_mobile["Android app"]
  node_android["Android WebView app<br/>[MainActivity.kt]"]
  node_admob["AdMob integration<br/>[Admob.kt]"]
end

node_user(("Community users"))

node_user -->|"uses"| node_app
node_app -->|"shows"| node_auth
node_app -->|"opens"| node_create
node_app -->|"renders"| node_listing
node_app -->|"shows"| node_browse
node_app -->|"opens"| node_tracking
node_app -->|"opens"| node_chat
node_app -->|"renders"| node_radar
node_app -->|"opens"| node_routing
node_app -->|"opens"| node_verification
node_app -->|"opens"| node_rating
node_app -->|"shows"| node_profiles
node_auth -->|"authenticates with"| node_firebase
node_auth -->|"loads users"| node_storage
node_create -->|"checks safety"| node_ai
node_create -.->|"saves listing"| node_storage
node_listing -.->|"updates listing"| node_storage
node_listing -->|"requests insights"| node_ai
node_radar -.->|"forecasts hotspots"| node_ai
node_routing -->|"optimizes route"| node_ai
node_storage -->|"sends requests"| node_api
node_api -->|"uses models"| node_models
node_api -->|"connects"| node_database
node_database -.->|"stores records"| node_database
node_android -->|"initializes"| node_admob

click node_app "https://github.com/aaryankasaudhan91-dev/mealers-connect/blob/master/Frontend/App.tsx"
click node_auth "https://github.com/aaryankasaudhan91-dev/mealers-connect/blob/master/Frontend/components/LoginPage.tsx"
click node_profiles "https://github.com/aaryankasaudhan91-dev/mealers-connect/blob/master/Frontend/components/ProfileView.tsx"
click node_create "https://github.com/aaryankasaudhan91-dev/mealers-connect/blob/master/Frontend/components/AddDonationView.tsx"
click node_listing "https://github.com/aaryankasaudhan91-dev/mealers-connect/blob/master/Frontend/components/FoodCard.tsx"
click node_verification "https://github.com/aaryankasaudhan91-dev/mealers-connect/blob/master/Frontend/components/VerificationRequestModal.tsx"
click node_rating "https://github.com/aaryankasaudhan91-dev/mealers-connect/blob/master/Frontend/components/RatingModal.tsx"
click node_browse "https://github.com/aaryankasaudhan91-dev/mealers-connect/blob/master/Frontend/components/PostingsMap.tsx"
click node_tracking "https://github.com/aaryankasaudhan91-dev/mealers-connect/blob/master/Frontend/components/LiveTrackingModal.tsx"
click node_chat "https://github.com/aaryankasaudhan91-dev/mealers-connect/blob/master/Frontend/components/ChatModal.tsx"
click node_radar "https://github.com/aaryankasaudhan91-dev/mealers-connect/blob/master/Frontend/components/PredictiveRadarView.tsx"
click node_routing "https://github.com/aaryankasaudhan91-dev/mealers-connect/blob/master/Frontend/components/RoutePlannerModal.tsx"
click node_api "https://github.com/aaryankasaudhan91-dev/mealers-connect/blob/master/backend/server.js"
click node_storage "https://github.com/aaryankasaudhan91-dev/mealers-connect/blob/master/Frontend/services/storageService.ts"
click node_models "https://github.com/aaryankasaudhan91-dev/mealers-connect/blob/master/backend/models.js"
click node_database "https://github.com/aaryankasaudhan91-dev/mealers-connect/blob/master/backend/db.js"
click node_ai "https://github.com/aaryankasaudhan91-dev/mealers-connect/blob/master/Frontend/services/geminiService.ts"
click node_firebase "https://github.com/aaryankasaudhan91-dev/mealers-connect/blob/master/Frontend/services/firebaseConfig.ts"
click node_android "https://github.com/aaryankasaudhan91-dev/mealers-connect/blob/master/Mobile%20view/app/src/main/java/com/mealers/mealers/ui/MainActivity.kt"
click node_admob "https://github.com/aaryankasaudhan91-dev/mealers-connect/blob/master/Mobile%20view/app/src/main/java/com/mealers/mealers/ui/Admob.kt"

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_auth,node_profiles,node_user toneBlue
class node_create,node_listing,node_verification,node_rating toneAmber
class node_browse,node_tracking,node_chat,node_radar,node_routing toneMint
class node_api,node_storage,node_models,node_database,node_ai,node_firebase toneRose
class node_android,node_admob toneIndigo
```

## Components

### Web experience

- [Application shell](https://github.com/aaryankasaudhan91-dev/mealers-connect/blob/master/Frontend/App.tsx): `Frontend/App.tsx`
- [Sign-in and roles](https://github.com/aaryankasaudhan91-dev/mealers-connect/blob/master/Frontend/components/LoginPage.tsx): `Frontend/components/LoginPage.tsx`
- [Profiles and settings](https://github.com/aaryankasaudhan91-dev/mealers-connect/blob/master/Frontend/components/ProfileView.tsx): `Frontend/components/ProfileView.tsx`

### Donation workflow

- [Donation creation](https://github.com/aaryankasaudhan91-dev/mealers-connect/blob/master/Frontend/components/AddDonationView.tsx): `Frontend/components/AddDonationView.tsx`
- [Donation lifecycle](https://github.com/aaryankasaudhan91-dev/mealers-connect/blob/master/Frontend/components/FoodCard.tsx): `Frontend/components/FoodCard.tsx`
- [Pickup verification](https://github.com/aaryankasaudhan91-dev/mealers-connect/blob/master/Frontend/components/VerificationRequestModal.tsx): `Frontend/components/VerificationRequestModal.tsx`
- [Delivery ratings](https://github.com/aaryankasaudhan91-dev/mealers-connect/blob/master/Frontend/components/RatingModal.tsx): `Frontend/components/RatingModal.tsx`

### Coordination and maps

- [Posting map](https://github.com/aaryankasaudhan91-dev/mealers-connect/blob/master/Frontend/components/PostingsMap.tsx): `Frontend/components/PostingsMap.tsx`
- [Live tracking](https://github.com/aaryankasaudhan91-dev/mealers-connect/blob/master/Frontend/components/LiveTrackingModal.tsx): `Frontend/components/LiveTrackingModal.tsx`
- [Donation chat](https://github.com/aaryankasaudhan91-dev/mealers-connect/blob/master/Frontend/components/ChatModal.tsx): `Frontend/components/ChatModal.tsx`
- [Predictive radar](https://github.com/aaryankasaudhan91-dev/mealers-connect/blob/master/Frontend/components/PredictiveRadarView.tsx): `Frontend/components/PredictiveRadarView.tsx`
- [Route planning](https://github.com/aaryankasaudhan91-dev/mealers-connect/blob/master/Frontend/components/RoutePlannerModal.tsx): `Frontend/components/RoutePlannerModal.tsx`

### Services and data

- [REST API](https://github.com/aaryankasaudhan91-dev/mealers-connect/blob/master/backend/server.js): `backend/server.js`
- [API client](https://github.com/aaryankasaudhan91-dev/mealers-connect/blob/master/Frontend/services/storageService.ts): `Frontend/services/storageService.ts`
- [Data models](https://github.com/aaryankasaudhan91-dev/mealers-connect/blob/master/backend/models.js): `backend/models.js`
- [MongoDB](https://github.com/aaryankasaudhan91-dev/mealers-connect/blob/master/backend/db.js): `backend/db.js`
- [Gemini services](https://github.com/aaryankasaudhan91-dev/mealers-connect/blob/master/Frontend/services/geminiService.ts): `Frontend/services/geminiService.ts`
- [Firebase auth](https://github.com/aaryankasaudhan91-dev/mealers-connect/blob/master/Frontend/services/firebaseConfig.ts): `Frontend/services/firebaseConfig.ts`

### Android app

- [Android WebView app](https://github.com/aaryankasaudhan91-dev/mealers-connect/blob/master/Mobile%20view/app/src/main/java/com/mealers/mealers/ui/MainActivity.kt): `Mobile view/app/src/main/java/com/mealers/mealers/ui/MainActivity.kt`
- [AdMob integration](https://github.com/aaryankasaudhan91-dev/mealers-connect/blob/master/Mobile%20view/app/src/main/java/com/mealers/mealers/ui/Admob.kt): `Mobile view/app/src/main/java/com/mealers/mealers/ui/Admob.kt`

### Other components

- **Community users**

## Connections

- Community users → Application shell: uses
- Application shell → Sign-in and roles: shows (evidence: `Frontend/App.tsx`)
- Application shell → Donation creation: opens (evidence: `Frontend/App.tsx`)
- Application shell → Donation lifecycle: renders (evidence: `Frontend/App.tsx`)
- Application shell → Posting map: shows (evidence: `Frontend/App.tsx`)
- Application shell → Live tracking: opens (evidence: `Frontend/App.tsx`)
- Application shell → Donation chat: opens (evidence: `Frontend/App.tsx`)
- Application shell → Predictive radar: renders (evidence: `Frontend/App.tsx`)
- Application shell → Route planning: opens (evidence: `Frontend/App.tsx`)
- Application shell → Pickup verification: opens (evidence: `Frontend/App.tsx`)
- Application shell → Delivery ratings: opens (evidence: `Frontend/App.tsx`)
- Application shell → Profiles and settings: shows (evidence: `Frontend/App.tsx`)
- Sign-in and roles → Firebase auth: authenticates with (evidence: `Frontend/components/LoginPage.tsx`)
- Sign-in and roles → API client: loads users (evidence: `Frontend/components/LoginPage.tsx`)
- Donation creation → Gemini services: checks safety (evidence: `Frontend/components/AddDonationView.tsx`)
- Donation creation → API client: saves listing (evidence: `Frontend/components/AddDonationView.tsx`)
- Donation lifecycle → API client: updates listing (evidence: `Frontend/components/FoodCard.tsx`)
- Donation lifecycle → Gemini services: requests insights (evidence: `Frontend/components/FoodCard.tsx`)
- Predictive radar → Gemini services: forecasts hotspots (evidence: `Frontend/components/PredictiveRadarView.tsx`)
- Route planning → Gemini services: optimizes route (evidence: `Frontend/App.tsx`)
- API client → REST API: sends requests
- REST API → Data models: uses models (evidence: `backend/server.js`)
- REST API → MongoDB: connects (evidence: `backend/server.js`)
- MongoDB → MongoDB: stores records (evidence: `backend/db.js`)
- Android WebView app → AdMob integration: initializes (evidence: `Mobile view/app/src/main/java/com/mealers/mealers/ui/MainActivity.kt`)
