45 lines
1.7 KiB
Markdown
45 lines
1.7 KiB
Markdown
# Cozy Games
|
|
|
|
A growing collection of small browser games and the shared, reusable packages that power them.
|
|
|
|
> [!Note]
|
|
> This is forked from [mnswpr](https://github.com/ayo-run/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.
|
|
|
|
## 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](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
|