# Match 3 Game - Flutter/Flame

A cross-platform Match 3 puzzle game built with Flutter and Flame game engine.

## Technology Stack
- **Framework**: Flutter
- **Game Engine**: Flame
- **State Management**: Bloc/Cubit
- **Platforms**: iOS, Android, Web, Desktop

## Features
- Classic match-3 gameplay (8x8 grid)
- Smooth animations and particle effects
- Multiple game modes (Classic, Timed, Moves-limited)
- Power-ups and special gems
- Progressive difficulty levels
- Score tracking and achievements
- Cross-platform compatibility

## Project Structure
```
lib/
├── main.dart
├── game/
│   ├── match_three_game.dart      # Main game class
│   ├── components/                # Game components
│   │   ├── grid_component.dart
│   │   ├── gem_component.dart
│   │   └── ui_overlay.dart
│   ├── systems/                   # Game systems
│   │   ├── match_detector.dart
│   │   ├── gravity_system.dart
│   │   └── score_system.dart
│   └── models/                    # Data models
│       ├── gem.dart
│       ├── grid.dart
│       └── game_state.dart
├── screens/                       # UI screens
│   ├── menu_screen.dart
│   ├── game_screen.dart
│   └── settings_screen.dart
├── bloc/                         # State management
│   ├── game_bloc.dart
│   └── menu_bloc.dart
└── utils/
    ├── constants.dart
    └── helpers.dart
```

## Getting Started
1. Install Flutter SDK
2. Add Flame dependency
3. Run `flutter pub get`
4. Launch with `flutter run`