How jawadalnatah/astrova works
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: SolarSystem.tsx Solar System · App.tsx View Router · PlanetShowcase.tsx Planet Showcase · Observatory.tsx Observatory
Components 27
App Shell
- View Router
src/App.tsx
Solar Exploration
- Planet Showcase
src/components/showcase/PlanetShowcase.tsx - Solar System
src/components/scene/SolarSystem.tsx - Planet Renderer
src/components/scene/Planet.tsx - Sun Renderer
src/components/scene/Sun.tsx - Asteroid Belt
src/components/scene/AsteroidBelt.tsx - Planet Catalogue
src/data/planets.ts - Planet Details
src/components/panels/PlanetDetailOverlay.tsx - Moon Phases
src/components/panels/MoonPhasePanel.tsx - Event Timeline
src/components/panels/EventTimelinePanel.tsx - Planet HUD
src/components/hud/HUDOverlay.tsx - My Sky Tonight
src/components/panels/MySkyPanel.tsx - Planet Panel
src/components/panels/PlanetPanel.tsx - Planet Showcase Scene
src/components/showcase/ShowcaseScene.tsx - HUD Controls
src/components/hud/HUD.tsx
Cosmic Collections
- Cosmos Gallery
src/components/showcase/CosmosGallery.tsx - Cosmos Collection
src/data/cosmos.ts - Observatory
src/components/showcase/Observatory.tsx - Observatory Scene
src/components/showcase/ObservatoryScene.tsx - Observatory Controls
src/components/showcase/ObservatoryUI.tsx - Observatory Objects
src/data/observatory.ts
Shared Experience
- Navigation
src/components/ui/Navbar.tsx - Audio Settings
src/context/AudioContext.tsx - Render Quality
src/context/QualityContext.tsx - Device Tier
src/hooks/useDeviceTier.ts
Other components
- Visitor
- NASA NeoWs
Connections 36
- Visitor → View Router: opens
README.md - View Router → Planet Showcase: routes to
src/App.tsx - View Router → Cosmos Gallery: routes to
src/App.tsx - View Router → Observatory: routes to
src/App.tsx - Planet Showcase → Solar System: renders
src/components/showcase/PlanetShowcase.tsx - Planet Showcase → HUD Controls: renders
src/components/showcase/PlanetShowcase.tsx - Planet Showcase → Planet Showcase Scene: renders
src/components/showcase/PlanetShowcase.tsx - Planet Showcase → Navigation: renders
src/components/showcase/PlanetShowcase.tsx - Solar System → Planet Renderer: renders
src/components/scene/SolarSystem.tsx - Solar System → Sun Renderer: renders
src/components/scene/SolarSystem.tsx - Solar System → Asteroid Belt: renders
src/components/scene/SolarSystem.tsx - Solar System → Planet Catalogue: reads
src/components/scene/SolarSystem.tsx - Solar System → Planet Details: opens
src/components/scene/SolarSystem.tsx - Solar System → Moon Phases: opens
src/components/scene/SolarSystem.tsx - Solar System → Event Timeline: renders
src/components/scene/SolarSystem.tsx - Solar System → Planet HUD: renders
src/components/scene/SolarSystem.tsx - Planet Details → Planet Catalogue: reads
src/components/panels/PlanetDetailOverlay.tsx - Planet HUD → Planet Catalogue: reads
src/components/hud/HUDOverlay.tsx - Planet Showcase → Planet Catalogue: reads
src/components/showcase/PlanetShowcase.tsx - Planet Panel → Planet Catalogue: reads
src/components/panels/PlanetPanel.tsx - Planet Panel → My Sky Tonight: renders
src/components/panels/PlanetPanel.tsx - Asteroid Belt → NASA NeoWs: gets asteroid data
README.md - Cosmos Gallery → Cosmos Collection: reads
src/components/showcase/CosmosGallery.tsx - Cosmos Gallery → Navigation: renders
src/components/showcase/CosmosGallery.tsx - Observatory → Observatory Scene: renders
src/components/showcase/Observatory.tsx - Observatory → Observatory Controls: renders
src/components/showcase/Observatory.tsx - Observatory → Observatory Objects: reads
src/components/showcase/Observatory.tsx - Observatory → Navigation: renders
src/components/showcase/Observatory.tsx - Observatory Scene → Observatory Objects: reads
src/components/showcase/ObservatoryScene.tsx - Observatory Controls → Observatory Objects: reads
src/components/showcase/ObservatoryUI.tsx - Navigation → Audio Settings: controls
src/components/ui/Navbar.tsx - View Router → Audio Settings: provides
src/App.tsx - View Router → Render Quality: provides
src/App.tsx - Solar System → Device Tier: checks
src/components/scene/SolarSystem.tsx - Observatory → Device Tier: checks
src/components/showcase/Observatory.tsx - Observatory Scene → Device Tier: checks
src/components/showcase/ObservatoryScene.tsx