Tic-Tac-Dojo 🥋

Master the art of Tic-Tac-Toe through progressive AI challenges

Overview

Tic-Tac-Dojo is a React Native mobile game that transforms the classic game of Tic-Tac-Toe into a progressive martial arts journey. Players advance through increasingly challenging AI opponents, each representing a different level of mastery in the ancient art of X's and O's.

Try It Now! 🎮

Play Tic-Tac-Dojo directly in your browser:

Screenshots

How It Works

🎮 Game Flow

1. Start Your Journey: Launch the app and enter the dojo
2. Select Your Stage: Progress through 5 difficulty levels
3. Battle the AI: Make your moves on a 3x3 (or 4x4 for advanced levels) grid
4. Strategic Gameplay: Each AI opponent has unique behaviors and strategies
5. Level Up: Win matches to unlock new challenges and face stronger opponents

🤖 AI Progression System

The game features 5 distinct AI personalities with increasing difficulty:

• Level 1 - Novice (30% optimal play): Learn the basics against a beginner AI
• Level 2 - Apprentice (50% optimal play): Face an AI with pattern recognition
• Level 3 - Warrior (55-70% adaptive): Battle an adaptive AI that learns from defeats
• Level 4 - Master (60-70% adaptive): Challenge yourself on a 4x4 grid
• Level 5 - Grandmaster (95% optimal play): Face near-perfect AI with advanced strategies

🏆 Key Features

• Progressive Difficulty: AI opponents that adapt and become stronger
• Timed Challenges: Move and game time limits add pressure
• Scoring System: Comprehensive scoring that rewards strategic play
• Anti-Cheat Protection: Server-side validation ensures fair play
• Beautiful Animations: Smooth, responsive UI with delightful interactions
• Leaderboard: Compete globally and track your ranking

Tech Stack

Mobile App

• React Native with Expo
• TypeScript for type safety
• Tamagui for UI components
• Reanimated for smooth animations
• i18n for internationalization

Backend API

• Vercel serverless functions
• Firebase Firestore for data persistence
• Firebase Authentication for user authentication
• Advanced AI algorithms for opponent behavior
• Rate limiting and security measures

Architecture

tic-tac-dojo/
├── mobile/           # React Native app
├── api/             # Vercel serverless functions
├── admin/           # Admin dashboard
└── public/          # Static assets

Getting Started

The game is deployed and ready to play! The backend API is hosted on Vercel and the mobile app can be built for iOS, Android, and Web platforms.

API Base URL

https://tic-tac-dojo.vercel.app

Running on Mobile Devices

iOS Development Setup

# Navigate to the mobile directory
cd mobile

# Install dependencies
npm install

# Install iOS dependencies (macOS only)
cd ios && pod install && cd ..

# Start the development server
npm start

# Run on iOS simulator
npm run ios

# Or run on physical iOS device (requires Apple Developer account)
npx expo run:ios --device

Android Development Setup

# Navigate to the mobile directory
cd mobile

# Install dependencies
npm install

# Start the development server
npm start

# Run on Android emulator/device
npm run android

# Or run with Expo
npx expo run:android

Prerequisites

• For iOS: macOS with Xcode installed
• For Android: Android Studio with SDK and emulator setup
• Node.js 16+ and npm
• Expo CLI: npm install -g @expo/cli

Game Mechanics

• Grid Sizes: 3x3 for levels 1-3, 4x4 for advanced levels
• Turn-based: Player always plays as 'X' and moves first
• Win Conditions: Standard tic-tac-toe rules (3 or 4 in a row)
• Time Limits: Both per-move and total game time constraints
• Scoring: Points based on speed, moves, and strategic play

Security Features

• Server-side winner determination
• Move validation and anti-cheat detection
• Rate limiting on API endpoints
• Temporal validation for game timing
• Input sanitization

---

Made with ❤️ for strategy game enthusiasts