SudokuSlayer

Feature-rich Sudoku app for Android, designed for both beginners and experienced players.

SHA-256 hash of the signing certificate:
5B:04:C6:C7:45:6C:9A:63:44:81:04:1B:ED:18:F8:3E:C2:E9:07:22:FA:12:96:A3:A2:45:A1:55:80:6D:6F:E1

Table of Contents

1. Features
2. Planned Features
3. Screenshots
4. Installation
5. Contributing
6. License
7. Acknowledgements

Features

• Multiple Difficulties: Play Sudoku on four different difficulty levels: easy, medium, hard, and expert.
• Various Grid Sizes: Choose from three grid sizes: 4x4, 9x9, and 16x16.
• Hint System: Get a little help when you're stuck. The hint system will first highlight the cells you should focus on, and if that's not enough, it will guide you toward the solution.
• Statistics: Track your progress with the insights screen, which shows your game statistics.
• Themes: Customize the look of the app with four different themes: Catppuccin Latte, Frappe, Mocha, and Macchiato.
• Material 3 Expressive: Uses Material 3 Expressive components for a modern, dynamic UI.
• Customization: Tailor the app to your preferences with options to:
  • Show or hide the timer.
  • Highlight rows, columns, matching numbers, or numbers that break Sudoku rules.
  • Automatically clear notes when inputting a number.

Planned Features

• More Sudoku Types: Support for Killer Sudoku, Thermo Sudoku, and more.
• More Themes: Additional themes to further customize the app.
• Translations: Support for multiple languages.
• Challenges: Daily Sudokus and other challenges to test your skills.

Screenshots

Installation

Method	Link
Direct Download	Latest Release
Obtainium

Signature Verification

SHA-256 hash of the signing certificate:

5B:04:C6:C7:45:6C:9A:63:44:81:04:1B:ED:18:F8:3E:C2:E9:07:22:FA:12:96:A3:A2:45:A1:55:80:6D:6F:E1

Build from source

To build the app from source:

git clone https://github.com/mgrablo/SudokuSlayer
cd SudokuSlayer
./gradlew assembleRelease

Contributing

Contributions are welcome! If you want to contribute to SudokuSlayer, please follow these steps:

1. Fork the repository.
2. Create a new branch for your feature or bug fix.
3. Make your changes and commit them with a descriptive message.
4. Push your changes to your fork.
5. Create a pull request to the main repository.

Feel free to open an issue for bugs or feature requests.

License

This project is licensed under the GPL-3.0 License. See the LICENSE file for details.

Acknowledgements

This app is built with the help of several open-source libraries and resources. Thank you to all the developers and contributors who made this project possible.

Libraries

SudokuSlayer uses the following major open-source libraries:

• Jetpack Compose: For building the user interface.
• Kotlin Coroutines: For asynchronous programming.
• Koin: For dependency injection.
• SQLDelight: For local database storage.
• ConfettiKit: For the fun confetti animations.
• Reorderable: For reorderable lists in Compose.
• compose-unstyled: For building custom UI components.
• And many other great libraries! A full list can be found in the project's Gradle files.

Themes

• The color palettes are based on the Catppuccin theme.

Algorithms

• The Sudoku solver is based on the DLX (Dancing Links) algorithm, created by Donald Knuth.