Skip to content

Swamstick911/coinquest

Repository files navigation

Coinquest

Coinquest is a browser-based incremental/idle game built with React and TailwindCSS. Players earn coins over time, buy upgrades to increase their income, and enjoy dynamic events and achievements that make the game more interactive and engaging.


Features

  • Idle Income System: Earn coins automatically based on your upgrades and multipliers.
  • Upgrades Shop: Buy upgrades to increase your income per second.
  • Random Events: Special events like festivals, droughts, and market crashes temporarily affect your income or upgrade costs.
  • Achievements: Unlock milestones to get permanent buffs and visual celebrations.
  • Dark/Light Mode: Switch themes for an immersive experience.
  • Coin Animations: Coins fly to your counter when earned (optional, can be removed for performance/UI focus).
  • Persistent Progress: All coins, upgrades, and settings are saved in localStorage.

Tech Stack

  • React – Frontend UI
  • TailwindCSS – Styling
  • GSAP – Animations (coins, confetti, achievements)
  • LocalStorage – Save game state

🚀 Getting Started

  1. Clone the repository:
git clone https://github.com/Swamstick911/coinquest

cd coinquest
  1. Install dependencies:
npm install
  1. Start the development server:
npm start