cozy-games/README.md

Cozy Games

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

Note

This repo was originally for mnswpr (see its README) which has been evolved in 2026 to understand AI-assisted development. The purpose of mnswpr has always included understanding the web development landscape and this has changed significantly with the rise of LLMs.

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.

Packages

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.

Contributing

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.

License

BSD-2-Clause © Ayo Ayco