# three-kit

> Dev tools and helpers for three.js, published separately under `@zkmake/*`: a live FPS, CPU and GPU HUD, texture and camera inspectors, scene checks for tests and CI, and draw-call batching. Each works with vanilla three and React Three Fiber, WebGL and WebGPU.

Each package installs on its own. All but three-batch are dev tools (install with `-D`); three-batch ships with the app. Entry points: the core at `@zkmake/<name>`, a DOM panel at `/ui` and React Three Fiber components at `/react`, where a package has them.

## Packages

- [@zkmake/three-meter](https://zkmake.github.io/three-kit/three-meter/README.md): See what every frame costs. FPS, CPU and GPU time, stutter, draw calls and triangles, live in a HUD you dock anywhere. Budgets flag what's over. WebGL and WebGPU.
- [@zkmake/three-textures](https://zkmake.github.io/three-kit/three-textures/README.md): Edit textures in the running scene. Download any texture the scene draws with, paint over it, drop it back in and see it lit, with no rebuild. A/B against the original, live-link a file. KTX2 too.
- [@zkmake/three-cameras](https://zkmake.github.io/three-kit/three-cameras/README.md): See every camera, and which are drawing. Lists the scene's cameras and the one the renderer draws with, marks the live ones with their frame rate, reads position and projection live, and draws frustums.
- [@zkmake/three-audit](https://zkmake.github.io/three-kit/three-audit/README.md): Catch broken geometry before it ships. Find z-fighting, NaN normals, black frames and triangle or draw-call blowups. Assert on them in unit tests, run them in the console, or check glTF files in CI.
- [@zkmake/three-batch](https://zkmake.github.io/three-kit/three-batch/README.md): Draw less, render faster. Cut draw calls and triangles: culling cells for world-spanning meshes, static bakes, batches that follow moving objects, instance pools, far copies. Ships with the app, not a dev tool.

## Optional

- [Every README in one file](https://zkmake.github.io/three-kit/llms-full.txt)
- [three-meter demo](https://zkmake.github.io/three-kit/three-meter/): the package running live
- [three-textures demo](https://zkmake.github.io/three-kit/three-textures/): the package running live
- [three-cameras demo](https://zkmake.github.io/three-kit/three-cameras/): the package running live
- [Source](https://github.com/zkmake/three-kit): monorepo, with each package's CHANGELOG.md under packages/<name>/