Orbit Rings 3D

ProNew

A glowing nucleus with electrons racing around tilted orbits and leaving fading trails.

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/orbit-rings-3d

Prop	Type	Default	Description
`rings`	`number`	`3`	Number of tilted orbits, from 1 to 8.
`electrons`	`number`	`1`	Electrons per orbit.
`colors`	`string[]`	theme	Orbit colours used in turn. Defaults to `--chart-2`, `--chart-3` and `--chart-5`.
`nucleusColor`	`string`	theme	Nucleus colour. Defaults to `--primary`.
`speed`	`number`	`1`	Orbit speed multiplier.
`glow`	`boolean`	`true`	Additive glow around the nucleus and electrons.
`interactive`	`boolean`	`true`	Tilt toward the pointer.
`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/orbit-rings-3d

Prop	Type	Default	Description
`rings`	`number`	`3`	Number of tilted orbits, from 1 to 8.
`electrons`	`number`	`1`	Electrons per orbit.
`colors`	`string[]`	theme	Orbit colours used in turn. Defaults to `--chart-2`, `--chart-3` and `--chart-5`.
`nucleusColor`	`string`	theme	Nucleus colour. Defaults to `--primary`.
`speed`	`number`	`1`	Orbit speed multiplier.
`glow`	`boolean`	`true`	Additive glow around the nucleus and electrons.
`interactive`	`boolean`	`true`	Tilt toward the pointer.
`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.