How nikatsg/project-dune works
This is a Dune-themed planetary exploration prototype: users switch among planets, inspect landmarks and lore through an archive overlay, and view a 3D globe with simulated wind and storms. The sampled code shows the frontend loading planet data from an Express API backed by Prisma/SQLite, while README describes procedural worlds and camera movement. Archive categories are documented by the API routes and UI, but several implementations were not sampled; edges are limited to visible calls, imports, and documented capabilities.
Main entry points: App.tsx Scene Coordinator · WindSimulation.tsx Wind Simulation View · Planet.tsx Planet Globe · StormVisualizer.tsx Storm Visualizer
Components 22
Exploration UI
- Scene Coordinator
src/app/App.tsx - Archive Overlay
src/components/uiShit/MasterOverlay.tsx - Lore Archive
src/components/uiShit/databaseArchive.tsx - Species Details
src/components/uiShit/SpeciesPanel.tsx
Planet Rendering
- Planet Globe
src/components/Planet.tsx - Planet Atmosphere
src/components/atmosphere_v3.tsx - Landmark Markers
src/components/landmarkMarker.tsx - Coordinate Mapping
src/lib/coordinates.ts
Atmospheric Simulation
- Wind Simulation View
src/components/environment/WindSystem/WindSimulation.tsx - Wind Engine
src/components/environment/WindSystem/WindEngine.ts - Wind Configuration
src/components/environment/WindSystem/EnvironmentConfig.ts - Atmosphere Shaders
src/components/environment/WindSystem/shaders.ts - Storm Visualizer
src/components/environment/StormSystem/StormVisualizer.tsx - Storm Engine
src/components/environment/StormSystem/StormEngine.ts
Lore and API
- Planet Data Hook
src/hooks/hookPlanets.ts - Glossary Hook
src/hooks/hookTerms.ts - Lore Data Types
src/lib/blueprint.ts - Lore API
backend/index.ts - Planet Endpoints
backend/routes/planets.ts - Lore Endpoints
backend/routes - SQLite Database
backend/db.ts
Other components
- Explorer
Connections 25
- Explorer → Scene Coordinator: explores
- Scene Coordinator → Planet Data Hook: loads planets
src/app/App.tsx - Scene Coordinator → Glossary Hook: loads terms
src/app/App.tsx - Scene Coordinator → Archive Overlay: renders
src/app/App.tsx - Scene Coordinator → Planet Globe: renders
src/app/App.tsx - Scene Coordinator → Wind Simulation View: renders
src/app/App.tsx - Archive Overlay → Lore Archive: renders
src/components/uiShit/MasterOverlay.tsx - Lore Archive → Species Details: renders
src/components/uiShit/databaseArchive.tsx - Planet Globe → Planet Atmosphere: uses
src/components/Planet.tsx - Planet Globe → Landmark Markers: renders
src/components/Planet.tsx - Landmark Markers → Coordinate Mapping: maps positions
src/components/landmarkMarker.tsx - Scene Coordinator → Coordinate Mapping: targets camera
src/app/App.tsx - Wind Simulation View → Wind Engine: uses
src/components/environment/WindSystem/WindSimulation.tsx - Wind Simulation View → Storm Visualizer: renders
src/components/environment/WindSystem/WindSimulation.tsx - Wind Simulation View → Atmosphere Shaders: uses
src/components/environment/WindSystem/WindSimulation.tsx - Wind Engine → Wind Configuration: reads config
src/components/environment/WindSystem/WindEngine.ts - Storm Visualizer → Storm Engine: uses
src/components/environment/StormSystem/StormVisualizer.tsx - Storm Visualizer → Atmosphere Shaders: uses
src/components/environment/StormSystem/StormVisualizer.tsx - Storm Engine → Wind Engine: samples wind
src/components/environment/StormSystem/StormEngine.ts - Planet Data Hook → Planet Endpoints: fetches planets
src/hooks/hookPlanets.ts - Glossary Hook → Lore Endpoints: fetches terms
- Lore API → Planet Endpoints: mounts routes
backend/index.ts - Lore API → Lore Endpoints: mounts routes
backend/index.ts - Planet Endpoints → SQLite Database: queries
backend/routes/planets.ts - Lore Endpoints → SQLite Database: queries
backend/routes/planets.ts