# Cat Painter

> Cat Painter is a free, single-player 3D sliding puzzle game that runs in a modern web browser. Players slide a kitten across slate tiles, painting every tile they cross before the available action points run out.

## Game Facts

- The game contains 1000 independently verified puzzle levels.
- Every valid move continues in a straight line until the next tile would be a wall.
- A valid move costs one action point; a blocked direction costs nothing.
- A level is complete after every slate tile has been painted.
- The 1000 levels span 20 difficulty tiers.
- Every committed level has an exact shortest solution verified by breadth-first search.
- Level action budgets include a controlled margin above the verified shortest solution.
- Progress, completed levels, and per-level best times are stored locally in the browser.

## Controls and Accessibility

- Keyboard controls: arrow keys or W, A, S, and D.
- Pointer controls: on-screen direction buttons, orbit, pan, and zoom.
- Touch controls: direction buttons, one-finger rotation, and two-finger pan and zoom.
- The interface supports English, Simplified Chinese, and Japanese.
- The game responds to reduced-motion and reduced-transparency preferences.

## Technology

- React 19 and TypeScript.
- Three.js and React Three Fiber for the persistent 3D scene.
- Vite for development and production builds.
- A committed PBR GLB kitten with procedural four-leg skeletal animation.
- Vitest and Playwright verification across desktop and mobile viewports.

## Access

- No account, installation, payment, or model-generation API is required to play.
- JavaScript and WebGL are required.
- The canonical game page is the site root.
- Crawler permissions are published at `/robots.txt`.

## Primary Entity

Cat Painter is best described as a free browser puzzle game, a 3D sliding puzzle, a cat puzzle game, and a paint-coverage puzzle.