{"id":30664512,"url":"https://github.com/flexsurfer/starrupture-planner","last_synced_at":"2026-06-17T23:31:15.141Z","repository":{"id":308921232,"uuid":"1033288457","full_name":"flexsurfer/starrupture-planner","owner":"flexsurfer","description":"The ultimate production planning tool for Star Rupture game - plan, optimize, and have fun!","archived":false,"fork":false,"pushed_at":"2026-05-16T11:11:37.000Z","size":10935,"stargazers_count":28,"open_issues_count":3,"forks_count":8,"subscribers_count":6,"default_branch":"main","last_synced_at":"2026-05-16T13:27:31.010Z","etag":null,"topics":["game-tools","production-planner","react","resource-management","typescript"],"latest_commit_sha":null,"homepage":"https://www.starrupture-planner.com/","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/flexsurfer.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","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":null,"dco":null,"cla":null}},"created_at":"2025-08-06T15:25:28.000Z","updated_at":"2026-05-16T11:11:26.000Z","dependencies_parsed_at":"2025-08-08T21:31:19.762Z","dependency_job_id":null,"html_url":"https://github.com/flexsurfer/starrupture-planner","commit_stats":null,"previous_names":["flexsurfer/starrupture-planner"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/flexsurfer/starrupture-planner","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/flexsurfer%2Fstarrupture-planner","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/flexsurfer%2Fstarrupture-planner/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/flexsurfer%2Fstarrupture-planner/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/flexsurfer%2Fstarrupture-planner/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/flexsurfer","download_url":"https://codeload.github.com/flexsurfer/starrupture-planner/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/flexsurfer%2Fstarrupture-planner/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34470322,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-17T02:00:05.408Z","response_time":127,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":["game-tools","production-planner","react","resource-management","typescript"],"created_at":"2025-08-31T19:03:21.116Z","updated_at":"2026-06-17T23:31:15.136Z","avatar_url":"https://github.com/flexsurfer.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Rupture Planner\n\n\u003cdiv align=\"center\"\u003e\n\n   \u003cimg src=\"./assets/logo_black_bg.webp\" width=\"100\" /\u003e\n\n\n**The Ultimate Production Planning Tool for Star Rupture**\n\n*Plan, optimize, and have fun with perfect resource management!* 🌌\n\n[![Built with React](https://img.shields.io/badge/React-19.1.0-blue?logo=react)](https://reactjs.org/)\n[![TypeScript](https://img.shields.io/badge/TypeScript-5.8.3-blue?logo=typescript)](https://www.typescriptlang.org/)\n[![Vite](https://img.shields.io/badge/Vite-7.0.4-646CFF?logo=vite)](https://vitejs.dev/)\n[![Tailwind CSS](https://img.shields.io/badge/Tailwind-4.1.11-38B2AC?logo=tailwind-css)](https://tailwindcss.com/)\n\n[🎮 Open Planner](https://www.starrupture-planner.com) • [🛠 Contribute](https://github.com/flexsurfer/starrupture-planner/blob/main/CONTRIBUTING.md)\n\n\u003c/div\u003e\n\n---\n\n## ✨ What is Rupture Planner?\n\nRupture Planner is a **free, open-source production planning tool** designed for the Star Rupture game. Whether you're a casual builder or a min-maxing efficiency expert, this tool helps you:\n\n- 🏭 **Visualize complex production chains** with interactive flow diagrams\n- 📊 **Calculate exact building requirements** for any production target\n- 🎯 **Optimize resource allocation** and eliminate bottlenecks\n- 🔍 **Browse all items and recipes** with advanced filtering\n- 🌙 **Work in comfort** with beautiful light/dark themes\n\n*Built by gamers, for gamers - just for the fun of it!* 🎉\n\n---\n\n## 🌟 Features\n\n### 📦 **Smart Item Catalog**\n- Browse all game items with beautiful icons\n- Filter by type: Raw Materials, Processed, Components, Ammo\n- Color-coded categories for instant recognition\n- Responsive grid layout that adapts to your screen\n\n### ⚗️ **Interactive Recipe Browser**\n- Collapsible building sections (closed by default for clean browsing)\n- Visual input/output relationships with item icons\n- Production rates clearly displayed for each recipe\n- Hover effects and smooth animations\n\n### 🏭 **Advanced Production Planner**\n- **Interactive Flow Diagrams**: See your entire production chain at a glance\n- **Smart Auto-Layout**: Uses Dagre algorithm for optimal node positioning\n- **Visual Production Flow**: Item icons on edges show what flows where\n- **Building Count Calculator**: Automatically calculates exact requirements\n- **Lazy Loading**: Optimized bundle splitting for fast initial load\n- **Auto-Fit View**: Automatically centers and scales diagrams when switching items\n- **Zoom \u0026 Pan**: Full navigation controls with minimap\n\n### 🎨 **Beautiful User Experience**\n- Modern, responsive design with Tailwind CSS + DaisyUI\n- Smooth animations and transitions\n- Light/Dark theme toggle\n- Intuitive tab-based navigation\n\n---\n\n## 🚀 Quick Start\n\n### Prerequisites\n- **Node.js** 18+ \n- **npm** or **yarn**\n\n### Installation\n\n```bash\n# Clone the repository\ngit clone https://github.com/flexsurfer/starrupture-planner.git\ncd starrupture-planner\n\n# Install dependencies\nnpm install\n\n# Start development server\nnpm run dev\n```\n\n🎉 **That's it!** Open `http://localhost:5173` and start planning your galactic empire!\n\n### Build for Production\n\n```bash\n# Create optimized build\nnpm run build\n\n# Preview production build\nnpm run preview\n```\n\n---\n\n## 🛠 Tech Stack\n\nThis project uses modern, cutting-edge technologies:\n\n| Technology | Purpose | Version |\n|------------|---------|---------|\n| **⚛️ React** | UI Framework | 19.1.0 |\n| **📘 TypeScript** | Type Safety | 5.8.3 |\n| **⚡ Vite** | Build Tool | 7.0.4 |\n| **🎨 Tailwind CSS** | Styling | 4.1.11 |\n| **🌸 DaisyUI** | UI Components | 5.0.50 |\n| **🔄 React Flow** | Interactive Diagrams | 12.8.2 |\n| **📊 Dagre** | Graph Layout | 0.8.5 |\n| **🔥 Reflex** | State Management | 0.1.12 |\n| **🧪 Vitest** | Testing | 3.2.4 |\n\n---\n\n## 📁 Project Structure\n\n```\nstarrupture-planner/\n├── 📄 README.md           # You are here!\n├── 🎨 assets/             # Static assets (images, icons)\n│   └── icons/\n│       ├── buildings/     # Building icons\n│       └── items/         # Item icons\n├── 🏗️ src/\n│   ├── components/        # React components\n│   │   ├── planner/       # Production planner logic\n│   │   └── ui/           # Reusable UI components\n│   ├── state/            # Reflex state management\n│   └── data/             # Game data (JSON)\n├── 📦 dist/              # Production build\n└── ⚙️ config files       # Vite, TypeScript, ESLint\n```\n\n---\n\n## 🎮 How to Use\n\n### 1. **Browse Items** 📦\n- Click the **Items** tab to explore all game items\n- Use category filters to find what you need\n- Each item shows its type with color coding\n\n### 2. **Explore Recipes** ⚗️\n- Visit the **Recipes** tab to see all production recipes\n- Click on any building header to expand/collapse its recipes\n- Visual flow shows inputs → building → outputs\n\n### 3. **Plan Production** 🏭\n- Go to the **Planner** tab for advanced planning\n- Select any item from the dropdown\n- Set your target production rate\n- Watch the magic happen! ✨\n\nThe planner will:\n- Calculate exact building counts needed\n- Show the complete supply chain\n- Display item flow rates between buildings\n- Auto-arrange everything in a clean diagram\n\n---\n\n## 🤝 Contributing\n\nWe love contributors! Whether you're fixing bugs, adding features, or improving docs, every contribution makes Rupture Planner better.\n\n### 🐛 Found a Bug?\n1. Check [existing issues](https://github.com/flexsurfer/starrupture-planner/issues)\n2. Create a new issue with:\n   - Clear description\n   - Steps to reproduce\n   - Expected vs actual behavior\n   - Screenshots if applicable\n\n### 💡 Have an Idea?\n1. Open an issue to discuss your idea\n2. We'll help you shape it into an actionable plan\n3. Fork, code, and submit a PR!\n\n### 🛠 Development Workflow\n\n```bash\n# 1. Fork and clone\ngit clone https://github.com/flexsurfer/starrupture-planner.git\ncd starrupture-planner\n\n# 2. Create feature branch\ngit checkout -b feature/awesome-feature\n\n# 3. Install and start\nnpm install\nnpm run dev\n\n# 4. Code your magic ✨\n# ... make your changes ...\n\n# 5. Test everything\nnpm run test\nnpm run lint\n\n# 6. Commit and push\ngit commit -m \"Add awesome feature\"\ngit push origin feature/awesome-feature\n\n# 7. Create Pull Request\n```\n\n### 📋 Contribution Guidelines\n\n- **Code Style**: We use ESLint + Prettier (runs automatically)\n- **Testing**: Add tests for new features\n- **Documentation**: Update README if needed\n- **Small PRs**: Keep changes focused and reviewable\n- **Have Fun**: This is a fun project - enjoy the process! 🎉\n\n### 🎨 Adding New Game Data\n\nGame data lives in `src/data/`:\n- `items_catalog.json` - All game items\n- `buildings_and_recipes.json` - Buildings and their recipes\n\nTo add new items/buildings:\n1. Update the JSON files\n2. Add corresponding icon images to `assets/icons/`\n3. Test in the app\n4. Submit a PR!\n\n---\n\n## 📄 License\n\nThis project is licensed under the **MIT License** - see the [LICENSE](LICENSE) file for details.\n\n**TL;DR**: Free to use, modify, and share. Just give credit where it's due! 🙏\n\n---\n\n## 🎯 Roadmap\n\nExciting features coming soon:\n\n- [ ] 🔧 **Recipe Optimization**: Find the most efficient production setups\n- [ ] 💾 **Save/Load Plans**: Bookmark your favorite production chains\n- [ ] 🔍 **Advanced Search**: Find items by name, type, or usage\n- [ ] 📊 **Resource Calculator**: Calculate total raw material needs\n- [ ] 🌐 **Multiplayer Planning**: Share plans with your team\n- [ ] 📱 **Mobile App**: Take your plans on the go\n- [ ] 🎨 **Custom Themes**: Personalize your planning experience\n\n---\n\n## 🙋‍♀️ FAQ\n\n**Q: Is this official?**  \nA: Nope! This is a fan-made tool built for fun by the community.\n\n**Q: Is it free?**  \nA: 100% free, open-source, and always will be!\n\n**Q: Can I contribute?**  \nA: Absolutely! We welcome all skill levels.\n\n**Q: Does it work on mobile?**  \nA: It's responsive and works on mobile, but desktop is recommended for complex planning.\n\n**Q: What if the game updates?**  \nA: We'll update the data files to match. Community help is always welcome!\n\n---\n\n## 💖 Acknowledgments\n\n- **Star Rupture** community for inspiration\n- **React Flow** team for amazing diagram capabilities\n- **Tailwind CSS** \u0026 **DaisyUI** for beautiful styling\n- All contributors and users who make this project awesome!\n\n---\n\n\u003cdiv align=\"center\"\u003e\n\n**Made with ❤️ by gamers, for gamers**\n\n*May your production lines be efficient and your resources abundant!* 🌌\n\n⭐ **Star this repo if it helped you!** ⭐\n\n[🐛 Report Bug](https://github.com/flexsurfer/starrupture-planner/issues) • \n[💡 Request Feature](https://github.com/flexsurfer/starrupture-planner/issues) • \n[🤝 Contribute](https://github.com/flexsurfer/starrupture-planner/pulls)\n\n\u003c/div\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fflexsurfer%2Fstarrupture-planner","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fflexsurfer%2Fstarrupture-planner","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fflexsurfer%2Fstarrupture-planner/lists"}