# pompomiiiii/solar-explorer architecture

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

- Interactive diagram: https://gitdiagram.com/pompomiiiii/solar-explorer
- Repository: https://github.com/pompomiiiii/solar-explorer

## Overview

Solar Explorer is a React-based 3D solar-system explorer. Visitors move among the Sun and eight planets using scroll, touch, keyboard, or navigation dots; the selected body drives both the scene camera and the animated information panel. The scene combines animated celestial bodies, stars, and bloom, while planet data supplies display content and procedural appearance. The README also documents responsive layouts and optional GLB models. Relationships below follow excerpts and README claims; unsampled styling and model-loading details are not inferred beyond that evidence.

Main entry points: [`solar-system/src/components/SolarSystem.jsx`](https://github.com/pompomiiiii/solar-explorer/blob/main/solar-system/src/components/SolarSystem.jsx) (Scene Composer), [`solar-system/src/App.jsx`](https://github.com/pompomiiiii/solar-explorer/blob/main/solar-system/src/App.jsx) (App Orchestrator), [`solar-system/src/components/Planet.jsx`](https://github.com/pompomiiiii/solar-explorer/blob/main/solar-system/src/components/Planet.jsx) (Planet Renderer), [`solar-system/src/components/Navigation.jsx`](https://github.com/pompomiiiii/solar-explorer/blob/main/solar-system/src/components/Navigation.jsx) (Body Selector)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["Explorer UI"]
  node_app["App Orchestrator<br/>[App.jsx]"]
  node_responsive["Responsive Layout<br/>[App.css]"]
  node_planet_info["Planet Info<br/>[PlanetInfo.jsx]"]
  node_scroll_hint["Scroll Progress<br/>[ScrollHint.jsx]"]
  node_entry["React Entry<br/>[main.jsx]"]
end

subgraph group_navigation["Body Navigation"]
  node_nav["Body Selector<br/>[Navigation.jsx]"]
  node_scroll_hook["Input Navigation"]
end

subgraph group_scene["3D Scene"]
  node_solar_scene["Scene Composer<br/>[SolarSystem.jsx]"]
  node_camera["Camera Transitions"]
  node_planet["Planet Renderer<br/>[Planet.jsx]"]
  node_sun["Sun Renderer<br/>[Sun.jsx]"]
  node_stars["Starfield<br/>[Stars.jsx]"]
end

subgraph group_content["Planet Content"]
  node_planet_data["Body Data<br/>[planets.js]"]
  node_models["Optional GLB Models"]
end

node_visitor(("Visitor"))

node_visitor -->|"scrolls or keys"| node_scroll_hook
node_visitor -->|"chooses body"| node_nav
node_entry -->|"renders"| node_app
node_app -->|"gets selection"| node_scroll_hook
node_app -->|"renders"| node_solar_scene
node_app -->|"renders"| node_planet_info
node_app -->|"renders"| node_nav
node_app -->|"renders"| node_scroll_hint
node_app -->|"imports styles"| node_responsive
node_scroll_hook -->|"updates index"| node_app
node_nav -->|"reads body labels"| node_planet_data
node_nav -->|"requests selection"| node_scroll_hook
node_planet_info -->|"reads descriptions and stats"| node_planet_data
node_solar_scene -->|"renders"| node_stars
node_solar_scene -->|"renders"| node_sun
node_solar_scene -->|"renders bodies"| node_planet
node_solar_scene -->|"renders controller"| node_camera
node_solar_scene -->|"maps planet data"| node_planet_data
node_planet -->|"registers position"| node_solar_scene
node_sun -->|"registers position"| node_solar_scene
node_camera -->|"requests target position"| node_solar_scene
node_solar_scene -->|"passes active index"| node_camera
node_planet -->|"uses body appearance"| node_planet_data
node_planet -.->|"optionally loads GLB"| node_models

click node_app "https://github.com/pompomiiiii/solar-explorer/blob/main/solar-system/src/App.jsx"
click node_responsive "https://github.com/pompomiiiii/solar-explorer/blob/main/solar-system/src/App.css"
click node_planet_info "https://github.com/pompomiiiii/solar-explorer/blob/main/solar-system/src/components/PlanetInfo.jsx"
click node_scroll_hint "https://github.com/pompomiiiii/solar-explorer/blob/main/solar-system/src/components/ScrollHint.jsx"
click node_nav "https://github.com/pompomiiiii/solar-explorer/blob/main/solar-system/src/components/Navigation.jsx"
click node_scroll_hook "https://github.com/pompomiiiii/solar-explorer/blob/main/solar-system/src/hooks/useScrollNavigation.js"
click node_solar_scene "https://github.com/pompomiiiii/solar-explorer/blob/main/solar-system/src/components/SolarSystem.jsx"
click node_camera "https://github.com/pompomiiiii/solar-explorer/blob/main/solar-system/src/components/CameraController.jsx"
click node_planet "https://github.com/pompomiiiii/solar-explorer/blob/main/solar-system/src/components/Planet.jsx"
click node_sun "https://github.com/pompomiiiii/solar-explorer/blob/main/solar-system/src/components/Sun.jsx"
click node_stars "https://github.com/pompomiiiii/solar-explorer/blob/main/solar-system/src/components/Stars.jsx"
click node_planet_data "https://github.com/pompomiiiii/solar-explorer/blob/main/solar-system/src/data/planets.js"
click node_models "https://github.com/pompomiiiii/solar-explorer/tree/main/solar-system/public/GLB"
click node_entry "https://github.com/pompomiiiii/solar-explorer/blob/main/solar-system/src/main.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,node_responsive,node_planet_info,node_scroll_hint,node_entry toneBlue
class node_nav,node_scroll_hook toneAmber
class node_solar_scene,node_camera,node_planet,node_sun,node_stars toneMint
class node_planet_data,node_models toneRose
class node_visitor toneIndigo
```

## Components

### Explorer UI

- [App Orchestrator](https://github.com/pompomiiiii/solar-explorer/blob/main/solar-system/src/App.jsx): `solar-system/src/App.jsx`
- [Responsive Layout](https://github.com/pompomiiiii/solar-explorer/blob/main/solar-system/src/App.css): `solar-system/src/App.css`
- [Planet Info](https://github.com/pompomiiiii/solar-explorer/blob/main/solar-system/src/components/PlanetInfo.jsx): `solar-system/src/components/PlanetInfo.jsx`
- [Scroll Progress](https://github.com/pompomiiiii/solar-explorer/blob/main/solar-system/src/components/ScrollHint.jsx): `solar-system/src/components/ScrollHint.jsx`
- [React Entry](https://github.com/pompomiiiii/solar-explorer/blob/main/solar-system/src/main.jsx): `solar-system/src/main.jsx`

### Body Navigation

- [Body Selector](https://github.com/pompomiiiii/solar-explorer/blob/main/solar-system/src/components/Navigation.jsx): `solar-system/src/components/Navigation.jsx`
- [Input Navigation](https://github.com/pompomiiiii/solar-explorer/blob/main/solar-system/src/hooks/useScrollNavigation.js): `solar-system/src/hooks/useScrollNavigation.js`

### 3D Scene

- [Scene Composer](https://github.com/pompomiiiii/solar-explorer/blob/main/solar-system/src/components/SolarSystem.jsx): `solar-system/src/components/SolarSystem.jsx`
- [Camera Transitions](https://github.com/pompomiiiii/solar-explorer/blob/main/solar-system/src/components/CameraController.jsx): `solar-system/src/components/CameraController.jsx`
- [Planet Renderer](https://github.com/pompomiiiii/solar-explorer/blob/main/solar-system/src/components/Planet.jsx): `solar-system/src/components/Planet.jsx`
- [Sun Renderer](https://github.com/pompomiiiii/solar-explorer/blob/main/solar-system/src/components/Sun.jsx): `solar-system/src/components/Sun.jsx`
- [Starfield](https://github.com/pompomiiiii/solar-explorer/blob/main/solar-system/src/components/Stars.jsx): `solar-system/src/components/Stars.jsx`

### Planet Content

- [Body Data](https://github.com/pompomiiiii/solar-explorer/blob/main/solar-system/src/data/planets.js): `solar-system/src/data/planets.js`
- [Optional GLB Models](https://github.com/pompomiiiii/solar-explorer/tree/main/solar-system/public/GLB): `solar-system/public/GLB`

### Other components

- **Visitor**

## Connections

- Visitor → Input Navigation: scrolls or keys (evidence: `solar-system/src/hooks/useScrollNavigation.js`)
- Visitor → Body Selector: chooses body (evidence: `solar-system/src/components/Navigation.jsx`)
- React Entry → App Orchestrator: renders (evidence: `solar-system/src/main.jsx`)
- App Orchestrator → Input Navigation: gets selection (evidence: `solar-system/src/App.jsx`)
- App Orchestrator → Scene Composer: renders (evidence: `solar-system/src/App.jsx`)
- App Orchestrator → Planet Info: renders (evidence: `solar-system/src/App.jsx`)
- App Orchestrator → Body Selector: renders (evidence: `solar-system/src/App.jsx`)
- App Orchestrator → Scroll Progress: renders (evidence: `solar-system/src/App.jsx`)
- App Orchestrator → Responsive Layout: imports styles (evidence: `solar-system/src/App.jsx`)
- Input Navigation → App Orchestrator: updates index (evidence: `solar-system/src/App.jsx`)
- Body Selector → Body Data: reads body labels (evidence: `solar-system/src/components/Navigation.jsx`)
- Body Selector → Input Navigation: requests selection (evidence: `solar-system/src/App.jsx`)
- Planet Info → Body Data: reads descriptions and stats (evidence: `solar-system/src/components/PlanetInfo.jsx`)
- Scene Composer → Starfield: renders (evidence: `solar-system/src/components/SolarSystem.jsx`)
- Scene Composer → Sun Renderer: renders (evidence: `solar-system/src/components/SolarSystem.jsx`)
- Scene Composer → Planet Renderer: renders bodies (evidence: `solar-system/src/components/SolarSystem.jsx`)
- Scene Composer → Camera Transitions: renders controller (evidence: `solar-system/src/components/SolarSystem.jsx`)
- Scene Composer → Body Data: maps planet data (evidence: `solar-system/src/components/SolarSystem.jsx`)
- Planet Renderer → Scene Composer: registers position (evidence: `solar-system/src/components/Planet.jsx`)
- Sun Renderer → Scene Composer: registers position (evidence: `solar-system/src/components/Sun.jsx`)
- Camera Transitions → Scene Composer: requests target position (evidence: `solar-system/src/components/SolarSystem.jsx`)
- Scene Composer → Camera Transitions: passes active index (evidence: `solar-system/src/components/SolarSystem.jsx`)
- Planet Renderer → Body Data: uses body appearance (evidence: `solar-system/src/components/SolarSystem.jsx`)
- Planet Renderer → Optional GLB Models: optionally loads GLB
