Skip to content

weiawesome/SudokuLab

Repository files navigation

SudokuLab

SudokuLab Logo

Solve Sudoku using human logic techniques, with clear explanations for every step


Why This Repo Exists

Mainly, two years ago when I was in the military, I spent a lot of time solving Sudoku puzzles to pass the time.

I have to say, I learned a lot of Sudoku techniques. Especially since I kept the entire process in my head (like memory, haha), unlike others who would write the process on paper (like a hard drive, haha).

A while ago, I felt a bit bored and wanted to exercise my brain (keep my mind active), so I bought this book (the most difficult level in the series).

Sudoku - King Level

No joke, some of them are really difficult to solve, and I really suspect that some might be made up (meaning the solution isn't based on logic at all, but just forced).

You can refer to my previous repo where I encountered puzzles with multiple solutions sudoku_resolver

So now I thought, why not create a tool that can generate puzzles, practice, or step-by-step solve Sudoku puzzles.

Screenshots

Home Page (can select puzzle difficulty or generate new puzzle)

Puzzle (can manually enter numbers or use generator to create new puzzle)

Candidate Numbers (can toggle visibility of candidate numbers)

Solution (can step-by-step solve Sudoku)

Practice (can practice Sudoku)

Tech Stack

  • React
  • TypeScript
  • Vite
  • Intlayer
  • GitHub Pages
Note: 
  Intlayer is a useful i18n tool that makes it very convenient to add multi-language support 
  I recently received an invitation from the framework developer to use it, so I used it for this project

I also wrote about the advantages of this framework based on my current experience Intlayer Usage Notes. If you think it's good, you can also join the framework community.

Features

Human Logic Solving

Unlike brute force algorithms, SudokuLab uses solving techniques that humans actually use, helping you learn real Sudoku logic.

Uses nine core solving algorithms. For details, see Solving Techniques

Step-by-Step Explanations

Every step clearly explains what technique was used and why it was filled in that way, helping you understand the solving approach.

Practice Mode

After solving, you can enter Play Mode to practice yourself, with Undo/Redo support.

Multi-language Support

  • Traditional Chinese
  • Simplified Chinese
  • English
  • Japanese
  • Korean

Quick Start

Install Dependencies

npm install

Development Mode

npm run dev

Build

npm run build

Preview Build

npm run preview

Contributing

If you have any ideas or suggestions, feel free to open an issue or pull request.

About

Sudoku solver built with React and TypeScript that uses human-style logical techniques instead of brute force. Provides step-by-step explanations, candidate visualization, puzzle generator, practice mode, and multilingual support.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors