Skip to content

burakJs/Online-XOX-Flutter

Repository files navigation

Online XOX Game - Mobile Client 📱

Flutter Dart Style: Very Good Analysis License: MIT

A modern, real-time multiplayer Tic-tac-toe game built with Flutter. Features WebSocket communication, beautiful UI, and smooth animations.

🎮 Demo

online.xox.mp4

✨ Features

  • 🎮 Real-time multiplayer gameplay
  • 🌓 Dark/Light theme support
  • 🌍 Multi-language support (EN/TR)
  • 🎯 Easy game creation and joining
  • 📱 Responsive design for all screen sizes
  • 🔄 Automatic reconnection handling

🛠️ Tech Stack

  • Framework: Flutter
  • State Management: flutter_bloc (Cubit)
  • Local Storage: Hive
  • Network: web_socket_channel
  • Code Generation: freezed, json_serializable
  • Localization: easy_localization
  • DI: Provider

🏗️ Project Structure

lib/
├── core/              # Core functionality
│   ├── config/        # App configuration
│   ├── design/        # Design system
│   ├── network/       # Network services
│   ├── utils/         # Utilities
│   └── widgets/       # Shared widgets
├── features/          # App features
│   ├── auth/          # Authentication
│   ├── game/          # Game logic
│   └── home/          # Home screen
└── shared/           # Shared resources
    ├── cache/        # Local storage
    ├── extensions/   # Extensions
    ├── models/       # Data models
    └── providers/    # State providers

🚀 Getting Started

  1. Prerequisites

    flutter --version  # Ensure Flutter is installed
  2. Installation

    flutter pub get
  3. Run the app

    flutter run

🎯 Core Features

Authentication

  • First-time user name input
  • Persistent user data with Hive
  • Automatic login for returning users

Home Screen

  • Create/Join game functionality
  • One-tap game ID copying
  • Theme toggle
  • Language switcher

Game Screen

  • Real-time game board updates
  • Turn indicators
  • Win/Loss/Draw notifications
  • Smooth animations
  • Error handling

🎨 Design System

  • Enum-based spacing and padding
  • Consistent border radius values
  • Dark/Light theme support
  • Reusable components
  • Standardized animations

🌍 Localization

  • English and Turkish support
  • Easy addition of new languages
  • Persistent language preference
  • RTL support ready

🧪 Testing

  • Unit tests for game logic
  • Widget tests for UI components
  • Integration tests
  • Performance testing

📱 Performance

  • Fast app startup
  • Smooth animations
  • Efficient state management
  • Optimized asset loading

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

About

No description or website provided.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages