cozy-games/README.md
2026-07-04 10:35:55 +02:00

42 lines
1.5 KiB
Markdown

# Cozy Games
A growing collection of small browser games and the shared, reusable packages that power them.
# 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 | State |
| -------------------- | -------------------- |
| `mnswpr` (game core) | 🚧 Active development |
| leaderboard | ✅ Done (unpublished) |
| move-log envelope | 🔮 Planned |
| replay engine | 🔮 Planned |
| rating math | 🔮 Planned |
| `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](CONTRIBUTING.md)**. In short — this is a
[pnpm](https://pnpm.io) workspace:
```bash
pnpm i # install
pnpm test # run the test suite
pnpm -F mnswpr run dev # run the Minesweeper app locally
```
See [apps/mnswpr/README.md](apps/mnswpr/README.md) for the game itself, and each
package's README for library usage.
## License
BSD-2-Clause © Ayo Ayco