Particle Field 3D

ProNew

Thousands of GPU-animated particles arranged as a spiral galaxy, a vortex or a breathing sphere, coloured from your theme.

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/particle-field-3d

Prop	Type	Default	Description
`variant`	`"galaxy" \| "vortex" \| "sphere"`	`"galaxy"`	Shape of the field.
`count`	`number`	`9000`	Number of particles. Every particle is animated on the GPU.
`colors`	`[string, string]`	theme	Inner and outer colours. Defaults to `--primary` and `--chart-2`.
`size`	`number`	`1`	Particle size multiplier.
`speed`	`number`	`1`	Rotation speed multiplier.
`interactive`	`boolean`	`true`	Tilt toward the pointer.
`glow`	`boolean`	auto	Additive glow. On for dark backgrounds, off for light ones.
`children`	`ReactNode`	`-`	Content layered above the field.
`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/particle-field-3d

Prop	Type	Default	Description
`variant`	`"galaxy" \| "vortex" \| "sphere"`	`"galaxy"`	Shape of the field.
`count`	`number`	`9000`	Number of particles. Every particle is animated on the GPU.
`colors`	`[string, string]`	theme	Inner and outer colours. Defaults to `--primary` and `--chart-2`.
`size`	`number`	`1`	Particle size multiplier.
`speed`	`number`	`1`	Rotation speed multiplier.
`interactive`	`boolean`	`true`	Tilt toward the pointer.
`glow`	`boolean`	auto	Additive glow. On for dark backgrounds, off for light ones.
`children`	`ReactNode`	`-`	Content layered above the field.
`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.