Colored Nonogram

A standalone .NET 10 project for generating and playing colored nonogram puzzles from images.

Features

• Blazor WebAssembly PWA puzzle player
• Shared ColoredNonogram.Core logic for Web and CLI
• Browser image-to-puzzle generation with custom sizes up to 64x64
• CLI puzzle JSON generation from image files
• Deterministic small palette with up to 8 generated non-empty colors
• Puzzle JSON import/export
• Local browser progress saving
• xUnit v3 tests for Core and CLI behavior
• Docker/Nginx static hosting support

Quick Start

dotnet build ColoredNonogram.slnx
dotnet test ColoredNonogram.slnx
dotnet run --project src/ColoredNonogram.Web

CLI

dotnet run --project src/ColoredNonogram.Cli -- generate --input image.png --output puzzle.json --width 30 --height 40

Options include --max-colors, --resize-mode, --empty-threshold, --alpha-threshold, --stdout, and --force. The default empty threshold is conservative so pale subjects are not removed with the background.

Sample Media

The media/ folder contains sample files for the unicorn puzzle workflow:

• media/unicorn.png is the original source image used to generate the puzzle:

  

• media/unicorn.json is the generated puzzle JSON that can be imported in the Web player.

• media/screenshot.png shows the first steps of solving the generated puzzle:

  

Docker

docker build -f deploy/Dockerfile -t colored-nonogram .
docker run --rm -p 8080:80 colored-nonogram

Privacy

The Web app processes uploaded images locally in your browser. The default version does not upload images, puzzles, or progress to any server.