Sudoku Mobile Game

A beautiful and feature-rich Sudoku mobile game built with React Native CLI.

Features

• Multiple difficulty levels (Easy, Medium, Hard, Expert, Master, Extreme)
• Daily challenges with progression system
• Game state persistence
• Notes mode for puzzle solving
• Hint system with limited uses
• Mistake tracking (3 strikes system)
• Undo/Redo functionality
• Clean and modern UI design
• Timer and statistics tracking

Prerequisites

• Node.js >= 14
• React Native CLI
• Xcode (for iOS)
• Android Studio (for Android)

Installation

1. Clone the repository:

git clone <repository-url>
cd SudokuApp

2. Install dependencies:

npm install

3. Install iOS dependencies:

cd ios
pod install
cd ..

Running the App

iOS

npm run ios

Android

npm run android

Project Structure

src/
├── components/     # Reusable UI components
├── screens/        # Screen components
├── context/        # Game state management
├── utils/          # Game logic utilities
├── types/         # TypeScript type definitions
├── constants/     # App constants
└── assets/        # Images and other assets

Game Logic

The game implements standard Sudoku rules:

• Each row must contain numbers 1-9 without repetition
• Each column must contain numbers 1-9 without repetition
• Each 3x3 box must contain numbers 1-9 without repetition

Difficulty Levels

• Easy: 35 pre-filled cells
• Medium: 30 pre-filled cells
• Hard: 25 pre-filled cells
• Expert: 22 pre-filled cells
• Master: 20 pre-filled cells
• Extreme: 17 pre-filled cells

Daily Challenges

• A new puzzle is generated each day
• Progress is tracked for unlocking higher difficulties
• Consistent puzzle generation based on date

Contributing

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add some amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

License

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