# vshaders

> vshaders is a registry of composable WGSL shader effects built on vgpu. Pure WGSL modules ship as npm packages under @vshaders/*; complete effects are copied into consumer projects and owned there. All five packages are on npm at 0.2.0: @vshaders/sdf, @vshaders/color, @vshaders/dither, @vshaders/ease and @vshaders/fluid. Eleven effects render live with editors at /effects/<slug>: mesh gradient, metaballs, palette field, flow, ripple, dither, fluid (a real multi-pass simulation), displacement, god rays, heatmap, and undertones.

## Registry

Effects are served as shadcn-compatible registry items: index at /r/registry.json, eleven installable items at /r/mesh-gradient.json, /r/metaballs.json, /r/palette-field.json, /r/flow.json, /r/ripple.json, /r/dither.json, /r/fluid.json, /r/displacement.json, /r/god-rays.json, /r/heatmap.json, /r/undertones.json. Install with `npx shadcn@latest add https://vshaders.com/r/mesh-gradient.json`; this works today, dependencies included. Each item's `docs` field carries its install notes (texture inputs, color spaces, the WGSL loader prerequisite); the same notes render on the effect's page under Install, and /docs/effects covers the shared patterns.

## Links

- [Docs](/docs): setup, adding effects, and API references for every package
- [Agents](/agents.md): status and capabilities for AI agents
- [Design guidelines](/design.md): the visual system for vshaders surfaces
- [Why vshaders](/compare): how vshaders relates to component effect libraries
- [vgpu](https://vgpu.sh): the WebGPU library vshaders builds on