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
- preset / src / scale
- "knot" | "sphere" | "capsule" | "mark" · string · number
- default —
- A built-in shape, or a GLB, glTF, SVG, or image URL sniffed by its bytes, and how large it sits.
- orbit / idle
- boolean
- default —
- Drag to orbit, and the resting float and rock.
- count / size / color
- number · number · string
- default —
- How many points sample the surface, their size, and their colour.
- push / swirl / spring
- number
- default —
- How far the cursor scatters them, the swirl around it, and how fast they return.
| 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. |