https://github.com/fluttersmith/xo_game
https://github.com/fluttersmith/xo_game
Last synced: 2 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/fluttersmith/xo_game
- Owner: FlutterSmith
- Created: 2025-02-01T19:10:06.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2025-02-01T20:13:51.000Z (3 months ago)
- Last Synced: 2025-02-01T20:25:11.454Z (3 months ago)
- Language: Dart
- Size: 63.5 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# 🧩 Advanced X‑O Game
📌 **Version:** 1.0.0
📅 **Last Updated:** [2, 2025]
👤 **Author:** [Ahmed Hamdy]
🔗 **Repository:** [(https://github.com/FlutterSmith)]
---
## 📖 Overview
**Advanced X‑O Game** is a feature‑rich Tic Tac Toe application built with **Flutter**. It leverages the power of the **BLoC** pattern for state management, integrates an adaptive AI with multiple difficulty levels, and provides full undo/redo functionality along with persistent game history storage via **sqflite**. The app boasts an intuitive, dynamic UI with light/dark theme support, offering a modern and polished gaming experience.
✅ **Player vs Player and Player vs Computer Modes**
✅ **Adaptive AI** (Easy, Medium, Hard, Adaptive)
✅ **Undo/Redo Moves with Persistent Game History**
✅ **Sleek UI with Theme Switching**
---
## 🚀 Features
### 🎮 Game Modes
✔ **Player vs Player (PvP)** for local multiplayer
✔ **Player vs Computer (PvC)** with sophisticated AI
### 🤖 Adaptive AI
✔ Multiple difficulty levels: **Easy**, **Medium**, **Hard**, and **Adaptive**
✔ AI utilizes the minimax algorithm (with depth control) for challenging gameplay
### 🔄 Undo/Redo & Game History
✔ **Undo** and **Redo** support for move corrections
✔ **Persistent Game History** stored locally using **sqflite**
### 🎨 Enhanced UI/UX
✔ Responsive design with dynamic light/dark theming
✔ Smooth animations and gradient backgrounds
✔ Modern, iOS-inspired interface
---
## 🛠️ Tech Stack
| Technology | Purpose |
|--------------------|---------------------------------------------------|
| **Flutter** | Cross‑platform mobile app development |
| **Dart** | Primary programming language |
| **BLoC** | State management and business logic handling |
| **sqflite** | Local persistence for game history |
| **flutter_bloc** | BLoC pattern integration with Flutter |
| **Equatable** | Simplifying value comparisons in state classes |
---
## 🚀 Installation
### 📌 Prerequisites
- ✅ **Flutter SDK** (Latest stable version)
- ✅ **Dart SDK** (Bundled with Flutter)
- ✅ **Android Studio / VS Code** (With Flutter extensions)
### 📦 Steps to Run
1️⃣ **Clone the Repository**
```
git clone https://github.com/yourusername/advanced_xo_game.git
cd advanced_xo_game
```
2️⃣ Install Dependencies
```
flutter pub get
```
3️⃣ Run the App
```
flutter run
```
📌 Future Improvements
✅ Custom Board Sizes & Win Conditions
✅ Enhanced Animations & Sound Effects
✅ Additional Game Modes & Online Leaderboards
✅ Localization for Multiple Languages
🏆 Contributors
DM me
📝 License
This project is licensed under the MIT License. See the LICENSE file for details.
📢 Enjoy playing Advanced X‑O Game! If you find this project helpful or exciting, please consider 🌟 starring the repository and contributing to its ongoing development. 🚀🔥