Eco-City Builder

Smart India Hackathon 2025 - SIH25009

Gamified Environmental Education Platform for Schools and Colleges

A story-driven sustainability simulation game where students build and manage eco-friendly cities while learning environmental science concepts through interactive gameplay.

🎮 Play Now

Live Demo: [Your deployment URL]

✨ Features

• 🏙️ Interactive City Building - Grid-based construction with 9 building types
• 📊 Real-Time Metrics - Track pollution, energy, water, green cover, and happiness
• 📖 Story Mode - Progressive missions with environmental narratives
• 🤔 Decision Making - Critical choices with visible consequences
• 🏆 Progression System - XP, levels, achievements, and badges
• 🎨 Beautiful UI - Modern design with smooth animations
• 📱 Responsive - Works on desktop, tablet, and mobile

🚀 Quick Start

# Install dependencies
npm install

# Start development server
npm run dev

# Build for production
npm run build

🎯 Game Overview

Chapter 1: Foundation Era

Build your first sustainable city through three missions:

1. Welcome to Eco-City - Establish basic infrastructure
2. Water & Waste - Implement resource management systems
3. Green Revolution - Maximize green coverage and happiness

Building Types

• 🏘️ Residential - Housing
• 🏢 Commercial - Business districts
• 🏭 Industrial - Manufacturing
• 🌳 Parks - Green spaces
• ☀️ Solar Farms - Renewable energy
• 💨 Wind Turbines - Clean power
• 💧 Water Treatment - Water supply
• ♻️ Recycling Centers - Waste management
• 🚇 Public Transit - Eco-transport

🛠️ Tech Stack

• Frontend: React 18 + TypeScript + Vite
• UI: Tailwind CSS + shadcn/ui
• State: Zustand
• Animations: Framer Motion
• Routing: React Router v6

📚 Documentation

See GAME_DOCUMENTATION.md for:

• Detailed game mechanics
• Technical architecture
• Design system
• Future roadmap
• Educational outcomes

🎓 Educational Value

Students learn:

• Environmental impact of urban development
• Resource management and trade-offs
• Renewable vs. non-renewable energy
• Systems thinking and planning
• Sustainability principles

🔮 Coming Soon

• Chapters 2-5 (Growth, Sustainability, Crisis, Future eras)
• Teacher dashboard with progress tracking
• ML-powered environmental simulation
• Multiplayer features
• Mobile native apps

📄 License

Built for Smart India Hackathon 2025 Problem Statement: SIH25009