# sudodle

**Repository Path**: mirrors_Zulko/sudodle

## Basic Information

- **Project Name**: sudodle
- **Description**: The Wordle of Sudoku
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-06-08
- **Last Updated**: 2026-02-15

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Sudodle

In Sudodle, the player must find a square where each digit appears once on each row and column, given some well-placed values (in green) and incorrectly-placed values (in yellow).

<img src="sudodle_screenshot.png" alt="Sudodle screenshot">

## Repository Structure

This project is organized into two folders:

- **`puzzle_generation/`** - Scripts to study and generate puzzles.
  - Optimized Rust scripts to mine new puzzles reasonably fast (particularly useful for Sudodles of size 7 and above)
  - Python scripts and notebooks t analyze the game, attribute difficulty levels to puzzles, plot puzzles into the [puzzle book](./study/sudodles_puzzle_book.pdf)
- **`sudodle/`** - The web application [sudodle.app](https://sudodle.app), with thousands of puzzles and a multi-turn game mode

## Running the web app for development

Run the web applocally with 

```bash
npm install
npm run dev
```

The project is deployed on GitHub Pages from the `main` branch.