Physics Balls Backdrop

ProNew

Soft translucent balls that tumble and bounce off each other and the edges while gravity slowly turns around the page.

The full demo as documented.

Customize

Controls declared by this item. Changes drive the preview live.

speed1


pnpm dlx shadcn@latest add @tealmac-pro/backdrop-physics-balls

Prop	Type	Default	Description
`colors`	`string[]`	`chart-1, chart-2, chart-3`	CSS colors drawn from in order. Any CSS color or `var()`.
`speed`	`number`	`1`	Playback speed multiplier.
`density`	`number`	`1`	How many elements to draw. Higher is busier.

Also accepts all <div> props except children.

Decorative: the wrapper is aria-hidden and pointer-events-none, so it never takes focus or blocks clicks.
Under prefers-reduced-motion: reduce it draws one still frame and does not animate.

A real, small simulation: circles bounce off the walls and push each other apart. Gravity rotates slowly, so the pile keeps moving.
Fills its nearest positioned parent (absolute inset-0). Put page content above it with relative isolate on the parent and -z-10 on the backdrop.
Draws with the 2D canvas only (no WebGL, no extra packages), caps the pixel ratio, and stops its loop while off-screen or in a hidden tab.

Guide and examples


pnpm dlx shadcn@latest add @tealmac-pro/backdrop-physics-balls

Prop	Type	Default	Description
`colors`	`string[]`	`chart-1, chart-2, chart-3`	CSS colors drawn from in order. Any CSS color or `var()`.
`speed`	`number`	`1`	Playback speed multiplier.
`density`	`number`	`1`	How many elements to draw. Higher is busier.

Also accepts all <div> props except children.

Decorative: the wrapper is aria-hidden and pointer-events-none, so it never takes focus or blocks clicks.
Under prefers-reduced-motion: reduce it draws one still frame and does not animate.

A real, small simulation: circles bounce off the walls and push each other apart. Gravity rotates slowly, so the pile keeps moving.
Fills its nearest positioned parent (absolute inset-0). Put page content above it with relative isolate on the parent and -z-10 on the backdrop.
Draws with the 2D canvas only (no WebGL, no extra packages), caps the pixel ratio, and stops its loop while off-screen or in a hidden tab.