{"id":25074936,"url":"https://github.com/nathancordeiro/sudoku-ninja","last_synced_at":"2026-07-01T12:31:08.884Z","repository":{"id":243551176,"uuid":"812737562","full_name":"NathanCordeiro/SUDOKU-NINJA","owner":"NathanCordeiro","description":"This project SUDOKU-NINJA is a command-line, optimized Sudoku solver and puzzle generator for the conventional 9x9 puzzles, developed in C++. It offers an engaging way for players to solve Sudoku puzzles directly from their terminal or command prompt.","archived":false,"fork":false,"pushed_at":"2024-06-09T20:13:34.000Z","size":206,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-11-02T14:13:04.516Z","etag":null,"topics":["cpp","sudoku","terminal-game"],"latest_commit_sha":null,"homepage":"","language":"C++","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/NathanCordeiro.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-06-09T18:28:32.000Z","updated_at":"2025-01-26T19:10:30.000Z","dependencies_parsed_at":"2024-06-09T20:08:42.882Z","dependency_job_id":"957bc5fa-f8db-4902-8db7-a67ed36cce13","html_url":"https://github.com/NathanCordeiro/SUDOKU-NINJA","commit_stats":null,"previous_names":["nathancordeiro/sudoku-ninja"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/NathanCordeiro/SUDOKU-NINJA","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NathanCordeiro%2FSUDOKU-NINJA","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NathanCordeiro%2FSUDOKU-NINJA/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NathanCordeiro%2FSUDOKU-NINJA/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NathanCordeiro%2FSUDOKU-NINJA/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/NathanCordeiro","download_url":"https://codeload.github.com/NathanCordeiro/SUDOKU-NINJA/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NathanCordeiro%2FSUDOKU-NINJA/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":35007274,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-07-01T02:00:05.325Z","response_time":130,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cpp","sudoku","terminal-game"],"created_at":"2025-02-07T00:19:42.640Z","updated_at":"2026-07-01T12:31:08.852Z","avatar_url":"https://github.com/NathanCordeiro.png","language":"C++","funding_links":[],"categories":[],"sub_categories":[],"readme":"# SUDOKU-NINJA🥷\n\n## Overview\nThis project, SUDOKU-NINJA, is a command-line application that combines an optimized Sudoku solver with a puzzle generator for conventional 9x9 puzzles, developed in C++🎮. It provides an engaging and interactive way for users to solve or play Sudoku puzzles directly from their terminal or command prompt. The game features several preset puzzles and a robust backtracking algorithm that demonstrates the solution process, making it perfect for both enthusiasts and learners🧩.\n\n## What is Sudoku? For those living under a rock.\nSudoku is a popular logic-based number puzzle. The objective is to fill a 9x9 grid with numbers from 1 to 9, following these rules:\n\n- Each row must contain all numbers from 1 to 9 without repetition.\n- Each column must also contain all numbers from 1 to 9 without repetition.\n- Each of the nine 3x3 sub-grids, called boxes, must contain all numbers from 1 to 9 without repetition.\n\nThe puzzle starts with some cells already filled with numbers, and the player must fill in the remaining cells. Sudoku puzzles range in difficulty from easy to extremely challenging.\n\n## Features\nUpon starting the game, you will be presented with the following menu options:\n\n| Option                | Description                                                   |\n|-----------------------|---------------------------------------------------------------|\n| **New Puzzle**        | Load the next preset puzzle.                                  |\n| **Reset puzzle**      | Reset the puzzle to its initial state.                        |\n| **Solve Puzzle**      | Solve the current puzzle using the backtracking algorithm.    |\n| **Enter Numbers**     | Manually enter numbers into the puzzle grid.                  |\n| **Quit**              | Quit or exit the game.                                        |\n\n## Screenshot📸\n\u003ctable\u003e\n  \u003ctr\u003e\n    \u003ctd\u003e\u003cimg src=\"./Images/sudoku.png\" alt=\"Screenshot\" width=\"350\" /\u003e\u003c/td\u003e\n  \u003c/tr\u003e\n\u003c/table\u003e\n\n## Prerequisites✅\n- A C++ compiler🖥️\n- Command-line interface💻\n\n## Compilation\nTo compile the project, follow these steps:\n\n1. Clone the repository:\n   ```sh\n   git clone https://github.com/NathanCordeiro/SUDOKU-NINJA.git\n   ```\n2. Navigate to the directory containing the project files using the `cd` command.\n   ```bash\n   cd SUDOKU-NINJA/Sudoku\n   ```\n3. Compile the project using the following command:\n   ```bash\n   g++ -o Sudoku main.cpp manager.cpp solver.cpp\n   ```\n  This will generate an executable file named Sudoku.exe on Windows or Sudoku on Unix-based systems.\n\n## Running the Game\nAfter compilation, you can run the game by executing the compiled file:\n#### On Windows:\n```bash\nSudoku.exe\n```\n`OR`\n\n```bash\nSudoku\n```\n\n#### On Unix-based systems (Linux/macOS):\n```bash\n./Sudoku\n```\n## File Structure\n| File                  | Description                                                   |\n|-----------------------|---------------------------------------------------------------|\n| **main.cpp**          | Contains the main function and the primary game loop.         |\n| **manager.cpp**       | Implements functions for handling the game menu, loading, resetting puzzles, and entering numbers. |\n| **manager.h**         | Header file declaring the functions used in `manager.cpp`.    |\n| **solver.cpp**        | Implements the Sudoku solving algorithm.                      |\n| **solver.h**          | Header file declaring the functions used in `solver.cpp`.     |\n| **txt_styling.h**     | Contains ANSI escape codes for text styling.                  |\n\n\u003c/br\u003e\n\n```\n SUDOKU-NINJA/\n │\n ├── Images/\n │   └── sudoku.png\n │\n ├── Sudoku/\n │   ├── main.cpp\n │   ├── manager.cpp\n │   ├── manager.h\n │   ├── solver.cpp\n │   ├── solver.h\n │   ├── txt_styling.h\n │   └── Sudoku.exe (generated after compilation)\n │\n ├── LICENSE\n ├── README.md\n └── .gitignore\n```\n\n## Customization\nYou can customize the preset puzzles in manager.cpp by modifying the presetPuzzles vector.\n\nTo change the default colors, update the color variables in the code directly🎨.\n\n## Contribution\nContributions are welcome! Please fork the repository and create a pull request with your changes🚀. \n\n## Contact\nFor questions or support, please contact me at nathanjohncordeiro@gmail.com📧.\n\n## License\n[![Licence](https://img.shields.io/github/license/Ileriayo/markdown-badges?style=for-the-badge)](./LICENSE)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnathancordeiro%2Fsudoku-ninja","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnathancordeiro%2Fsudoku-ninja","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnathancordeiro%2Fsudoku-ninja/lists"}