# jawadalnatah/astrova architecture

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

## Overview

Astrova is an interactive 3D astronomy experience with three top-level views: a navigable solar system, a cosmos gallery, and a curated Observatory. In the main exploration flow, users select a planet in the solar-system view and can open its detail overlay or moon-phase panel; the app also presents event and sky-information panels. The README documents live asteroid data and location-based sky information. Observatory internals are mapped at subsystem level where source excerpts are unavailable, so those relationships are not asserted beyond documented or indexed wiring.

Main entry points: [`src/components/scene/SolarSystem.tsx`](https://github.com/jawadalnatah/astrova/blob/main/src/components/scene/SolarSystem.tsx) (Solar System), [`src/App.tsx`](https://github.com/jawadalnatah/astrova/blob/main/src/App.tsx) (View Router), [`src/components/showcase/PlanetShowcase.tsx`](https://github.com/jawadalnatah/astrova/blob/main/src/components/showcase/PlanetShowcase.tsx) (Planet Showcase), [`src/components/showcase/Observatory.tsx`](https://github.com/jawadalnatah/astrova/blob/main/src/components/showcase/Observatory.tsx) (Observatory)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["App Shell"]
  node_app["View Router<br/>[App.tsx]"]
end

subgraph group_solar["Solar Exploration"]
  node_planet_view["Planet Showcase<br/>[PlanetShowcase.tsx]"]
  node_solar_system["Solar System<br/>[SolarSystem.tsx]"]
  node_planet_scene["Planet Renderer<br/>[Planet.tsx]"]
  node_sun["Sun Renderer<br/>[Sun.tsx]"]
  node_asteroids["Asteroid Belt<br/>[AsteroidBelt.tsx]"]
  node_planet_data["Planet Catalogue<br/>[planets.ts]"]
  node_planet_detail["Planet Details"]
  node_moon_panel["Moon Phases<br/>[MoonPhasePanel.tsx]"]
  node_timeline["Event Timeline"]
  node_hud_overlay["Planet HUD<br/>[HUDOverlay.tsx]"]
  node_my_sky["My Sky Tonight<br/>[MySkyPanel.tsx]"]
  node_planet_panel["Planet Panel<br/>[PlanetPanel.tsx]"]
  node_showcase_scene["Planet Showcase Scene<br/>[ShowcaseScene.tsx]"]
  node_hud["HUD Controls<br/>[HUD.tsx]"]
end

subgraph group_observatory["Cosmic Collections"]
  node_cosmos_view["Cosmos Gallery<br/>[CosmosGallery.tsx]"]
  node_cosmos_data["Cosmos Collection<br/>[cosmos.ts]"]
  node_observatory_view["Observatory<br/>[Observatory.tsx]"]
  node_observatory_scene["Observatory Scene"]
  node_observatory_ui["Observatory Controls<br/>[ObservatoryUI.tsx]"]
  node_observatory_data["Observatory Objects<br/>[observatory.ts]"]
end

subgraph group_shared["Shared Experience"]
  node_navbar["Navigation<br/>[Navbar.tsx]"]
  node_audio["Audio Settings<br/>[AudioContext.tsx]"]
  node_quality["Render Quality<br/>[QualityContext.tsx]"]
  node_device_tier["Device Tier<br/>[useDeviceTier.ts]"]
end

node_visitor(("Visitor"))
node_neo_ws["NASA NeoWs"]

node_visitor -->|"opens"| node_app
node_app -->|"routes to"| node_planet_view
node_app -->|"routes to"| node_cosmos_view
node_app -->|"routes to"| node_observatory_view
node_planet_view -->|"renders"| node_solar_system
node_planet_view -->|"renders"| node_hud
node_planet_view -->|"renders"| node_showcase_scene
node_planet_view -->|"renders"| node_navbar
node_solar_system -->|"renders"| node_planet_scene
node_solar_system -->|"renders"| node_sun
node_solar_system -->|"renders"| node_asteroids
node_solar_system -->|"reads"| node_planet_data
node_solar_system -->|"opens"| node_planet_detail
node_solar_system -->|"opens"| node_moon_panel
node_solar_system -->|"renders"| node_timeline
node_solar_system -->|"renders"| node_hud_overlay
node_planet_detail -->|"reads"| node_planet_data
node_hud_overlay -->|"reads"| node_planet_data
node_planet_view -->|"reads"| node_planet_data
node_planet_panel -->|"reads"| node_planet_data
node_planet_panel -->|"renders"| node_my_sky
node_asteroids -.->|"gets asteroid data"| node_neo_ws
node_cosmos_view -->|"reads"| node_cosmos_data
node_cosmos_view -->|"renders"| node_navbar
node_observatory_view -->|"renders"| node_observatory_scene
node_observatory_view -->|"renders"| node_observatory_ui
node_observatory_view -->|"reads"| node_observatory_data
node_observatory_view -->|"renders"| node_navbar
node_observatory_scene -->|"reads"| node_observatory_data
node_observatory_ui -->|"reads"| node_observatory_data
node_navbar -->|"controls"| node_audio
node_app -->|"provides"| node_audio
node_app -->|"provides"| node_quality
node_solar_system -->|"checks"| node_device_tier
node_observatory_view -->|"checks"| node_device_tier
node_observatory_scene -->|"checks"| node_device_tier

click node_app "https://github.com/jawadalnatah/astrova/blob/main/src/App.tsx"
click node_planet_view "https://github.com/jawadalnatah/astrova/blob/main/src/components/showcase/PlanetShowcase.tsx"
click node_solar_system "https://github.com/jawadalnatah/astrova/blob/main/src/components/scene/SolarSystem.tsx"
click node_planet_scene "https://github.com/jawadalnatah/astrova/blob/main/src/components/scene/Planet.tsx"
click node_sun "https://github.com/jawadalnatah/astrova/blob/main/src/components/scene/Sun.tsx"
click node_asteroids "https://github.com/jawadalnatah/astrova/blob/main/src/components/scene/AsteroidBelt.tsx"
click node_planet_data "https://github.com/jawadalnatah/astrova/blob/main/src/data/planets.ts"
click node_planet_detail "https://github.com/jawadalnatah/astrova/blob/main/src/components/panels/PlanetDetailOverlay.tsx"
click node_moon_panel "https://github.com/jawadalnatah/astrova/blob/main/src/components/panels/MoonPhasePanel.tsx"
click node_timeline "https://github.com/jawadalnatah/astrova/blob/main/src/components/panels/EventTimelinePanel.tsx"
click node_hud_overlay "https://github.com/jawadalnatah/astrova/blob/main/src/components/hud/HUDOverlay.tsx"
click node_my_sky "https://github.com/jawadalnatah/astrova/blob/main/src/components/panels/MySkyPanel.tsx"
click node_planet_panel "https://github.com/jawadalnatah/astrova/blob/main/src/components/panels/PlanetPanel.tsx"
click node_cosmos_view "https://github.com/jawadalnatah/astrova/blob/main/src/components/showcase/CosmosGallery.tsx"
click node_cosmos_data "https://github.com/jawadalnatah/astrova/blob/main/src/data/cosmos.ts"
click node_observatory_view "https://github.com/jawadalnatah/astrova/blob/main/src/components/showcase/Observatory.tsx"
click node_observatory_scene "https://github.com/jawadalnatah/astrova/blob/main/src/components/showcase/ObservatoryScene.tsx"
click node_observatory_ui "https://github.com/jawadalnatah/astrova/blob/main/src/components/showcase/ObservatoryUI.tsx"
click node_observatory_data "https://github.com/jawadalnatah/astrova/blob/main/src/data/observatory.ts"
click node_showcase_scene "https://github.com/jawadalnatah/astrova/blob/main/src/components/showcase/ShowcaseScene.tsx"
click node_hud "https://github.com/jawadalnatah/astrova/blob/main/src/components/hud/HUD.tsx"
click node_navbar "https://github.com/jawadalnatah/astrova/blob/main/src/components/ui/Navbar.tsx"
click node_audio "https://github.com/jawadalnatah/astrova/blob/main/src/context/AudioContext.tsx"
click node_quality "https://github.com/jawadalnatah/astrova/blob/main/src/context/QualityContext.tsx"
click node_device_tier "https://github.com/jawadalnatah/astrova/blob/main/src/hooks/useDeviceTier.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 toneBlue
class node_planet_view,node_solar_system,node_planet_scene,node_sun,node_asteroids,node_planet_data,node_planet_detail,node_moon_panel,node_timeline,node_hud_overlay,node_my_sky,node_planet_panel,node_showcase_scene,node_hud toneAmber
class node_cosmos_view,node_cosmos_data,node_observatory_view,node_observatory_scene,node_observatory_ui,node_observatory_data toneMint
class node_navbar,node_audio,node_quality,node_device_tier toneRose
class node_visitor,node_neo_ws toneIndigo
```

## Components

### App Shell

- [View Router](https://github.com/jawadalnatah/astrova/blob/main/src/App.tsx): `src/App.tsx`

### Solar Exploration

- [Planet Showcase](https://github.com/jawadalnatah/astrova/blob/main/src/components/showcase/PlanetShowcase.tsx): `src/components/showcase/PlanetShowcase.tsx`
- [Solar System](https://github.com/jawadalnatah/astrova/blob/main/src/components/scene/SolarSystem.tsx): `src/components/scene/SolarSystem.tsx`
- [Planet Renderer](https://github.com/jawadalnatah/astrova/blob/main/src/components/scene/Planet.tsx): `src/components/scene/Planet.tsx`
- [Sun Renderer](https://github.com/jawadalnatah/astrova/blob/main/src/components/scene/Sun.tsx): `src/components/scene/Sun.tsx`
- [Asteroid Belt](https://github.com/jawadalnatah/astrova/blob/main/src/components/scene/AsteroidBelt.tsx): `src/components/scene/AsteroidBelt.tsx`
- [Planet Catalogue](https://github.com/jawadalnatah/astrova/blob/main/src/data/planets.ts): `src/data/planets.ts`
- [Planet Details](https://github.com/jawadalnatah/astrova/blob/main/src/components/panels/PlanetDetailOverlay.tsx): `src/components/panels/PlanetDetailOverlay.tsx`
- [Moon Phases](https://github.com/jawadalnatah/astrova/blob/main/src/components/panels/MoonPhasePanel.tsx): `src/components/panels/MoonPhasePanel.tsx`
- [Event Timeline](https://github.com/jawadalnatah/astrova/blob/main/src/components/panels/EventTimelinePanel.tsx): `src/components/panels/EventTimelinePanel.tsx`
- [Planet HUD](https://github.com/jawadalnatah/astrova/blob/main/src/components/hud/HUDOverlay.tsx): `src/components/hud/HUDOverlay.tsx`
- [My Sky Tonight](https://github.com/jawadalnatah/astrova/blob/main/src/components/panels/MySkyPanel.tsx): `src/components/panels/MySkyPanel.tsx`
- [Planet Panel](https://github.com/jawadalnatah/astrova/blob/main/src/components/panels/PlanetPanel.tsx): `src/components/panels/PlanetPanel.tsx`
- [Planet Showcase Scene](https://github.com/jawadalnatah/astrova/blob/main/src/components/showcase/ShowcaseScene.tsx): `src/components/showcase/ShowcaseScene.tsx`
- [HUD Controls](https://github.com/jawadalnatah/astrova/blob/main/src/components/hud/HUD.tsx): `src/components/hud/HUD.tsx`

### Cosmic Collections

- [Cosmos Gallery](https://github.com/jawadalnatah/astrova/blob/main/src/components/showcase/CosmosGallery.tsx): `src/components/showcase/CosmosGallery.tsx`
- [Cosmos Collection](https://github.com/jawadalnatah/astrova/blob/main/src/data/cosmos.ts): `src/data/cosmos.ts`
- [Observatory](https://github.com/jawadalnatah/astrova/blob/main/src/components/showcase/Observatory.tsx): `src/components/showcase/Observatory.tsx`
- [Observatory Scene](https://github.com/jawadalnatah/astrova/blob/main/src/components/showcase/ObservatoryScene.tsx): `src/components/showcase/ObservatoryScene.tsx`
- [Observatory Controls](https://github.com/jawadalnatah/astrova/blob/main/src/components/showcase/ObservatoryUI.tsx): `src/components/showcase/ObservatoryUI.tsx`
- [Observatory Objects](https://github.com/jawadalnatah/astrova/blob/main/src/data/observatory.ts): `src/data/observatory.ts`

### Shared Experience

- [Navigation](https://github.com/jawadalnatah/astrova/blob/main/src/components/ui/Navbar.tsx): `src/components/ui/Navbar.tsx`
- [Audio Settings](https://github.com/jawadalnatah/astrova/blob/main/src/context/AudioContext.tsx): `src/context/AudioContext.tsx`
- [Render Quality](https://github.com/jawadalnatah/astrova/blob/main/src/context/QualityContext.tsx): `src/context/QualityContext.tsx`
- [Device Tier](https://github.com/jawadalnatah/astrova/blob/main/src/hooks/useDeviceTier.ts): `src/hooks/useDeviceTier.ts`

### Other components

- **Visitor**
- **NASA NeoWs**

## Connections

- Visitor → View Router: opens (evidence: `README.md`)
- View Router → Planet Showcase: routes to (evidence: `src/App.tsx`)
- View Router → Cosmos Gallery: routes to (evidence: `src/App.tsx`)
- View Router → Observatory: routes to (evidence: `src/App.tsx`)
- Planet Showcase → Solar System: renders (evidence: `src/components/showcase/PlanetShowcase.tsx`)
- Planet Showcase → HUD Controls: renders (evidence: `src/components/showcase/PlanetShowcase.tsx`)
- Planet Showcase → Planet Showcase Scene: renders (evidence: `src/components/showcase/PlanetShowcase.tsx`)
- Planet Showcase → Navigation: renders (evidence: `src/components/showcase/PlanetShowcase.tsx`)
- Solar System → Planet Renderer: renders (evidence: `src/components/scene/SolarSystem.tsx`)
- Solar System → Sun Renderer: renders (evidence: `src/components/scene/SolarSystem.tsx`)
- Solar System → Asteroid Belt: renders (evidence: `src/components/scene/SolarSystem.tsx`)
- Solar System → Planet Catalogue: reads (evidence: `src/components/scene/SolarSystem.tsx`)
- Solar System → Planet Details: opens (evidence: `src/components/scene/SolarSystem.tsx`)
- Solar System → Moon Phases: opens (evidence: `src/components/scene/SolarSystem.tsx`)
- Solar System → Event Timeline: renders (evidence: `src/components/scene/SolarSystem.tsx`)
- Solar System → Planet HUD: renders (evidence: `src/components/scene/SolarSystem.tsx`)
- Planet Details → Planet Catalogue: reads (evidence: `src/components/panels/PlanetDetailOverlay.tsx`)
- Planet HUD → Planet Catalogue: reads (evidence: `src/components/hud/HUDOverlay.tsx`)
- Planet Showcase → Planet Catalogue: reads (evidence: `src/components/showcase/PlanetShowcase.tsx`)
- Planet Panel → Planet Catalogue: reads (evidence: `src/components/panels/PlanetPanel.tsx`)
- Planet Panel → My Sky Tonight: renders (evidence: `src/components/panels/PlanetPanel.tsx`)
- Asteroid Belt → NASA NeoWs: gets asteroid data (evidence: `README.md`)
- Cosmos Gallery → Cosmos Collection: reads (evidence: `src/components/showcase/CosmosGallery.tsx`)
- Cosmos Gallery → Navigation: renders (evidence: `src/components/showcase/CosmosGallery.tsx`)
- Observatory → Observatory Scene: renders (evidence: `src/components/showcase/Observatory.tsx`)
- Observatory → Observatory Controls: renders (evidence: `src/components/showcase/Observatory.tsx`)
- Observatory → Observatory Objects: reads (evidence: `src/components/showcase/Observatory.tsx`)
- Observatory → Navigation: renders (evidence: `src/components/showcase/Observatory.tsx`)
- Observatory Scene → Observatory Objects: reads (evidence: `src/components/showcase/ObservatoryScene.tsx`)
- Observatory Controls → Observatory Objects: reads (evidence: `src/components/showcase/ObservatoryUI.tsx`)
- Navigation → Audio Settings: controls (evidence: `src/components/ui/Navbar.tsx`)
- View Router → Audio Settings: provides (evidence: `src/App.tsx`)
- View Router → Render Quality: provides (evidence: `src/App.tsx`)
- Solar System → Device Tier: checks (evidence: `src/components/scene/SolarSystem.tsx`)
- Observatory → Device Tier: checks (evidence: `src/components/showcase/Observatory.tsx`)
- Observatory Scene → Device Tier: checks (evidence: `src/components/showcase/ObservatoryScene.tsx`)
