Skip to content

Latest commit

 

History

History
96 lines (68 loc) · 3.22 KB

README.md

File metadata and controls

96 lines (68 loc) · 3.22 KB

🧩 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

Advanced X‑O Game Demo


🚀 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. 🚀🔥