Noise Ripple: a loader for responding
Noise rings with a push travelling outward like a drop in water. A React loader for an AI agent responding. Install with shadcn.
Installation
Install with the shadcn CLI, or copy the component file. It only needs React.
npx shadcn@latest add https://oxyn.space/r/noise-ripple.jsonUsage
Updates live with the parameters you set.
import { NoiseRipple } from "@/components/noise-ripple";
export function Thinking() {
return (
<NoiseRipple />
);
}Props
| Prop | Type | Default | Description |
|---|---|---|---|
| lines | number | 4 | Number of concentric rings. |
| lineSpacing | number | 3 | Gap between neighboring rings in px. Keep it low so the rings sit close together. |
| lineWidth | number | 1 | Stroke width of each ring in px. |
| amplitude | number | 8 | Strength of the noise: how far the outer ring is pushed in or out, in px. Inner rings move proportionally less. |
| frequency | number | 0.8 | How many bumps run around a ring. Low values give broad, soft swells; high values give tighter ripples. |
| speed | number | 0.35 | How fast the noise drifts over time. |
| duration | number | 3.2 | Seconds for one push to travel from the innermost ring out through the outer one. |
| spread | number | 0.12 | How differently neighboring rings move. 0 keeps them in lockstep; higher lets each ring wander on its own. |
| size | number | 160 | Width and height of the orb in px. |
| minOpacity | number | 0.35 | Opacity of the innermost ring. The outer ring is always fully opaque. |
| color | string | "#e4e4e7" | Line color. |
| paused | boolean | false | Coast to a stop on the current frame without unmounting. Turning it off eases back up to speed. |
| label | string | "Thinking" | Accessible name; the wrapper is role="status". |
| className / style | — | — | Spread onto the wrapper div, along with any other div props. |
Switch states
Noise Ripple is one of the animations in Noise Rings. Use the group when the agent's state changes, and it morphs between them.