Dot Cascade
2.5DThe orb holds still while each row of dots takes a full 360° turn, one after another from top to bottom, so a staggered wave rolls down the sphere.
dot-cascade.tsx
Installation
Install with the shadcn CLI, or copy the component file. It only needs React.
npx shadcn@latest add https://your-domain.com/r/dot-cascade.jsonUsage
Updates live with the parameters you set.
import { DotCascade } from "@/components/dot-cascade";
export function Thinking() {
return (
<DotCascade />
);
}Props
| Prop | Type | Default | Description |
|---|---|---|---|
| pattern | "rings" | "fibonacci" | "grid" | "rings" | How the dots are laid out on the sphere. |
| dotSize | number | 3 | Diameter of the front dots in px. Back dots scale down automatically. |
| density | number | 12 | Rows of dots. Higher means more dots. |
| size | number | 160 | Width and height of the orb in px. |
| duration | number | 1.4 | Seconds each row takes to complete its 360° turn. |
| stagger | number | 0.08 | Seconds between one row starting and the row below it. |
| gap | number | 0.6 | Seconds the orb rests after the bottom row finishes, before the next wave. |
| direction | "left" | "right" | "left" | Spin direction around the vertical axis. |
| tilt | number | 18 | Lean toward the viewer in degrees, so the top shows. |
| backOpacity | number | 0.2 | Opacity of the furthest dots. Front dots are always fully opaque. |
| color | string | "#e4e4e7" | Dot 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. |