cruciverb/README.md

cruciverb

Crossword puzzles with a handwriting-first twist: daily grids in five difficulty presets, a community clue pool, and ActivityPub federation between instances.

Features

• Daily puzzles generated with seeds so every solver gets the same grid and clues
• Handwriting and stylus input recognized through ONNX and the browser handwriting api, with tesseract as a fallback
• Puzzle editor, clue trainer, multiplayer rooms, and party games
• Receipts and federation: instances follow each other and exchange clue submissions and puzzles

Layout

• cruciverb-core: the generator (grid construction, fill, exports)
• cruciverb-server: the axum api, sqlite storage, and activitypub plumbing
• cruciverb-cli: command line generation
• frontend: the vite and react client

Running it

cargo run -p cruciverb-server cd frontend && npm install && npm run dev

Point the client at the api on localhost:8080. Environment variables configure the instance domain, actor name, and data directory.