Skip to content

othonrm/web-sudoku

Repository files navigation

Web Sudoku

Overview

Web Sudoku is a web-based application for playing Sudoku. This project is designed to provide an interactive and user-friendly interface for solving Sudoku puzzles online.

Why?

  • Challenge myself
  • I like sudoku
  • The Sudoku app I have has very annoying ads every other number input or when generating a new board
  • An opportunity to learn about brute force, backtracking algorithms, recursive functions, and a lot more.
  • Get back into the "game" development world :D

Disclaimer

This project was created solely for learning and leisure purposes. As such, it does not adhere to best practices, coding guidelines, or performance optimizations. The focus was on experimenting with algorithms, rather than on code quality or efficiency improvements. Use (OR not) at your own discretion, as the project may contain inefficient or unconventional implementations.

AI

No AI-based autocompletion or chat conversation was used in the development of the algorithms implemented here.
Just my Google PhD 😂
Err -- actually, this README was made by Github Copilot through the repository web page chat.

Features

Top ones (TODO):

  • Mobile friendly
  • No ADS

  • Interactive Sudoku grid
  • Multiple difficulty levels
  • Timer to track your solving time
  • User-friendly interface

What was used

Getting Started

Prerequisites

  • a Web browser (Chrome, Firefox, Safari, etc.)
  • Node, NPM or Yarn
  • Maybe an IDE? (VS Code, WebStorm, NotePad++)

Installation

  1. Clone the repository:
    git clone https://github.com/othonrm/web-sudoku.git
  2. Navigate to the project directory:
    cd web-sudoku
  3. Install the dependencies
    yarn install
  4. Run the project
    yarn dev
  5. Preview in the browser, by navigating to http://localhost:5173

Preview

first-working-board

References

License

This project is open-source and available under the MIT License.