KQ-389 · PARTICLE/FIGURE
Particle Figure
A 3D figure as points on its surface: thousands of particles that hold the shape, scatter from the cursor, swirl, and spring home. Floats and rocks, yours to orbit. The 3D runtime loads lazily after mount.
KQ-389 · PARTICLE/FIGURE
drag to orbit · move to scatter
Install
One command — the source lands in your repo. Or copy it from the Code tab.
$ pnpm dlx shadcn@latest add @kinetiq/particle-figure
Props
| Prop | Type | Default | Description |
|---|---|---|---|
| preset / src / scale | "knot" | "sphere" | "capsule" | "mark" · string · number | — | A built-in shape, or a GLB, glTF, SVG, or image URL sniffed by its bytes, and how large it sits. |
| orbit / idle | boolean | — | Drag to orbit, and the resting float and rock. |
| count / size / color | number · number · string | — | How many points sample the surface, their size, and their colour. |
| push / swirl / spring | number | — | How far the cursor scatters them, the swirl around it, and how fast they return. |