Skip to content

SoumyaEXE/3d-Solar-System-ThreeJS

Repository files navigation

✨3D Solar System Using ### 🔐 Environment Variables

Create a .env file in the project root to enable the Gemini-powered chatbot (currently using gemini-2.5-flash):

VITE_GEMINI_API_KEY=your_google_ai_studio_key

& Vite - VibeCode🌌

A visually interactive 3D Solar System simulation built with Three.js and Vite.
Explore the planets, their orbits, and the beauty of our solar neighborhood — all in your browser!

Repo Size Last Commit Stars Forks


✨ Features

  • 🌞 Realistic 3D models of the Sun and planets
  • 🪐 Animated orbits & rotations
  • 🌍 Scaled distances & sizes (for clarity)
  • 🖱️ Mouse controls — zoom, pan, and rotate
  • ⚡ Built with Vite for fast loading
  • 📱 Responsive design (desktop & mobile)

📸 Screenshots

Screenshot


🚀 Getting Started

✅ Prerequisites

⚙️ Installation

git clone https://github.com/SoumyaEXE/3d-Solar-System-ThreeJS.git
cd 3d-Solar-System-ThreeJS
npm install

▶️ Running Locally

npm run dev

🔗 Then Open

http://localhost:5173

� Environment Variables

Create a .env file in the project root to enable the Gemini-powered chatbot (currently tuned for the gemini-2.0-flash-latest model):

VITE_GEMINI_API_KEY=your_google_ai_studio_key

The development server will pick up changes automatically; restart it after editing the .env file when building for production.

�📦 Build for Production

npm run build

📂 Project Structure

.
├── public/
│   └── textures/      # Planet textures
├── src/
│   ├── main.js        # Main entry point
│   └── ...            # Other source files
├── index.html
├── package.json
├── vite.config.js
└── README.md

🛠️ Tech Stack

Tech Stack


🤝 Contributing

Contributions, issues, and feature requests are welcome!
Feel free to open an issue or submit a PR to improve the project.


📜 License

This project is licensed under the MIT License — see LICENSE for details.


🌍 Credits

  • 🌌 Planet textures: NASA
  • 🛰️ 3D inspiration: Three.js Examples

👥 Contributors

Contributors
Thanks to all who have contributed!