Skip to content

SKT1803/3d-milkyway-explorer

Repository files navigation

3D Milky Way Explorer Logo

3D Milky Way Explorer

An interactive 3D journey through the Milky Way galaxy — explore star systems, dive into planetary systems, and navigate celestial bodies in real time.

🌐 Live Demo: Try it on Vercel


🌌 About the Project

3D Milky Way Explorer is a fully interactive, real-time 3D visualization of our galaxy and nearby star systems.

Unlike static space visualizations, this project allows users to:

  • Navigate freely inside the Milky Way
  • Enter star systems via warp transitions
  • Explore planetary systems down to moons and belts
  • Interact with celestial bodies using both UI and direct scene clicks

The project is built with a state-driven navigation architecture, ensuring smooth transitions between galaxy, star system, and planetary views.


🚀 Key Features

  • 🌌 Procedural Milky Way Galaxy
  • Multiple Star Systems
    • Solar System
    • Sirius Binary System
    • Alpha Centauri Triple System
  • 🪐 Fully Modeled Planetary Systems
    • Planets, dwarf planets, moons
    • Asteroid Belt & Kuiper Belt
  • 🎥 Advanced Camera Controls
    • Warp-in / warp-out transitions
    • Focus & reset per system
  • 🧭 UI + 3D Scene Synchronization
    • Click planets directly
    • Or navigate via the info panel
  • Dynamic Labels
    • Distance-aware scaling
    • Context-sensitive visibility
  • High Performance Rendering
    • Instancing
    • Optimized geometries
    • Smart visibility management

🧭 Navigation Experience

  1. Galaxy View
    • Free camera navigation
    • Select destinations (Solar System, Sirius, Alpha Centauri)
  2. Warp Transition
    • Smooth animated entry into star systems
  3. Inner Space
    • Planetary orbits
    • Moons & sub-systems
    • Focused exploration
  4. Return to Galaxy
    • Animated exit with spatial scaling

🛠 Tech Stack

  • React
  • React Three Fiber
  • Three.js
  • @react-three/drei
  • WebGL
  • Vite
  • Tailwind CSS

💻 Running Locally

npm install
npm run dev

📸 Previews

Milky Way - overview
Milky Way — Galaxy overview
Milky Way - navigation
Sirius System — Inner system view
Warp transition
Sirius A — Focus view
Inner space - entry
Sirius B — Focus view
Sun system overview
Alpha Centauri — Inner system view
Solar system - orbits
Rigil Kentaurus (Alpha Centauri A) — Focus view
Planet focus view
Proxima Centauri — Focus view
Moon system view
Solar System — Sun distant view
Asteroid belt view
Mercury — Planet focus view
Kuiper belt view
Venus — Planet focus view
Sirius system overview
Earth — Planet focus view
Sirius inner view
Mars — Planet focus view
Sirius A focus
Jupiter — Planet focus view
Sirius B focus
Saturn — Planet focus view
Alpha Centauri system overview
Uranus — Planet focus view
Alpha Centauri inner view
Neptune — Planet focus view
Alpha Centauri A focus
Pluto — Dwarf planet focus
Alpha Centauri B focus
Haumea — Dwarf planet focus
Proxima Centauri focus
Makemake — Dwarf planet focus
UI info panel navigation
Eris — Dwarf planet focus
Labels and scaling
Asteroid Belt — Inner belt focus
Final overview
Kuiper Belt — Outer belt focus