oxyn

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.json

Usage

Updates live with the parameters you set.

import { NoiseRipple } from "@/components/noise-ripple";

export function Thinking() {
  return (
    <NoiseRipple />
  );
}

Props

PropTypeDefaultDescription
linesnumber4Number of concentric rings.
lineSpacingnumber3Gap between neighboring rings in px. Keep it low so the rings sit close together.
lineWidthnumber1Stroke width of each ring in px.
amplitudenumber8Strength of the noise: how far the outer ring is pushed in or out, in px. Inner rings move proportionally less.
frequencynumber0.8How many bumps run around a ring. Low values give broad, soft swells; high values give tighter ripples.
speednumber0.35How fast the noise drifts over time.
durationnumber3.2Seconds for one push to travel from the innermost ring out through the outer one.
spreadnumber0.12How differently neighboring rings move. 0 keeps them in lockstep; higher lets each ring wander on its own.
sizenumber160Width and height of the orb in px.
minOpacitynumber0.35Opacity of the innermost ring. The outer ring is always fully opaque.
colorstring"#e4e4e7"Line color.
pausedbooleanfalseCoast to a stop on the current frame without unmounting. Turning it off eases back up to speed.
labelstring"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.

More states