{"id":36964882,"url":"https://github.com/qtremors/cosmos","last_synced_at":"2026-01-13T19:47:55.742Z","repository":{"id":328644940,"uuid":"1114380750","full_name":"qtremors/cosmos","owner":"qtremors","description":"A high-performance, procedural virtual cosmos simulation built with React and Three.js. Features realistic orbital physics, volumetric shaders, and an active radar navigation system.","archived":false,"fork":false,"pushed_at":"2026-01-10T09:35:35.000Z","size":67408,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-01-11T02:51:30.358Z","etag":null,"topics":["react-typescript","simulation","space-exploration","three-js","visualization"],"latest_commit_sha":null,"homepage":"https://cosmox.vercel.app/","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/qtremors.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2025-12-11T09:41:05.000Z","updated_at":"2026-01-10T09:35:41.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/qtremors/cosmos","commit_stats":null,"previous_names":["qtremors/cosmos"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/qtremors/cosmos","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/qtremors%2Fcosmos","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/qtremors%2Fcosmos/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/qtremors%2Fcosmos/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/qtremors%2Fcosmos/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/qtremors","download_url":"https://codeload.github.com/qtremors/cosmos/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/qtremors%2Fcosmos/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28397830,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-13T14:36:09.778Z","status":"ssl_error","status_checked_at":"2026-01-13T14:35:19.697Z","response_time":56,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["react-typescript","simulation","space-exploration","three-js","visualization"],"created_at":"2026-01-13T19:47:55.116Z","updated_at":"2026-01-13T19:47:55.734Z","avatar_url":"https://github.com/qtremors.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n  \u003cimg src=\"cosmos-app/public/cosmos.png\" alt=\"Cosmos Logo\" width=\"128\"\u003e\n  \u003ch1 align=\"center\"\u003e\u003ca href=\"https://cosmox.vercel.app/\"\u003eCosmos\u003c/a\u003e\u003c/h1\u003e\n\u003c/p\u003e\n\n\u003e **Experience the infinite.** A modular, high-performance 3D solar system simulation running directly in your browser.\n\nExplore the solar system with **2K NASA textures**, realistic orbital mechanics, and a cinematic camera system with gamepad support.\n\n![License](https://img.shields.io/badge/License-Tremors_Source-purple.svg)\n![Version](https://img.shields.io/badge/Version-2.0.0-green.svg)\n![TypeScript](https://img.shields.io/badge/TypeScript-5.9-blue.svg)\n![React](https://img.shields.io/badge/React-19.2-61dafb.svg)\n![Three.js](https://img.shields.io/badge/Three.js-0.182-black.svg)\n\n---\n\n## ✨ Features\n\n### 🌍 Complete Solar System\n- **9 Planets** with 2K NASA texture maps\n- **Earth:** Day/night cycle with cloud layer\n- **Saturn:** Procedural ring system\n- **Uranus \u0026 Neptune:** Subtle ring systems\n- **4 Moons:** Moon, Europa, Titan, Charon\n- **Asteroid Belt:** 2000 instanced asteroids\n\n### 🏔️ Quantumania System (NEW in v1.6.0)\n- **Floating mountains** - 11 unique mountains with distinct themes\n- **The Nexus** - Central hub of Quantumania\n- **Local lighting** - Volcanic glow, crystal lights, city lights\n- **Distant beacon** - Purple pulsing light visible from Solar System\n- **Teleportation** - Click radar tabs to travel between systems\n\n### 🎨 Custom Shaders\n- **Sun:** Granulation + animated noise + corona\n- **Rocky Planets:** Surface textures with lighting\n- **Gas/Ice Giants:** Atmospheric effects and rings\n\n### 🥚 Easter Eggs\n- **Explorer-1:** Smart touring spaceship with collision avoidance\n- **The Kyln:** Massive Nova Corps prison from Guardians of the Galaxy\n- **Alien X:** Cosmic entity outside the solar system\n- **Sagittarius A\\*:** Supermassive black hole at the galactic center with raymarched accretion disk\n\n### 🎮 Controls\n| Action | Keyboard | Gamepad |\n|--------|----------|---------|\n| Move | WASD + R/F | Left Stick |\n| Look | Arrows / Mouse Drag | Right Stick |\n| Roll | Q/E | L1/R1 |\n| Boost | Shift (hold) | RT |\n| Zoom | Scroll | D-Pad |\n| Labels | L | - |\n| HUD | H | - |\n| Top View | T | - |\n| Unlock | Escape | - |\n\n---\n\n## 🚀 Getting Started\n\n```bash\ngit clone https://github.com/qtremors/cosmos.git\ncd cosmos/cosmos-app\nnpm install\nnpm run dev\n```\n\nOpen `http://localhost:5173`\n\n### Production Build\n\n```bash\nnpm run build\nnpm run preview\n```\n\n---\n\n## 🛠️ Tech Stack\n\n| Component | Technology |\n|-----------|------------|\n| Framework | React 19 |\n| 3D Engine | Three.js |\n| Language | TypeScript |\n| Build | Vite 7 |\n\n---\n\n## 📁 Project Structure\n\n```\ncosmos/\n├── README.md           # This file (source of truth)\n├── TASKS.md            # Development tasks\n├── CHANGELOG.md        # Version history\n└── cosmos-app/\n    ├── src/\n    │   ├── App.tsx         # Main scene, input, radar\n    │   ├── core/\n    │   │   ├── SDK.ts      # Physics constants \u0026 utilities\n    │   │   └── InputHandler.ts\n    │   ├── objects/        # All celestial bodies\n    │   └── materials/\n    │       └── Noise.ts    # Shared GLSL\n    └── public/\n        └── textures/       # 2K NASA textures\n```\n\n---\n\n## ⚙️ Configuration\n\nAll parameters in `src/core/SDK.ts`:\n\n| Config | Purpose |\n|--------|---------|\n| `UNITS` | Solar radius, AU scale |\n| `PLANETS` | Radius, distance, speed, eccentricity |\n| `CONTROLS` | Fly speed, boost, FOV |\n| `RADAR` | Range, entity colors |\n| `LIGHTING` | Sun intensity, ambient |\n\n---\n\n## 👷 Contributing\n\nSee [TASKS.md](TASKS.md) for open issues.\n\n**Branch Policy:**\n- Work on `ag-dev` branch\n- Only maintainer merges to `main`\n\n**Adding a Celestial Body:**\n1. Add config to `SDK.ts` → `PLANETS`\n2. Create class in `src/objects/`\n3. Add to scene in `App.tsx`\n4. Add to radar entities\n5. Update docs\n\n---\n\n## 📝 Changelog\n\nSee [CHANGELOG.md](CHANGELOG.md) for full history.\n\n**Recent:**\n- **v2.0.0** - Naming consistency overhaul, custom license, comment cleanup\n- **v1.9.5** - System-aware HUD, lazy model loading, camera transitions\n- **v1.9.0** - Test suite (Vitest), shader extraction\n\n---\n\n## 📄 License\n\nTremors Source License v1.1. See [LICENSE](LICENSE).\n\n- ✅ Fork \u0026 build with **permanent attribution**\n- ❌ Commercial use requires written permission\n\n---\n\n\u003cp align=\"center\"\u003e\n  Made with 💖 by \u003ca href=\"https://github.com/qtremors\"\u003eTremors\u003c/a\u003e\n\u003c/p\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fqtremors%2Fcosmos","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fqtremors%2Fcosmos","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fqtremors%2Fcosmos/lists"}