# bhavith-fs/orbitband architecture

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

- Interactive diagram: https://gitdiagram.com/bhavith-fs/orbitband
- Repository: https://github.com/bhavith-fs/orbitband

## Overview

OrbitBand is a local-first astronaut health-monitoring prototype. A crew member opens the dashboard, explores simulated readings by body zone, and can inspect readiness, trends, or measurement guidance; Mission Control changes the scenario data, while emergency mode provides response steps and a report. The shared rules module evaluates indicator status and readiness. The README also describes offline PWA support, but the supplied tree and excerpts do not establish a runtime source path for that capability, so it is not mapped as a component.

Main entry points: [`src/App.jsx`](https://github.com/bhavith-fs/orbitband/blob/master/src/App.jsx) (Dashboard shell), [`src/lib/status.js`](https://github.com/bhavith-fs/orbitband/blob/master/src/lib/status.js) (Status and readiness rules), [`src/components/BodyScreen.jsx`](https://github.com/bhavith-fs/orbitband/blob/master/src/components/BodyScreen.jsx) (Body and readiness), [`src/components/TrendCharts.jsx`](https://github.com/bhavith-fs/orbitband/blob/master/src/components/TrendCharts.jsx) (Trend and radiation charts)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_shell["Application shell"]
  node_app_entry["React entry<br/>[main.jsx]"]
  node_app["Dashboard shell<br/>[App.jsx]"]
  node_hero["Home screen<br/>[Hero.jsx]"]
  node_space_visual["Orbit visualization<br/>[OrbitSky.jsx]"]
  node_static_pages["About and roadmap<br/>[StaticPages.jsx]"]
end

subgraph group_monitoring["Health monitoring"]
  node_mission_control["Mission Control<br/>[MissionControl.jsx]"]
  node_crew_data["Scenario data<br/>[crewData.js]"]
  node_body_screen["Body and readiness<br/>[BodyScreen.jsx]"]
  node_body_figure["Interactive body map<br/>[BodyFigure.jsx]"]
  node_side_panel["Zone details<br/>[SidePanel.jsx]"]
  node_measurement_guide["Measurement guide"]
end

subgraph group_analysis["Health analysis"]
  node_status_rules["Status and readiness rules<br/>[status.js]"]
  node_trend_charts["Trend and radiation charts<br/>[TrendCharts.jsx]"]
end

subgraph group_response["Emergency response"]
  node_emergency["Emergency guidance<br/>[EmergencyMode.jsx]"]
end

node_crew_member(("Crew member"))

node_crew_member -.->|"opens app"| node_app_entry
node_app_entry -->|"renders"| node_app
node_app -->|"renders"| node_space_visual
node_app -->|"renders"| node_hero
node_app -->|"renders"| node_static_pages
node_app -->|"passes readings"| node_body_screen
node_app -->|"renders"| node_measurement_guide
node_app -->|"passes readings"| node_trend_charts
node_app -->|"supplies scenario controls"| node_mission_control
node_app -->|"passes readings"| node_emergency
node_app -->|"builds scenario data"| node_crew_data
node_mission_control -.->|"selects scenarios"| node_crew_data
node_body_screen -->|"renders"| node_body_figure
node_body_screen -->|"renders selected zone"| node_side_panel
node_body_screen -->|"calculates readiness"| node_status_rules
node_body_figure -->|"evaluates zones"| node_status_rules
node_side_panel -->|"evaluates readings"| node_status_rules
node_measurement_guide -->|"tests indicator status"| node_status_rules
node_trend_charts -->|"colors chart points"| node_status_rules
node_trend_charts -->|"uses radiation limit"| node_crew_data
node_emergency -->|"uses status metadata"| node_status_rules

click node_app_entry "https://github.com/bhavith-fs/orbitband/blob/master/src/main.jsx"
click node_app "https://github.com/bhavith-fs/orbitband/blob/master/src/App.jsx"
click node_hero "https://github.com/bhavith-fs/orbitband/blob/master/src/components/Hero.jsx"
click node_space_visual "https://github.com/bhavith-fs/orbitband/blob/master/src/components/OrbitSky.jsx"
click node_static_pages "https://github.com/bhavith-fs/orbitband/blob/master/src/components/StaticPages.jsx"
click node_mission_control "https://github.com/bhavith-fs/orbitband/blob/master/src/components/MissionControl.jsx"
click node_crew_data "https://github.com/bhavith-fs/orbitband/blob/master/src/data/crewData.js"
click node_body_screen "https://github.com/bhavith-fs/orbitband/blob/master/src/components/BodyScreen.jsx"
click node_body_figure "https://github.com/bhavith-fs/orbitband/blob/master/src/components/BodyFigure.jsx"
click node_side_panel "https://github.com/bhavith-fs/orbitband/blob/master/src/components/SidePanel.jsx"
click node_measurement_guide "https://github.com/bhavith-fs/orbitband/blob/master/src/components/MeasurementGuide.jsx"
click node_status_rules "https://github.com/bhavith-fs/orbitband/blob/master/src/lib/status.js"
click node_trend_charts "https://github.com/bhavith-fs/orbitband/blob/master/src/components/TrendCharts.jsx"
click node_emergency "https://github.com/bhavith-fs/orbitband/blob/master/src/components/EmergencyMode.jsx"

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_entry,node_app,node_hero,node_space_visual,node_static_pages toneBlue
class node_mission_control,node_crew_data,node_body_screen,node_body_figure,node_side_panel,node_measurement_guide toneAmber
class node_status_rules,node_trend_charts toneMint
class node_emergency toneRose
class node_crew_member toneIndigo
```

## Components

### Application shell

- [React entry](https://github.com/bhavith-fs/orbitband/blob/master/src/main.jsx): `src/main.jsx`
- [Dashboard shell](https://github.com/bhavith-fs/orbitband/blob/master/src/App.jsx): `src/App.jsx`
- [Home screen](https://github.com/bhavith-fs/orbitband/blob/master/src/components/Hero.jsx): `src/components/Hero.jsx`
- [Orbit visualization](https://github.com/bhavith-fs/orbitband/blob/master/src/components/OrbitSky.jsx): `src/components/OrbitSky.jsx`
- [About and roadmap](https://github.com/bhavith-fs/orbitband/blob/master/src/components/StaticPages.jsx): `src/components/StaticPages.jsx`

### Health monitoring

- [Mission Control](https://github.com/bhavith-fs/orbitband/blob/master/src/components/MissionControl.jsx): `src/components/MissionControl.jsx`
- [Scenario data](https://github.com/bhavith-fs/orbitband/blob/master/src/data/crewData.js): `src/data/crewData.js`
- [Body and readiness](https://github.com/bhavith-fs/orbitband/blob/master/src/components/BodyScreen.jsx): `src/components/BodyScreen.jsx`
- [Interactive body map](https://github.com/bhavith-fs/orbitband/blob/master/src/components/BodyFigure.jsx): `src/components/BodyFigure.jsx`
- [Zone details](https://github.com/bhavith-fs/orbitband/blob/master/src/components/SidePanel.jsx): `src/components/SidePanel.jsx`
- [Measurement guide](https://github.com/bhavith-fs/orbitband/blob/master/src/components/MeasurementGuide.jsx): `src/components/MeasurementGuide.jsx`

### Health analysis

- [Status and readiness rules](https://github.com/bhavith-fs/orbitband/blob/master/src/lib/status.js): `src/lib/status.js`
- [Trend and radiation charts](https://github.com/bhavith-fs/orbitband/blob/master/src/components/TrendCharts.jsx): `src/components/TrendCharts.jsx`

### Emergency response

- [Emergency guidance](https://github.com/bhavith-fs/orbitband/blob/master/src/components/EmergencyMode.jsx): `src/components/EmergencyMode.jsx`

### Other components

- **Crew member**

## Connections

- Crew member → React entry: opens app
- React entry → Dashboard shell: renders (evidence: `src/main.jsx`)
- Dashboard shell → Orbit visualization: renders (evidence: `src/App.jsx`)
- Dashboard shell → Home screen: renders (evidence: `src/App.jsx`)
- Dashboard shell → About and roadmap: renders (evidence: `src/App.jsx`)
- Dashboard shell → Body and readiness: passes readings (evidence: `src/App.jsx`)
- Dashboard shell → Measurement guide: renders (evidence: `src/App.jsx`)
- Dashboard shell → Trend and radiation charts: passes readings (evidence: `src/App.jsx`)
- Dashboard shell → Mission Control: supplies scenario controls (evidence: `src/App.jsx`)
- Dashboard shell → Emergency guidance: passes readings (evidence: `src/App.jsx`)
- Dashboard shell → Scenario data: builds scenario data (evidence: `src/App.jsx`)
- Mission Control → Scenario data: selects scenarios (evidence: `src/components/MissionControl.jsx`)
- Body and readiness → Interactive body map: renders (evidence: `src/components/BodyScreen.jsx`)
- Body and readiness → Zone details: renders selected zone (evidence: `src/components/BodyScreen.jsx`)
- Body and readiness → Status and readiness rules: calculates readiness (evidence: `src/components/BodyScreen.jsx`)
- Interactive body map → Status and readiness rules: evaluates zones (evidence: `src/components/BodyFigure.jsx`)
- Zone details → Status and readiness rules: evaluates readings (evidence: `src/components/SidePanel.jsx`)
- Measurement guide → Status and readiness rules: tests indicator status (evidence: `src/components/MeasurementGuide.jsx`)
- Trend and radiation charts → Status and readiness rules: colors chart points (evidence: `src/components/TrendCharts.jsx`)
- Trend and radiation charts → Scenario data: uses radiation limit (evidence: `src/components/TrendCharts.jsx`)
- Emergency guidance → Status and readiness rules: uses status metadata (evidence: `src/components/EmergencyMode.jsx`)
