How akshithkheeran-design/urban-air-quality-assistant2026 works
AURA is a family and community smog-defense web application. A user enters through the shared application shell, selects a capability, and receives household guidance, neighborhood intelligence, alerts, forecasts, or community-ledger actions. Its domain stages include routine planning, indoor-air interventions, clean alternatives, hazard reporting, and impact tracking; the GenAI assistant adds specialized-agent responses and consensus. The sampled files establish shell routing, shared state composition, routine generation, agent orchestration, and ledger integrity. Other page capabilities are documented in the README; their internal wiring is not inferred here.
Main entry points: App.jsx Application Shell · aiService.js AI Service · useCitizenLedgerState.js Ledger State · AppContext.jsx Shared App State
Components 24
Application Shell
- Application Shell
src/App.jsx - Navigation Metadata
src/constants/navigation.js - Shared App State
src/context/AppContext.jsx
Household Guidance
- Command Center
src/pages/CommandCenter.jsx - Daily Routines
src/pages/DailyRoutines.jsx - Routine Engine
src/services/routineEngine.js - Indoor Air Hacks
src/pages/IndoorAirHacks.jsx - Clean Alternatives
src/pages/SustainableAlternatives.jsx - Impact Calculator
src/services/impactCalculator.js
Air Intelligence
- Neighborhood Map
src/pages/ThreatMap.jsx - Family Alerts
src/pages/AlertCenter.jsx - 30-Day Outlook
src/pages/Forecast.jsx - Air & Domain Data
src/data/wards.js
Community & Trust
- Community Watch
src/pages/CitizenReports.jsx - Ledger State
src/hooks/useCitizenLedgerState.js - Ledger Cryptography
src/utils/crypto.js - Impact Ledger
src/pages/AuditTrail.jsx
Agent Intelligence
- GenAI Assistant
src/pages/AgentSystem.jsx - Agent Orchestration
src/hooks/useAgentOrchestration.js - AI Service
src/services/aiService.js - Gemini Proxy
netlify/functions/gemini.js - Gemini API Proxy
api/gemini.js - Input Sanitization
src/utils/sanitize.js
Other components
- Resident
Connections 23
- Resident → Application Shell: uses
src/App.jsx - Application Shell → Shared App State: reads state
src/App.jsx - Application Shell → Navigation Metadata: routes pages
src/App.jsx - Application Shell → Command Center: dispatches
src/App.jsx - Application Shell → Daily Routines: dispatches
src/App.jsx - Application Shell → Indoor Air Hacks: dispatches
src/App.jsx - Application Shell → Clean Alternatives: dispatches
src/App.jsx - Application Shell → Neighborhood Map: dispatches
src/App.jsx - Application Shell → Family Alerts: dispatches
src/App.jsx - Application Shell → 30-Day Outlook: dispatches
src/App.jsx - Application Shell → Community Watch: dispatches
src/App.jsx - Application Shell → Impact Ledger: dispatches
src/App.jsx - Application Shell → GenAI Assistant: dispatches
src/App.jsx - Shared App State → Ledger State: composes
src/context/AppContext.jsx - Daily Routines → Routine Engine: uses
src/pages/DailyRoutines.jsx - Clean Alternatives → Impact Calculator: calculates impact
- Community Watch → Ledger State: records reports
- Ledger State → Ledger Cryptography: verifies hashes
src/hooks/useCitizenLedgerState.js - Agent Orchestration → AI Service: orchestrates
src/hooks/useAgentOrchestration.js - AI Service → Input Sanitization: sanitizes input
src/services/aiService.js - AI Service → Gemini Proxy: requests inference
- AI Service → Gemini API Proxy: requests inference
- GenAI Assistant → Agent Orchestration: runs agents