IsoCity

Try for free at iso-city.com!

IsoCity is a open-source isometric city-building simulation game built with Next.js, TypeScript, and Tailwind CSS. It leverages the HTML5 Canvas API for high-performance rendering of isometric graphics, featuring complex systems for economic simulation, trains, planes, seaplanes, helicopters, cars, pedestrians, and more.

Made with Cursor

Features

• Isometric Rendering Engine: Custom-built rendering system using HTML5 Canvas (CanvasIsometricGrid) capable of handling complex depth sorting, layer management, and both image and drawn sprites.
• Dynamic Simulation:
  • Traffic System: Autonomous vehicles including cars, trains, and aircraft (planes/seaplanes).
  • Pedestrian System: Pathfinding and crowd simulation for city inhabitants.
  • Economy & Resources: Resource management, zoning (Residential, Commercial, Industrial), and city growth logic.
• Interactive Grid: Tile-based placement system for buildings, roads, parks, and utilities.
• State Management: Save/Load functionality for multiple cities.
• Responsive Design: Mobile-friendly interface with specialized touch controls and toolbars.

Tech Stack

• Framework: Next.js 16
• Language: TypeScript
• Graphics: HTML5 Canvas API (No external game engine libraries; pure native implementation).
• Icons: Lucide React.

Getting Started

Prerequisites

• Node.js (v18 or higher)
• npm or yarn

Installation

1. Clone the repository:

   git clone https://github.com/amilich/isometric-city.git
   cd isometric-city

2. Install dependencies:

   npm install

3. Run the development server:

   npm run dev

4. Open the game: Visit http://localhost:3000 in your browser.

Contributing

Contributions are welcome! Whether it's reporting a bug, proposing a new feature, or submitting a pull request, your input is valued.

Please ensure your code follows the existing style and conventions.

License

Distributed under the MIT License. See LICENSE for more information.