Experience the infinite. A 3D space exploration simulator featuring the Solar System, the Quantumania realm, and cosmic easter eggs — built with Three.js and custom GLSL shaders.
Note
Personal Project 🎯 I've always been fascinated by space and the vastness of the cosmos. That passion inspired me to build this project. Feel free to explore and learn from it!
| Feature | Description |
|---|---|
| 🌍 Solar System | 9 planets with 2K NASA textures, 4 moons, 2000 asteroids |
| 🏔️ Quantumania | Secondary realm with 38 floating 3D models — mountains, structures, ships, and inhabitants |
| 🎨 Custom Shaders | Sun granulation, Earth day/night cycle, raymarched black hole |
| 🎮 6-DOF Controls | Keyboard, mouse, and full gamepad support |
| 🥚 Easter Eggs | Black Hole, The Kyln, Explorer, Alien X |
| 👾 Arishem | Massive 3D Cosmic Entity (The Architect) with interior details |
| 📡 Radar System | Minimap with entity tracking and teleportation |
Warning
Resource Intensive: This project can consume 6-7 GB of RAM when running on devices without an external dedicated GPU. Ensure you have sufficient system resources before launching.
Live Website Limitations: Performance depends on device GPU capabilities.
# Clone and navigate
git clone https://github.com/qtremors/cosmos.git
cd cosmos/cosmos-app
# Install dependencies
npm install
# Run the project
npm run devVisit http://localhost:5173 🎉
| Action | Keyboard | Gamepad |
|---|---|---|
| Move | WASD + R/F | Left Stick |
| Look | Arrows / Mouse | Right Stick |
| Roll | Q/E | L1/R1 |
| Boost | Shift (hold) | RT |
| Teleport | Tab | - |
| Labels | L | - |
| HUD | H | - |
| Layer | Technology |
|---|---|
| Framework | React 19 |
| 3D Engine | Three.js 0.182 |
| Language | TypeScript 5.9 |
| Build | Vite 7 |
| Testing | Vitest |
cosmos/
├── cosmos-app/
│ ├── src/
│ │ ├── App.tsx # Main scene and animation loop
│ │ ├── main.tsx # Entry point
│ │ ├── index.css # Global styles
│ │ ├── core/ # SDK, InputHandler, SystemManager
│ │ ├── objects/ # Component-based 3D entities
│ │ │ ├── solar/ # Planets and moons
│ │ │ ├── quantumania/ # Realm-specific models
│ │ │ └── common/ # Shared 3D objects
│ │ ├── shaders/ # Custom GLSL (sun, earth, blackhole, etc.)
│ │ ├── materials/ # Shared material logic
│ │ ├── components/ # React UI components
│ │ ├── assets/ # Static SVG/Image assets
│ │ ├── utils/ # Shared utilities
│ │ └── __tests__/ # Vitest unit tests
│ └── public/
│ ├── textures/ # 2K NASA textures
│ └── models/ # 38+ GLB models
├── DEVELOPMENT.md # Architecture & setup
├── CHANGELOG.md # Version history
├── TASKS.md # Roadmap & backlog
└── LICENSE.md # TSL License
- CPU: Moderate (calculation heavy)
- RAM: 6-7 GB (High, especially without dGPU)
- Disk: ~60MB (Assets)
| Document | Description |
|---|---|
| DEVELOPMENT.md | Architecture, configuration, contributing |
| CHANGELOG.md | Version history and release notes |
| TASKS.md | Current and planned development tasks |
| LICENSE.md | License terms and attribution |
cd cosmos-app
npm testTremors Source License (TSL) - Source-available license allowing viewing, forking, and derivative works with mandatory attribution. Commercial use requires written permission.
See LICENSE.md for full terms.
Made with ❤️ by Tremors