3d-Solar-System-ThreeJS

KO | EN

gitlite — search

#hacktoberfest #ai #android #machine-learning #macos #windows #awesome #cli #kubernetes #vue #pytorch #mcp #ios #open-source

3d-Solar-System-ThreeJS

(★ 101)

An 3d Solar System Made Using Three JS and VibeCoding

3d-Solar-System-ThreeJS Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

<h1 align="center">✨3D Solar System Using 
& Vite - VibeCode🌌</h1>
 
 A visually interactive 3D Solar System simulation built with <a href="https://threejs.org/">Three.js</a> and <a href="https://vitejs.dev/">Vite</a>. 
 Explore the planets, their orbits, and the beauty of our solar neighborhood — all in your browser!
 
 
 <img src="https://img.shields.io/github/repo-size/SoumyaEXE/3d-Solar-System-ThreeJS?color=purple&style=for-the-badge" alt="Repo Size"/>
 <img src="https://img.shields.io/github/last-commit/SoumyaEXE/3d-Solar-System-ThreeJS?color=green&style=for-the-badge" alt="Last Commit"/>
 <img src="https://img.shields.io/github/stars/SoumyaEXE/3d-Solar-System-ThreeJS?style=for-the-badge&color=yellow" alt="Stars"/>
 <img src="https://img.shields.io/github/forks/SoumyaEXE/3d-Solar-System-ThreeJS?style=for-the-badge&color=orange" alt="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

---

## 🚀 Getting Started

### ✅ Prerequisites

- [Node.js](https://nodejs.org/) (v16+ recommended)  
- [npm](https://www.npmjs.com/) or [yarn](https://yarnpkg.com/)

### ⚙️ Installation

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

### ▶️ Running Locally

```bash
npm run dev
```
### 🔗 Then Open

```bash
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):

```bash
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

```bash
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

---

## 🤝 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](LICENSE) for details.

---

## 🌍 Credits

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

---

## 👥 Contributors

<a href="https://github.com/SoumyaEXE/3d-Solar-System-ThreeJS/graphs/contributors">
 <img src="https://contrib.rocks/image?repo=SoumyaEXE/3d-Solar-System-ThreeJS" alt="Contributors" style="border-radius: 50%;"/>
 </a>
 
 Thanks to all who have contributed!

3d-Solar-System-ThreeJS

3d-Solar-System-ThreeJS Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

3d-Solar-System-ThreeJS

3d-Solar-System-ThreeJS Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README