Cozy Games

A growing collection of small browser games and the shared, reusable packages that power them.

Note

This is forked from mnswpr with the intention of learning agent-assisted development

Roadmap

Public APIs — game-agnostic modules (core, move-log, replay, leaderboard, rating) built inside the first game.
Second Game — validate those APIs by adding a second game through the adapter alone.
Reusable Packages — extract proven modules into standalone, versioned packages.
Adapters — freeze the adapter contract for third-party games to build against.

Package	Develop	Publish	Document
`mnswpr` (game core)	✅ Built
leaderboard	✅ Built
move-log	✅ Built
replay engine	✅ Built
rating math	🚧 Development
`sudoku` (game core)	🔮 Planned

Note: @ayo-run/mnswpr on npm predates this project and will be deprecated in favor of cozy-games/mnswpr.

Setup, running games locally, testing, code style, and local infra all live in CONTRIBUTING.md. In short — this is a pnpm workspace:

pnpm i                     # install
pnpm test                  # run the test suite
pnpm -F mnswpr run dev     # run the Minesweeper app locally

See apps/mnswpr/README.md for the game itself, and each package's README for library usage.