https://github.com/Denys-Bredun/Kakuro
Kakuro Puzzle Game - A WPF desktop application using MVVM, featuring Japan's leading number logic puzzle with various difficulty levels and enhanced gameplay features.
https://github.com/Denys-Bredun/Kakuro
csharp kakuro kakuro-game kakuropuzzle mvvm mvvm-architecture wpf wpf-application
Last synced: 9 months ago
JSON representation
Kakuro Puzzle Game - A WPF desktop application using MVVM, featuring Japan's leading number logic puzzle with various difficulty levels and enhanced gameplay features.
- Host: GitHub
- URL: https://github.com/Denys-Bredun/Kakuro
- Owner: chelicksst
- License: other
- Created: 2024-09-14T16:45:19.000Z (almost 2 years ago)
- Default Branch: master
- Last Pushed: 2024-11-16T02:19:21.000Z (over 1 year ago)
- Last Synced: 2025-02-02T20:30:17.371Z (over 1 year ago)
- Topics: csharp, kakuro, kakuro-game, kakuropuzzle, mvvm, mvvm-architecture, wpf, wpf-application
- Language: C#
- Homepage:
- Size: 5.27 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.txt
Awesome Lists containing this project
README
# 🧩 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
- [Visual Studio 2022+](https://visualstudio.microsoft.com/) with workloads:
- .NET Desktop Development
- [.NET 8 SDK](https://dotnet.microsoft.com/en-us/download/dotnet/8.0)
- [Git](https://git-scm.com/downloads)
---
## 📥 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.