Skip to content
This repository has been archived by the owner on Feb 8, 2025. It is now read-only.

tmchuynh/sudoku

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

23 Commits
 
 
 
 
 
 
 
 

Repository files navigation

Sudoku Game

About the Project

This Sudoku game is an interactive web-based puzzle that allows players to solve Sudoku grids at different difficulty levels. Players can select preset difficulty options—Easy, Medium, or Hard—which determine the number of prefilled cells. Additionally, users can manually customize their challenge by choosing the number of cells removed from the grid. The game is designed to be intuitive, responsive, and engaging for both beginners and experienced Sudoku enthusiasts.


How to Play

Objective

The goal of Sudoku is to fill a 9x9 grid with numbers 1-9, ensuring that:

  • Each row contains every number from 1-9 exactly once.
  • Each column contains every number from 1-9 exactly once.
  • Each 3x3 subgrid contains every number from 1-9 exactly once.

Game Setup

  1. Select Difficulty: Click on Easy, Medium, or Hard to generate a prefilled Sudoku grid with a varying number of missing cells.
  2. Custom Challenge: Alternatively, use the custom difficulty option to select how many cells should be removed for a personalized challenge.
  3. Start Solving: Click on any empty cell and input a number between 1-9 to begin solving the puzzle.

Game Rules

  • A number cannot be repeated in the same row, column, or 3x3 section.
  • If you enter an incorrect number, you can erase it and try again.
  • The puzzle is completed when all cells are filled correctly.

Features

Preset Difficulty Levels – Choose from Easy, Medium, or Hard modes for automatic Sudoku generation.
Custom Challenge Mode – Manually set the number of empty cells for a personalized experience.
Interactive Grid – Click on empty cells to input numbers and solve the puzzle dynamically.
Error Checking – Ensure that numbers follow Sudoku rules with visual hints and validations.
Responsive Design – Play seamlessly on desktops, tablets, and mobile devices.
Intuitive UI – Clean layout and easy-to-use controls for smooth gameplay.


Technologies Used

  • HTML – Structure and layout of the Sudoku grid
  • CSS – Styling for a clean and responsive user interface
  • JavaScript – Core game logic, difficulty selection, and error validation

Installation & Running the Game

To play locally, follow these steps:

1. Clone the Repository

git clone https://github.com/your-username/sudoku-game.git
cd sudoku-game

2. Open the Game

Simply open the index.html file in your preferred browser.


Future Enhancements

🚀 Hint System – Add optional hints to assist players when stuck.
🚀 Timer & Score Tracking – Implement a timer and leaderboard for competitive play.
🚀 Dark Mode – Introduce a dark theme for comfortable gameplay at night.


License

This project is open-source and available under the MIT License. Feel free to contribute, modify, and improve!

Made with ❤️ by Your Name


🔗 Back to Top

Back to Top 🚀

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published