City Builder - Interactive House Construction Simulator

A dynamic and interactive city builder application that allows users to create, customize, and manage virtual houses with weather effects.

🌟 Features

• House Customization

  • Adjust house colors
  • Configure number of floors
  • Set custom house names
  • Individual floor color customization

• House Management

  • Add new houses
  • Duplicate existing houses
  • Remove houses
  • Drag and drop functionality for house placement

• Weather System

  • Dynamic weather effects (sun, rain)
  • Real-time weather transitions based on location

• Interactive UI

  • Hover effects for house configuration
  • Floor-level customization
  • Intuitive settings panel

🛠️ Tech Stack

• Next.js - React framework for production
• Tailwind CSS - Utility-first CSS framework
• React Query - Data fetching for weather API
• React Context API - State management,powerful tool that allows you to manage and share state across your component tree without prop drilling. I

⚙️ Development Timeline

Phase 1: Planning & Setup (9 hours)

• Requirements analysis and concerns review (2 hours)
• Implementation design and analysis (5 hours)
• Local environment setup (2 hours)

Phase 2: Core Development (20-35 hours)

• UI component development
• Page layout implementation
• Header component
• House list interface
• House and related components
• House configuration system
• Floor configuration system
• Data persistence and state management

Phase 3: Enhancements (8-15 hours)

• Animation implementation
• Drag and drop functionality
• Individual floor color customization
• Unit testing

📦 Data Persistence

The application uses localStorage for data persistence, ensuring that your city configuration remains intact between sessions.

Next.js Project setup

This is a Next.js project bootstrapped with create-next-app.

Getting Started

First, run the development server:

npm run dev
# or
yarn dev
# or
pnpm dev
# or
bun dev

Open http://localhost:3000 with your browser to see the result.

You can start editing the page by modifying app/page.tsx. The page auto-updates as you edit the file.

This project uses next/font to automatically optimize and load Geist, a new font family for Vercel.

Learn More

To learn more about Next.js, take a look at the following resources:

• Next.js Documentation - learn about Next.js features and API.
• Learn Next.js - an interactive Next.js tutorial.

You can check out the Next.js GitHub repository - your feedback and contributions are welcome!

Deploy on Vercel

The easiest way to deploy your Next.js app is to use the Vercel Platform from the creators of Next.js.

Check out our Next.js deployment documentation for more details.