# GameKit UI

> An open-source shadcn registry of minimal, themeable browser games — Snake, 2048, Minesweeper and more. Install with the shadcn CLI. Zero deps, zero assets.

GameKit UI is a shadcn registry. Each game is a single drop-in React/TSX file installed with the shadcn CLI. There is no provider, no peer dependency, and no init step — a game fills its container and inherits the host app's shadcn theme (light/dark and any preset). Games are zero-asset (drawn with CSS or <canvas>) and 2–4 KB each minified + gzipped (the raw source file is larger because it inlines its engine and theme hooks). Each game is a self-contained module, so it can be lazy-loaded (React.lazy / next/dynamic) and stays out of the initial bundle.

## Install a game

GameKit UI is listed in the official shadcn registry directory (https://ui.shadcn.com/docs/directory?q=gamekit), so install any game by short name — no setup needed, the CLI resolves the `@gamekitui` namespace automatically:

```bash
npx shadcn@latest add @gamekitui/snake
```

Replace `snake` with any game name. Optionally run `npx shadcn@latest registry add @gamekitui` to pin the registry in your `components.json`, or install by direct URL: `npx shadcn@latest add https://gamekitui.com/r/snake.json`.

## Docs

- [Introduction](https://gamekitui.com/docs): what GameKit UI is and how it works.
- [Installation](https://gamekitui.com/docs/installation): install, namespace setup, usage, and shared props.
- [llms-full.txt](https://gamekitui.com/llms-full.txt): full machine-readable reference with every game and usage example.

## Games

- [Snake](https://gamekitui.com/docs/games/snake): install with `npx shadcn@latest add @gamekitui/snake`
- [Tic-Tac-Toe](https://gamekitui.com/docs/games/tic-tac-toe): install with `npx shadcn@latest add @gamekitui/tic-tac-toe`
- [2048](https://gamekitui.com/docs/games/2048): install with `npx shadcn@latest add @gamekitui/2048`
- [Memory Match](https://gamekitui.com/docs/games/memory-match): install with `npx shadcn@latest add @gamekitui/memory-match`
- [Whack-a-Mole](https://gamekitui.com/docs/games/whack-a-mole): install with `npx shadcn@latest add @gamekitui/whack-a-mole`
- [Minesweeper](https://gamekitui.com/docs/games/minesweeper): install with `npx shadcn@latest add @gamekitui/minesweeper`
- [Pong](https://gamekitui.com/docs/games/pong): install with `npx shadcn@latest add @gamekitui/pong`
- [Breakout](https://gamekitui.com/docs/games/breakout): install with `npx shadcn@latest add @gamekitui/breakout`
- [Dino Runner](https://gamekitui.com/docs/games/dino-runner): install with `npx shadcn@latest add @gamekitui/dino-runner`
- [Flappy](https://gamekitui.com/docs/games/flappy): install with `npx shadcn@latest add @gamekitui/flappy`
- [Fruit Ninja](https://gamekitui.com/docs/games/fruit-ninja): install with `npx shadcn@latest add @gamekitui/fruit-ninja`