Wave Grid 3D

ProNew

An endless shader-driven surface of rolling waves drawn as grid lines, points or terrain, rippling out from the pointer.

Customize

This item has no props to tune. Use the lens above to change theme, density, direction and more.


pnpm dlx shadcn@latest add @tealmac-pro/wave-grid-3d

Prop	Type	Default	Description
`variant`	`"grid" \| "points" \| "terrain"`	`"grid"`	Anti-aliased grid lines, points, or a lit terrain.
`color`	`string`	theme	Trough colour. Defaults to `--primary`.
`accent`	`string`	theme	Crest colour. Defaults to `--chart-2`.
`amplitude`	`number`	`0.6`	Wave height.
`speed`	`number`	`1`	Wave speed multiplier.
`density`	`number`	`96`	Plane subdivisions, from 16 to 256.
`interactive`	`boolean`	`true`	Send ripples out from the pointer.
`children`	`ReactNode`	`-`	Content layered above the surface.
`label`	`string`	`-`	Accessible description. When set the scene is `role="img"`; otherwise it is decorative and `aria-hidden`.
`fallback`	`ReactNode`	gradient	Static frame shown while loading and when WebGL is unavailable.
`className`	`string`	`-`	Classes for the outer element.

three.js loads only when the component comes within 200px of the viewport, in its own chunk, so pages that do not show it never download it.
Rendering pauses while it is offscreen or the tab is hidden, and the pixel ratio is capped at 2.
With prefers-reduced-motion: reduce it renders a single still frame.
Without WebGL, or before the scene loads, a static gradient is shown instead.
Colours come from your theme's CSS variables and update when the theme changes.

Guide and examples


pnpm dlx shadcn@latest add @tealmac-pro/wave-grid-3d

Prop	Type	Default	Description
`variant`	`"grid" \| "points" \| "terrain"`	`"grid"`	Anti-aliased grid lines, points, or a lit terrain.
`color`	`string`	theme	Trough colour. Defaults to `--primary`.
`accent`	`string`	theme	Crest colour. Defaults to `--chart-2`.
`amplitude`	`number`	`0.6`	Wave height.
`speed`	`number`	`1`	Wave speed multiplier.
`density`	`number`	`96`	Plane subdivisions, from 16 to 256.
`interactive`	`boolean`	`true`	Send ripples out from the pointer.
`children`	`ReactNode`	`-`	Content layered above the surface.
`label`	`string`	`-`	Accessible description. When set the scene is `role="img"`; otherwise it is decorative and `aria-hidden`.
`fallback`	`ReactNode`	gradient	Static frame shown while loading and when WebGL is unavailable.
`className`	`string`	`-`	Classes for the outer element.

three.js loads only when the component comes within 200px of the viewport, in its own chunk, so pages that do not show it never download it.
Rendering pauses while it is offscreen or the tab is hidden, and the pixel ratio is capped at 2.
With prefers-reduced-motion: reduce it renders a single still frame.
Without WebGL, or before the scene loads, a static gradient is shown instead.
Colours come from your theme's CSS variables and update when the theme changes.