Skip to content

Kakuro Puzzle Game - A WPF desktop application using MVVM, featuring Japan's leading number logic puzzle with various difficulty levels and enhanced gameplay features.

License

Notifications You must be signed in to change notification settings

Denis-Bredun/Kakuro

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🧩 Kakuro – Desktop Puzzle Game Built with WPF

Kakuro is a Windows desktop application developed using .NET 8, WPF, and the MVVM pattern. It brings the classic logic puzzle Kakuro to life with an interactive UI, adjustable difficulty levels, validation system, save/load support, timer, and rating tables.


📦 Requirements


📥 Cloning the Repository

To download the project:

"git clone https://github.com/Denis-Bredun/Kakuro.git"

Then open the solution:

"Kakuro.sln"


🖥 Running the Application (Windows)

  1. Open the solution in Visual Studio 2022.

  2. In Solution Explorer, right-click on the Kakuro project and select Set as Startup Project.

  3. Click Rebuild to restore dependencies.

  4. Press F5 or click Start to launch the application.


🎮 Game Features

  • Three difficulty levels: Easy, Normal, Hard
  • Random puzzle generation with sum hints
  • Real-time validation of user input
  • Save and load functionality (up to 10 savepoints)
  • Rating tables by difficulty with top 10 results
  • Configurable options and in-game hints
  • Animated toast notifications for feedback
  • Keyboard navigation using WASD keys

🧪 Running Tests

  1. Open the solution: "Kakuro.sln"

  2. Go to Test → Test Explorer (Ctrl+E, T).

  3. You'll find tests inside the Kakuro.Tests project.

⚠️ This project was originally written following the Test-Driven Development (TDD) approach. However, due to strict time constraints, this discipline had to be abandoned midway to focus on getting a working version of the game.
As a result, tests are currently broken and do not execute, but you can still review how they were written for reference.


🚧 Deployment Attempts

There were also attempts to deploy the application using GitHub Actions workflows; however, these efforts were unsuccessful at the time due to limited remaining time before the project deadline, insufficient knowledge, and burnout by that stage.


📜 License

This project is released under the MIT License.

About

Kakuro Puzzle Game - A WPF desktop application using MVVM, featuring Japan's leading number logic puzzle with various difficulty levels and enhanced gameplay features.

Topics

Resources

License

Stars

Watchers

Forks

Languages