# dhanushgowdas/eaar architecture

> Architecture diagram of the GitHub repository dhanushgowdas/eaar, 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/dhanushgowdas/eaar
- Repository: https://github.com/dhanushgowdas/eaar

## Overview

EAAR is a web dashboard for an edge-AI agricultural rover. The user explores rover architecture, devices, field readings and disease-detection results, then can inspect live status, operate navigation controls, simulate field inputs, configure Supabase, or ask the field assistant. The sampled app wiring establishes the main UI composition and shared rover state; several domain views are represented by their documented purpose and names. The firmware and some data integrations were not sampled, so their connections are left unverified or omitted.

Main entry points: [`src/context/RoverContext.tsx`](https://github.com/dhanushgowdas/eaar/blob/main/src/context/RoverContext.tsx) (Rover context), [`src/App.tsx`](https://github.com/dhanushgowdas/eaar/blob/main/src/App.tsx) (App shell), [`src/components/sections/ResultsSection.tsx`](https://github.com/dhanushgowdas/eaar/blob/main/src/components/sections/ResultsSection.tsx) (Inspection results), [`src/components/chat/GeminiChatbot.tsx`](https://github.com/dhanushgowdas/eaar/blob/main/src/components/chat/GeminiChatbot.tsx) (Gemini assistant)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["Dashboard experience"]
  node_app["App shell<br/>[App.tsx]"]
  node_navigation["Navigation and language<br/>[RightDrawer.tsx]"]
  node_hero["Rover overview<br/>[HeroSection.tsx]"]
  node_rover3d["3D rover view<br/>[RoverFiber.tsx]"]
  node_architecture["Architecture view"]
  node_devices["Device inventory<br/>[DevicesSection.tsx]"]
  node_live["Live status"]
  node_results["Inspection results<br/>[ResultsSection.tsx]"]
end

subgraph group_field["Field operations"]
  node_controller["Navigation controller"]
  node_simulator["Field simulator"]
  node_assistant["Gemini assistant<br/>[GeminiChatbot.tsx]"]
end

subgraph group_state["Shared state and data"]
  node_roverstate["Rover context<br/>[RoverContext.tsx]"]
  node_supabaseconfig["Supabase settings"]
end

subgraph group_embedded["Rover firmware"]
  node_firmwareconfig["Device configuration<br/>[DEVICE_CONFIG.h]"]
  node_navfirmware["Navigation firmware"]
  node_envfirmware["Environment firmware"]
end

node_user(("Operator"))
node_gemini{{"Gemini chat endpoint"}}
node_supabase[("Supabase")]

node_user -->|"uses"| node_app
node_app -->|"provides context"| node_roverstate
node_app -->|"renders"| node_navigation
node_app -->|"renders"| node_hero
node_app -->|"renders"| node_architecture
node_app -->|"renders"| node_devices
node_app -->|"renders"| node_results
node_app -->|"renders"| node_live
node_app -->|"renders"| node_controller
node_hero -->|"renders"| node_rover3d
node_navigation -->|"uses"| node_roverstate
node_architecture -->|"uses"| node_roverstate
node_devices -->|"uses"| node_roverstate
node_live -->|"uses"| node_roverstate
node_results -->|"uses"| node_roverstate
node_controller -.->|"controls via"| node_roverstate
node_simulator -->|"injects readings"| node_roverstate
node_assistant -->|"uses"| node_roverstate
node_assistant -->|"requests chat"| node_gemini
node_supabaseconfig -->|"uses"| node_roverstate
node_roverstate -.->|"reads and writes"| node_supabase
node_results -.->|"listens for updates"| node_supabase
node_firmwareconfig -.->|"configures"| node_navfirmware
node_firmwareconfig -.->|"configures"| node_envfirmware

click node_app "https://github.com/dhanushgowdas/eaar/blob/main/src/App.tsx"
click node_navigation "https://github.com/dhanushgowdas/eaar/blob/main/src/components/navigation/RightDrawer.tsx"
click node_hero "https://github.com/dhanushgowdas/eaar/blob/main/src/components/sections/HeroSection.tsx"
click node_rover3d "https://github.com/dhanushgowdas/eaar/blob/main/src/components/3d/RoverFiber.tsx"
click node_architecture "https://github.com/dhanushgowdas/eaar/blob/main/src/components/sections/ArchitectureSection.tsx"
click node_devices "https://github.com/dhanushgowdas/eaar/blob/main/src/components/sections/DevicesSection.tsx"
click node_live "https://github.com/dhanushgowdas/eaar/blob/main/src/components/sections/LiveStatusSection.tsx"
click node_results "https://github.com/dhanushgowdas/eaar/blob/main/src/components/sections/ResultsSection.tsx"
click node_controller "https://github.com/dhanushgowdas/eaar/blob/main/src/components/sections/NavigationControllerSection.tsx"
click node_simulator "https://github.com/dhanushgowdas/eaar/blob/main/src/components/modals/FieldSimulatorDrawer.tsx"
click node_assistant "https://github.com/dhanushgowdas/eaar/blob/main/src/components/chat/GeminiChatbot.tsx"
click node_roverstate "https://github.com/dhanushgowdas/eaar/blob/main/src/context/RoverContext.tsx"
click node_supabaseconfig "https://github.com/dhanushgowdas/eaar/blob/main/src/components/modals/SupabaseConfigModal.tsx"
click node_firmwareconfig "https://github.com/dhanushgowdas/eaar/blob/main/firmware/DEVICE_CONFIG.h"
click node_navfirmware "https://github.com/dhanushgowdas/eaar/blob/main/firmware/ESP32_DevKit_Navigation/ESP32_DevKit_Navigation.ino"
click node_envfirmware "https://github.com/dhanushgowdas/eaar/blob/main/firmware/ESP32-S3_Environment/ESP32-S3_Environment.ino"

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_navigation,node_hero,node_rover3d,node_architecture,node_devices,node_live,node_results toneBlue
class node_controller,node_simulator,node_assistant,node_supabase toneAmber
class node_roverstate,node_supabaseconfig toneMint
class node_firmwareconfig,node_navfirmware,node_envfirmware toneRose
class node_user,node_gemini toneIndigo
```

## Components

### Dashboard experience

- [App shell](https://github.com/dhanushgowdas/eaar/blob/main/src/App.tsx): `src/App.tsx`
- [Navigation and language](https://github.com/dhanushgowdas/eaar/blob/main/src/components/navigation/RightDrawer.tsx): `src/components/navigation/RightDrawer.tsx`
- [Rover overview](https://github.com/dhanushgowdas/eaar/blob/main/src/components/sections/HeroSection.tsx): `src/components/sections/HeroSection.tsx`
- [3D rover view](https://github.com/dhanushgowdas/eaar/blob/main/src/components/3d/RoverFiber.tsx): `src/components/3d/RoverFiber.tsx`
- [Architecture view](https://github.com/dhanushgowdas/eaar/blob/main/src/components/sections/ArchitectureSection.tsx): `src/components/sections/ArchitectureSection.tsx`
- [Device inventory](https://github.com/dhanushgowdas/eaar/blob/main/src/components/sections/DevicesSection.tsx): `src/components/sections/DevicesSection.tsx`
- [Live status](https://github.com/dhanushgowdas/eaar/blob/main/src/components/sections/LiveStatusSection.tsx): `src/components/sections/LiveStatusSection.tsx`
- [Inspection results](https://github.com/dhanushgowdas/eaar/blob/main/src/components/sections/ResultsSection.tsx): `src/components/sections/ResultsSection.tsx`

### Field operations

- [Navigation controller](https://github.com/dhanushgowdas/eaar/blob/main/src/components/sections/NavigationControllerSection.tsx): `src/components/sections/NavigationControllerSection.tsx`
- [Field simulator](https://github.com/dhanushgowdas/eaar/blob/main/src/components/modals/FieldSimulatorDrawer.tsx): `src/components/modals/FieldSimulatorDrawer.tsx`
- [Gemini assistant](https://github.com/dhanushgowdas/eaar/blob/main/src/components/chat/GeminiChatbot.tsx): `src/components/chat/GeminiChatbot.tsx`

### Shared state and data

- [Rover context](https://github.com/dhanushgowdas/eaar/blob/main/src/context/RoverContext.tsx): `src/context/RoverContext.tsx`
- [Supabase settings](https://github.com/dhanushgowdas/eaar/blob/main/src/components/modals/SupabaseConfigModal.tsx): `src/components/modals/SupabaseConfigModal.tsx`

### Rover firmware

- [Device configuration](https://github.com/dhanushgowdas/eaar/blob/main/firmware/DEVICE_CONFIG.h): `firmware/DEVICE_CONFIG.h`
- [Navigation firmware](https://github.com/dhanushgowdas/eaar/blob/main/firmware/ESP32_DevKit_Navigation/ESP32_DevKit_Navigation.ino): `firmware/ESP32_DevKit_Navigation/ESP32_DevKit_Navigation.ino`
- [Environment firmware](https://github.com/dhanushgowdas/eaar/blob/main/firmware/ESP32-S3_Environment/ESP32-S3_Environment.ino): `firmware/ESP32-S3_Environment/ESP32-S3_Environment.ino`

### Other components

- **Operator**
- **Gemini chat endpoint**
- **Supabase**

## Connections

- Operator → App shell: uses (evidence: `src/App.tsx`)
- App shell → Rover context: provides context (evidence: `src/App.tsx`)
- App shell → Navigation and language: renders (evidence: `src/App.tsx`)
- App shell → Rover overview: renders (evidence: `src/App.tsx`)
- App shell → Architecture view: renders (evidence: `src/App.tsx`)
- App shell → Device inventory: renders (evidence: `src/App.tsx`)
- App shell → Inspection results: renders (evidence: `src/App.tsx`)
- App shell → Live status: renders (evidence: `src/App.tsx`)
- App shell → Navigation controller: renders (evidence: `src/App.tsx`)
- Rover overview → 3D rover view: renders (evidence: `src/components/sections/HeroSection.tsx`)
- Navigation and language → Rover context: uses (evidence: `src/components/navigation/RightDrawer.tsx`)
- Architecture view → Rover context: uses (evidence: `src/components/sections/ArchitectureSection.tsx`)
- Device inventory → Rover context: uses (evidence: `src/components/sections/DevicesSection.tsx`)
- Live status → Rover context: uses (evidence: `src/components/sections/LiveStatusSection.tsx`)
- Inspection results → Rover context: uses (evidence: `src/components/sections/ResultsSection.tsx`)
- Navigation controller → Rover context: controls via
- Field simulator → Rover context: injects readings (evidence: `src/components/modals/FieldSimulatorDrawer.tsx`)
- Gemini assistant → Rover context: uses (evidence: `src/components/chat/GeminiChatbot.tsx`)
- Gemini assistant → Gemini chat endpoint: requests chat (evidence: `src/components/chat/GeminiChatbot.tsx`)
- Supabase settings → Rover context: uses (evidence: `src/components/modals/SupabaseConfigModal.tsx`)
- Rover context → Supabase: reads and writes
- Inspection results → Supabase: listens for updates (evidence: `src/components/sections/ResultsSection.tsx`)
- Device configuration → Navigation firmware: configures
- Device configuration → Environment firmware: configures
