🎮 Sudoku Game Built with Flutter

A beautifully designed Sudoku game that combines Flutter's Material Design with intuitive gameplay, smooth animations, and responsive controls. This project leverages BLoC (Business Logic Component) state management, Dependency Injection, and Hive to create an engaging experience for Sudoku lovers. It also stores your past scores for tracking your progress over time.

---

📱 Screenshots

(Include your screenshots here to show different game modes, dark/light themes, etc.)

---

🎯 Features

• Multiple Game Modes: Choose from Easy, Medium, and Hard difficulty levels.
• BLoC State Management: Efficient and reactive state management for smooth gameplay.
• Dependency Injection: Streamlines and decouples the code, making it easier to maintain.
• Hive Storage: Stores past scores locally to track progress and encourage re-playability.
• Material Design: Beautiful UI with Material Design principles, ensuring a sleek and modern look.
• Undo/Redo Functionality: Allows undoing or redoing moves for an enhanced experience.
• Progress Save: Game progress is saved automatically to resume at any time.

---

🚀 Technologies Used

• Flutter: The core framework for building cross-platform mobile apps.
• Dart: The programming language used for Flutter development.
• BLoC: For efficient state management.
• Hive: Lightweight, NoSQL database for local storage of past scores.
• Dependency Injection: Ensures scalable and maintainable code.

---

📦 Installation

1. Ensure that you have Flutter installed. You can follow the installation guide here.
2. Clone this repository:

   git clone https://github.com/arpit24sahu/sudoku_game.git

3. Navigate to the project directory:

   cd sudoku-game

4. Get all dependencies:

   flutter pub get

5. Run the app:

   flutter run

---

🛠️ How It Works

1. Game Board: The Sudoku grid is displayed with numbers filled in for the selected difficulty.
2. Input: Players can select cells and input numbers.
3. Hints & Validation: The game validates moves and provides hints when needed.
4. Past Scores: Scores are stored using Hive and displayed on the leaderboard page.

---

📂 Folder Structure

sudoku-game-flutter/
├── lib/
│   ├── bloc/                          # BLoC files
│   ├── data/                          # Repository files
│   ├── domain/                     # Data models
│   ├── presentation/            # UI files
│   ├── main.dart                  # Main entry point
│   ├── injection.dart            # Dependency-injected services
└── pubspec.yaml                # Project dependencies

---

🧩 Future Improvements

• Online Multiplayer: Play Sudoku with friends or compete globally.
• Daily Challenges: New puzzles every day to keep users engaged.
• Achievements: Reward users for completing puzzles and milestones.

---

🤝 Contributing

Contributions are welcome! Feel free to submit issues and pull requests to improve the game.

---

📜 License

This project is licensed under the MIT License. See the LICENSE file for more details.

---

👨‍💻 Author

Developed by Arpit Sahu. Feel free to reach out for any questions or feedback!

---