How jackzyx/hackslop-lunar works
Sun Shade is a browser-based lunar south-pole landing-site planner. Users choose a date, compare sites, and adjust a launch slip to see sunlight and Earth-contact metrics over LOLA terrain; the app also supports custom sites, terrain views, validation, and an animated introduction. Python science modules compute ephemerides and horizon masks for static runtime data, while browser code calculates metrics and renders terrain. Edges reflect shown calls or README statements; unsampled component wiring is omitted.
Main entry points: App.jsx Planner interface · main.jsx Browser bootstrap · shadow.js Terrain shadowing · terrain-3d.js 3D terrain view
Components 23
Application workflow
- Browser bootstrap
web/src/main.jsx - Page routing
web/src/lib/routes.js - Planner interface
web/src/App.jsx - Date selection
web/src/components/LandingDatePicker.jsx - Custom sites
web/src/domain/custom-site.js - Site details
web/src/components/DetailTabs.jsx - Animated introduction
web/src/intro/intro.js
Site analysis
- Best-day search
web/src/domain/best-days.js - Visibility metrics
web/src/domain/metrics.js
Terrain and visuals
- Terrain startup
web/src/terrain/startup.js - 3D terrain view
web/src/terrain/terrain-3d.js - Terrain shadowing
web/src/terrain/shadow.js - Shadow worker
web/src/terrain/shadow.worker.js - Terrain map
web/src/components/ShadowMap.jsx - Surface rendering
web/src/terrain/surface-renderer.js - Intro asset preparation
web/src/intro/intro-assets.js
Science and data
- Planner data loader
web/src/lib/data.js - Lunar ephemeris
science/lunar_ephemeris.py - Horizon masks
science/horizon_mask.py - Horizons validation
science/validate_horizons.py - Shipped static data
web/src/lib/data.js
Other components
- Planner user
- JPL Horizons
Connections 25
- Planner user → Browser bootstrap: opens app
web/src/main.jsx - Browser bootstrap → Page routing: resolves page
web/src/main.jsx - Browser bootstrap → Planner interface: loads and mounts
web/src/main.jsx - Browser bootstrap → Planner data loader: loads data
web/src/main.jsx - Browser bootstrap → Terrain startup: loads terrain
web/src/main.jsx - Browser bootstrap → Animated introduction: starts intro
web/src/main.jsx - Planner interface → Planner data loader: loads planner data
web/src/App.jsx - Planner interface → Custom sites: manages sites
web/src/App.jsx - Planner interface → Visibility metrics: imports metrics
web/src/App.jsx - Planner interface → Date selection: renders picker
- Planner interface → Site details: presents details
- Custom sites → Terrain shadowing: uses terrain
web/src/domain/custom-site.js - Terrain startup → Terrain shadowing: uses shading
web/src/terrain/startup.js - 3D terrain view → Terrain shadowing: uses terrain math
web/src/terrain/terrain-3d.js - 3D terrain view → Terrain map: renders map
- 3D terrain view → Surface rendering: renders surface
- Shadow worker → Terrain shadowing: renders shadows
web/src/terrain/shadow.worker.js - Terrain shadowing → Visibility metrics: uses Sun fraction
web/src/terrain/shadow.js - Animated introduction → Intro asset preparation: prepares assets
web/src/intro/intro.js - Intro asset preparation → Terrain shadowing: shades terrain
web/src/intro/intro-assets.js - Planner interface → Best-day search: offers best days
- Lunar ephemeris → Shipped static data: supplies ephemeris
README.md - Horizon masks → Shipped static data: supplies masks
README.md - Horizons validation → JPL Horizons: validates against
README.md - Shipped static data → Planner interface: provides runtime data
README.md