Thanks for your interest in contributing!
- Node.js: 18+
- Browser: WebGPU-capable (Chrome/Edge 113+, Safari 18+). Firefox WebGPU is still in development.
Install dependencies:
npm install
- Dev server (examples):
npm run dev- Opens the examples at
http://localhost:5176/examples/
- Opens the examples at
- Build (library):
npm run build
- Bugs / performance regressions: please include a minimal reproduction (an
examples/change is ideal). - New features: open an issue first so we can align on API and behavior.
- Keep PRs focused: one feature/fix per PR when possible.
- Add/adjust examples when behavior changes: update or add an example under
examples/to demonstrate new behavior. - Docs updates: if you change public behavior or API, update
docs/and the README links as needed.
- TypeScript: keep types strict and public contracts explicit.
- WebGPU correctness: prefer clear validation over silent fallbacks; follow alignment rules for buffer writes.
When filing an issue, include:
- Browser + version
- OS + GPU (if known)
- Steps to reproduce (or a small
examples/PR) - Console errors / screenshots when relevant