Idle Forge — Production-Ready React Idle Game Template

## 🔥 Idle Forge — Production-Ready Idle Game Template

Idle Forge is a **fully functional idle crafting game template** built with **React + TypeScript**, designed to save you **weeks of foundational work**.

This is not tutorial code. It’s a battle-tested architecture with offline progress, automation, prestige, and robust save systems already solved.

---

## ✅ What’s Included

- ⛏️ **Multi-Step Production Chains**

  Ore → Bars → Tools with manual + automated job queues

- ⚙️ **Automation System**

  Individual workers, targeting, scaling costs

- 💾 **Industrial-Grade Save System**

  Auto-save, manual snapshots, import/export, save history (20 slots)

- ⏱️ **Offline Progress**

  Accurate simulation when the tab is closed

- 🔁 **Prestige System**

  Exponential multipliers with permanent unlocks

- 🏆 **Achievements**

  Reward-based progression hooks

- 🧠 **Shared Game Engine (@idle/core)**

  Reusable hooks, components, math utilities, theme system

- 🧪 **30 Tests Included**

  Playwright E2E + unit tests covering saves, ticks, automation

---

## 🧑‍💻 Who This Is For

✔ Indie developers shipping idle games  

✔ Web devs moving into game dev  

✔ Prototype builders validating ideas fast  

❌ Not a no-code builder  

❌ Assumes React + TypeScript familiarity

---

## 🎨 Easy Customization

- Balance numbers in one file

- Add resources, recipes, achievements by following examples

- Instant retheming via CSS variables

---

## ⚠️ What’s Not Included

- Audio assets

- Art/sprites

- Backend or multiplayer

- Monetization hooks

(This is a **foundation**, not a finished commercial game.)

---

## 🚀 Why Use This?

Building these systems from scratch takes **4–6 weeks**.

This template gives you:

- Clean architecture

- Tested mechanics

- No save corruption headaches

- No offline progress bugs

Ship your idea—not another save system.

---

## 📜 License

You may:

- Build & sell games using this template

- Modify freely for personal or commercial use

You may NOT:

- Resell this template or redistribute the source as a template

---

Questions? Drop a comment below.