Othello

A modern, accessible implementation of the classic Othello (Reversi) board game built with SwiftUI and Swift Testing. Currently available for macOS with iOS adaptation ready.

Features

• Human vs Human: Local multiplayer with clear turn indicators
• AI Opponents: Three difficulty levels (Easy, Medium, Hard)
• Accessibility First: Full VoiceOver support, Dynamic Type, high contrast
• Modern iOS: Built for iOS 18 with SwiftUI and Swift Testing
• Future Ready: Prepared for Game Center and multiplayer sharing

Requirements

• macOS 14.0+ (current implementation)
• iOS 18.0+ (planned)
• Xcode 16.0+
• Swift 6.0+

Getting Started

Prerequisites

• macOS 14.0+ (Primary platform)
• Xcode 16.0+ with Swift 5.9
• SwiftLint and XcodeGen for development

Setup

1. Clone the repository:

   git clone <repository-url>
   cd othello-claude-4

2. Install dependencies:

   brew install swiftlint xcodegen

3. Generate and open project:

   ./scripts/generate-project.sh
   open Othello.xcodeproj

4. Build and run (⌘+R)

Development

• Project is managed by XcodeGen - edit project.yml instead of .xcodeproj
• Pre-commit hooks ensure code quality and test compilation
• Generated project files are gitignored - run ./scripts/generate-project.sh after pulling changes

Game Rules

Othello is played on an 8x8 board with black and white discs. Players take turns placing discs to capture opponent pieces by flanking them. The player with the most discs when no more moves are possible wins.

Architecture

This app follows MVVM + Clean Architecture principles:

• Models: Game state, board representation, player management
• ViewModels: Business logic and state management
• Views: SwiftUI components with built-in accessibility
• Services: AI engine, game rules, persistence

Testing

Run tests with ⌘+U in Xcode or:

xcodebuild test -scheme Othello -destination 'platform=macOS'

Note: Tests use Swift Testing framework and build successfully. Manual verification may be needed for command-line test execution.

Current Status

✅ Phase 5 Complete: Advanced AI implementation with 3-tier difficulty system
🎯 Next: iOS adaptation and App Store deployment
📋 Future: Full Apple ecosystem expansion (iPadOS, tvOS, watchOS)

Project Documentation

Core Documentation (Root)

• AGENTS.md - AI agent development guidelines and coding standards
• TODO.md - Current development roadmap and task tracking
• PLATFORM-STRATEGY.md - Multi-platform expansion strategy

Extended Documentation (docs/)

• QUALITY-EXCELLENCE.md - Quality framework and standards
• SECURITY.md - Security implementation and best practices
• OBSERVABILITY.md - Logging, monitoring, and performance tracking
• LOCALIZATION.md - Internationalization and localization guide
• CONTRIBUTING.md - Contribution guidelines and setup
• GITHUB-SETUP.md - GitHub configuration and CI/CD
• SERVER-TODO.md - Server-side features and multiplayer roadmap

Contributing

Please read the development guidelines in AGENTS.md and ensure all quality gates are met.

License

MIT License - see LICENSE file for details.