# barathiraja242005/arigoairguardpro architecture

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

- Interactive diagram: https://gitdiagram.com/barathiraja242005/arigoairguardpro
- Repository: https://github.com/barathiraja242005/arigoairguardpro

## Overview

AriGo AirGuard Pro is a web interface for device-based air-quality monitoring, alongside public pollution maps and NGO/admin views. The main user flow is landing page or login → role-gated dashboard → readings, alerts, and device controls; the map and chatbot provide additional ways to explore pollution information. Evidence is strongest for routing, authentication, map data, and selected settings/control integrations; several page internals and the cloud-function implementation were not excerpted, so those connections are omitted or marked unverified.

Main entry points: [`src/App.tsx`](https://github.com/barathiraja242005/arigoairguardpro/blob/main/src/App.tsx) (Web app routes), [`src/pages/AdminPollutionMap.tsx`](https://github.com/barathiraja242005/arigoairguardpro/blob/main/src/pages/AdminPollutionMap.tsx) (Admin pollution map), [`src/pages/NGODashboard.tsx`](https://github.com/barathiraja242005/arigoairguardpro/blob/main/src/pages/NGODashboard.tsx) (NGO dashboard), [`src/components/chat/AIChatbot.tsx`](https://github.com/barathiraja242005/arigoairguardpro/blob/main/src/components/chat/AIChatbot.tsx) (Pollution assistant)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["App and access"]
  node_app["Web app routes<br/>[App.tsx]"]
  node_auth["Session provider<br/>[AuthContext.tsx]"]
  node_role_guard["Role guard<br/>[RequireAuth.tsx]"]
  node_home["Landing page<br/>[Home.tsx]"]
  node_login["Sign-in pages<br/>[Login.tsx]"]
end

subgraph group_device["Device monitoring"]
  node_dashboard["Device dashboard<br/>[Dashboard.tsx]"]
  node_controls["Device controls<br/>[Controls.tsx]"]
  node_alerts["Safety alerts<br/>[Alerts.tsx]"]
  node_settings["Device settings<br/>[Settings.tsx]"]
  node_analytics_hook["Device analytics"]
end

subgraph group_pollution["Pollution intelligence"]
  node_admin_map_page["Admin pollution map"]
  node_ngo_dashboard["NGO dashboard<br/>[NGODashboard.tsx]"]
  node_pollution_map["Interactive pollution map<br/>[PollutionMap.tsx]"]
  node_map_sidebar["Map sidebar<br/>[MapSidebar.tsx]"]
  node_detail_panel["Map detail panel<br/>[DetailPanel.tsx]"]
  node_chatbot_global["Global chat launcher"]
  node_chatbot["Pollution assistant<br/>[AIChatbot.tsx]"]
end

subgraph group_services["Data and services"]
  node_demo_auth["Demo credentials<br/>[demoAuth.ts]"]
  node_state_data["State pollution data"]
  node_hotspots["Hotspot dataset"]
  node_ngo_data["NGO data<br/>[ngoData.ts]"]
  node_firebase["Firebase client<br/>[firebase.ts]"]
  node_airguard_db["Device data access<br/>[airguardDb.ts]"]
  node_cloud_functions["Alert cloud functions<br/>[index.ts]"]
end

node_visitor(("Visitor / user"))
node_twilio["Twilio"]

node_visitor -->|"opens"| node_app
node_app -->|"routes to"| node_home
node_app -->|"routes to"| node_login
node_app -->|"provides session"| node_auth
node_app -->|"guards routes"| node_role_guard
node_role_guard -->|"checks role"| node_auth
node_login -.->|"authenticates with"| node_demo_auth
node_auth -->|"uses role type"| node_demo_auth
node_demo_auth -->|"loads NGO credentials"| node_state_data
node_app -->|"routes to"| node_dashboard
node_app -->|"routes to"| node_controls
node_app -->|"routes to"| node_alerts
node_app -->|"routes to"| node_settings
node_controls -->|"uses analytics"| node_analytics_hook
node_analytics_hook -->|"uses client"| node_firebase
node_analytics_hook -->|"uses data access"| node_airguard_db
node_alerts -->|"uses client"| node_firebase
node_settings -->|"writes profile and devices"| node_firebase
node_settings -.->|"tests alert call"| node_cloud_functions
node_cloud_functions -.->|"places calls"| node_twilio
node_app -->|"routes to"| node_admin_map_page
node_app -->|"routes to"| node_ngo_dashboard
node_admin_map_page -->|"renders"| node_pollution_map
node_admin_map_page -->|"renders"| node_map_sidebar
node_admin_map_page -->|"renders"| node_detail_panel
node_admin_map_page -->|"renders"| node_chatbot
node_ngo_dashboard -->|"renders"| node_pollution_map
node_ngo_dashboard -->|"renders"| node_map_sidebar
node_ngo_dashboard -->|"renders"| node_detail_panel
node_ngo_dashboard -->|"renders"| node_chatbot
node_chatbot_global -->|"renders"| node_chatbot
node_chatbot -->|"looks up state"| node_state_data
node_pollution_map -->|"reads AQI colors"| node_state_data
node_admin_map_page -->|"uses hotspot data"| node_hotspots
node_admin_map_page -->|"uses NGO data"| node_ngo_data
node_ngo_dashboard -->|"uses hotspot data"| node_hotspots
node_ngo_dashboard -->|"uses NGO data"| node_ngo_data

click node_app "https://github.com/barathiraja242005/arigoairguardpro/blob/main/src/App.tsx"
click node_auth "https://github.com/barathiraja242005/arigoairguardpro/blob/main/src/contexts/AuthContext.tsx"
click node_role_guard "https://github.com/barathiraja242005/arigoairguardpro/blob/main/src/components/auth/RequireAuth.tsx"
click node_home "https://github.com/barathiraja242005/arigoairguardpro/blob/main/src/pages/Home.tsx"
click node_login "https://github.com/barathiraja242005/arigoairguardpro/blob/main/src/pages/Login.tsx"
click node_demo_auth "https://github.com/barathiraja242005/arigoairguardpro/blob/main/src/lib/demoAuth.ts"
click node_dashboard "https://github.com/barathiraja242005/arigoairguardpro/blob/main/src/pages/Dashboard.tsx"
click node_controls "https://github.com/barathiraja242005/arigoairguardpro/blob/main/src/pages/Controls.tsx"
click node_alerts "https://github.com/barathiraja242005/arigoairguardpro/blob/main/src/pages/Alerts.tsx"
click node_settings "https://github.com/barathiraja242005/arigoairguardpro/blob/main/src/pages/Settings.tsx"
click node_analytics_hook "https://github.com/barathiraja242005/arigoairguardpro/blob/main/src/hooks/useAirguardDeviceAnalytics.ts"
click node_admin_map_page "https://github.com/barathiraja242005/arigoairguardpro/blob/main/src/pages/AdminPollutionMap.tsx"
click node_ngo_dashboard "https://github.com/barathiraja242005/arigoairguardpro/blob/main/src/pages/NGODashboard.tsx"
click node_pollution_map "https://github.com/barathiraja242005/arigoairguardpro/blob/main/src/components/map/PollutionMap.tsx"
click node_map_sidebar "https://github.com/barathiraja242005/arigoairguardpro/blob/main/src/components/map/MapSidebar.tsx"
click node_detail_panel "https://github.com/barathiraja242005/arigoairguardpro/blob/main/src/components/map/DetailPanel.tsx"
click node_chatbot_global "https://github.com/barathiraja242005/arigoairguardpro/blob/main/src/components/chat/GlobalAIChatbot.tsx"
click node_chatbot "https://github.com/barathiraja242005/arigoairguardpro/blob/main/src/components/chat/AIChatbot.tsx"
click node_state_data "https://github.com/barathiraja242005/arigoairguardpro/blob/main/src/lib/statePollutionData.ts"
click node_hotspots "https://github.com/barathiraja242005/arigoairguardpro/blob/main/src/data/pollutionHotspots.ts"
click node_ngo_data "https://github.com/barathiraja242005/arigoairguardpro/blob/main/src/data/ngoData.ts"
click node_firebase "https://github.com/barathiraja242005/arigoairguardpro/blob/main/src/lib/firebase.ts"
click node_airguard_db "https://github.com/barathiraja242005/arigoairguardpro/blob/main/src/lib/airguardDb.ts"
click node_cloud_functions "https://github.com/barathiraja242005/arigoairguardpro/blob/main/functions/src/index.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_auth,node_role_guard,node_home,node_login,node_visitor toneBlue
class node_dashboard,node_controls,node_alerts,node_settings,node_analytics_hook toneAmber
class node_admin_map_page,node_ngo_dashboard,node_pollution_map,node_map_sidebar,node_detail_panel,node_chatbot_global,node_chatbot toneMint
class node_demo_auth,node_state_data,node_hotspots,node_ngo_data,node_firebase,node_airguard_db,node_cloud_functions toneRose
class node_twilio toneIndigo
```

## Components

### App and access

- [Web app routes](https://github.com/barathiraja242005/arigoairguardpro/blob/main/src/App.tsx): `src/App.tsx`
- [Session provider](https://github.com/barathiraja242005/arigoairguardpro/blob/main/src/contexts/AuthContext.tsx): `src/contexts/AuthContext.tsx`
- [Role guard](https://github.com/barathiraja242005/arigoairguardpro/blob/main/src/components/auth/RequireAuth.tsx): `src/components/auth/RequireAuth.tsx`
- [Landing page](https://github.com/barathiraja242005/arigoairguardpro/blob/main/src/pages/Home.tsx): `src/pages/Home.tsx`
- [Sign-in pages](https://github.com/barathiraja242005/arigoairguardpro/blob/main/src/pages/Login.tsx): `src/pages/Login.tsx`

### Device monitoring

- [Device dashboard](https://github.com/barathiraja242005/arigoairguardpro/blob/main/src/pages/Dashboard.tsx): `src/pages/Dashboard.tsx`
- [Device controls](https://github.com/barathiraja242005/arigoairguardpro/blob/main/src/pages/Controls.tsx): `src/pages/Controls.tsx`
- [Safety alerts](https://github.com/barathiraja242005/arigoairguardpro/blob/main/src/pages/Alerts.tsx): `src/pages/Alerts.tsx`
- [Device settings](https://github.com/barathiraja242005/arigoairguardpro/blob/main/src/pages/Settings.tsx): `src/pages/Settings.tsx`
- [Device analytics](https://github.com/barathiraja242005/arigoairguardpro/blob/main/src/hooks/useAirguardDeviceAnalytics.ts): `src/hooks/useAirguardDeviceAnalytics.ts`

### Pollution intelligence

- [Admin pollution map](https://github.com/barathiraja242005/arigoairguardpro/blob/main/src/pages/AdminPollutionMap.tsx): `src/pages/AdminPollutionMap.tsx`
- [NGO dashboard](https://github.com/barathiraja242005/arigoairguardpro/blob/main/src/pages/NGODashboard.tsx): `src/pages/NGODashboard.tsx`
- [Interactive pollution map](https://github.com/barathiraja242005/arigoairguardpro/blob/main/src/components/map/PollutionMap.tsx): `src/components/map/PollutionMap.tsx`
- [Map sidebar](https://github.com/barathiraja242005/arigoairguardpro/blob/main/src/components/map/MapSidebar.tsx): `src/components/map/MapSidebar.tsx`
- [Map detail panel](https://github.com/barathiraja242005/arigoairguardpro/blob/main/src/components/map/DetailPanel.tsx): `src/components/map/DetailPanel.tsx`
- [Global chat launcher](https://github.com/barathiraja242005/arigoairguardpro/blob/main/src/components/chat/GlobalAIChatbot.tsx): `src/components/chat/GlobalAIChatbot.tsx`
- [Pollution assistant](https://github.com/barathiraja242005/arigoairguardpro/blob/main/src/components/chat/AIChatbot.tsx): `src/components/chat/AIChatbot.tsx`

### Data and services

- [Demo credentials](https://github.com/barathiraja242005/arigoairguardpro/blob/main/src/lib/demoAuth.ts): `src/lib/demoAuth.ts`
- [State pollution data](https://github.com/barathiraja242005/arigoairguardpro/blob/main/src/lib/statePollutionData.ts): `src/lib/statePollutionData.ts`
- [Hotspot dataset](https://github.com/barathiraja242005/arigoairguardpro/blob/main/src/data/pollutionHotspots.ts): `src/data/pollutionHotspots.ts`
- [NGO data](https://github.com/barathiraja242005/arigoairguardpro/blob/main/src/data/ngoData.ts): `src/data/ngoData.ts`
- [Firebase client](https://github.com/barathiraja242005/arigoairguardpro/blob/main/src/lib/firebase.ts): `src/lib/firebase.ts`
- [Device data access](https://github.com/barathiraja242005/arigoairguardpro/blob/main/src/lib/airguardDb.ts): `src/lib/airguardDb.ts`
- [Alert cloud functions](https://github.com/barathiraja242005/arigoairguardpro/blob/main/functions/src/index.ts): `functions/src/index.ts`

### Other components

- **Visitor / user**
- **Twilio**

## Connections

- Visitor / user → Web app routes: opens (evidence: `src/App.tsx`)
- Web app routes → Landing page: routes to (evidence: `src/App.tsx`)
- Web app routes → Sign-in pages: routes to (evidence: `src/App.tsx`)
- Web app routes → Session provider: provides session (evidence: `src/App.tsx`)
- Web app routes → Role guard: guards routes (evidence: `src/App.tsx`)
- Role guard → Session provider: checks role (evidence: `src/components/auth/RequireAuth.tsx`)
- Sign-in pages → Demo credentials: authenticates with
- Session provider → Demo credentials: uses role type (evidence: `src/contexts/AuthContext.tsx`)
- Demo credentials → State pollution data: loads NGO credentials (evidence: `src/lib/demoAuth.ts`)
- Web app routes → Device dashboard: routes to (evidence: `src/App.tsx`)
- Web app routes → Device controls: routes to (evidence: `src/App.tsx`)
- Web app routes → Safety alerts: routes to (evidence: `src/App.tsx`)
- Web app routes → Device settings: routes to (evidence: `src/App.tsx`)
- Device controls → Device analytics: uses analytics (evidence: `src/pages/Controls.tsx`)
- Device analytics → Firebase client: uses client (evidence: `src/hooks/useAirguardDeviceAnalytics.ts`)
- Device analytics → Device data access: uses data access (evidence: `src/hooks/useAirguardDeviceAnalytics.ts`)
- Safety alerts → Firebase client: uses client (evidence: `src/pages/Alerts.tsx`)
- Device settings → Firebase client: writes profile and devices (evidence: `src/pages/Settings.tsx`)
- Device settings → Alert cloud functions: tests alert call
- Alert cloud functions → Twilio: places calls
- Web app routes → Admin pollution map: routes to (evidence: `src/App.tsx`)
- Web app routes → NGO dashboard: routes to (evidence: `src/App.tsx`)
- Admin pollution map → Interactive pollution map: renders (evidence: `src/pages/AdminPollutionMap.tsx`)
- Admin pollution map → Map sidebar: renders (evidence: `src/pages/AdminPollutionMap.tsx`)
- Admin pollution map → Map detail panel: renders (evidence: `src/pages/AdminPollutionMap.tsx`)
- Admin pollution map → Pollution assistant: renders (evidence: `src/pages/AdminPollutionMap.tsx`)
- NGO dashboard → Interactive pollution map: renders (evidence: `src/pages/NGODashboard.tsx`)
- NGO dashboard → Map sidebar: renders (evidence: `src/pages/NGODashboard.tsx`)
- NGO dashboard → Map detail panel: renders (evidence: `src/pages/NGODashboard.tsx`)
- NGO dashboard → Pollution assistant: renders (evidence: `src/pages/NGODashboard.tsx`)
- Global chat launcher → Pollution assistant: renders (evidence: `src/components/chat/GlobalAIChatbot.tsx`)
- Pollution assistant → State pollution data: looks up state (evidence: `src/components/chat/AIChatbot.tsx`)
- Interactive pollution map → State pollution data: reads AQI colors (evidence: `src/components/map/PollutionMap.tsx`)
- Admin pollution map → Hotspot dataset: uses hotspot data (evidence: `src/pages/AdminPollutionMap.tsx`)
- Admin pollution map → NGO data: uses NGO data (evidence: `src/pages/AdminPollutionMap.tsx`)
- NGO dashboard → Hotspot dataset: uses hotspot data (evidence: `src/pages/NGODashboard.tsx`)
- NGO dashboard → NGO data: uses NGO data (evidence: `src/pages/NGODashboard.tsx`)
