Wizdle
🔭 High Level
A library for solving Wordle. The Wizdle core library translates a request into a list of possible words.
Simple Flow:
---
config:
theme: redux-dark
look: handDrawn
layout: fixed
---
flowchart LR
CORRECT["Correct Letters"] --> REQUEST["Request"]
MISPLACED["Misplaced Letters"] --> REQUEST
EXCLUDE["Excluded Letters"] --> REQUEST
REQUEST --> ENGINE["Engine"]
ENGINE --> RESPONSE["Response"]
RESPONSE --> WORDS["Possible Words"]
Prerequisites
| Prerequisite | Note |
|---|---|
| .NET10 SDK | .NET10 or greater required. Check current .NET version dotnet --version. Download .NET10 from the official download page. |
| Docker | Download Docker from Docker Get Started. |
| PowerShell | PowerShell (pwsh) required. Check current version pwsh --version. Download PowerShell from PowerShell Releases. |
| Make | Required to run Makefile commands. Install via Chocolatey choco install make or Scoop scoop install make. |
Projects
| Project | Description |
|---|---|
| Wizdle | Core library and NuGet package — usage and examples in the Wizdle README |
| Wizdle.Api | Deployable REST API |
| Wizdle.Web | Blazor web app (.NET Aspire + Docker) |
| Wizdle.Console | CLI |
| Wizdle.Wpf | WPF desktop app (Windows) |
| Wizdle.Discord | Discord bot — invite |
🧪 Testing
| Type | Command |
|---|---|
| Unit & Integration | make test |
| Functional | make test-functional |
| All | make test-all |
| Performance | make perf |
| Mutation | make mutate |
⚙️ Make
Run make help to see all available commands.
Quick Start
make build # build solution
make test # run tests
make token # generate API key token
make build-all # build all Docker images
make compose # start all services
make logs # view logs
make stop # stop services
TL;DR for the TL;DR
Lyndon, did you just spend all this time working on a tool to cheat wordle… rather than actually just solving the word?!