Holographic Liquid Orb

<HolographicLiquidOrb>CSS Modules

Iridescent oil-film sphere with cursor-reactive refraction.

InstallationColoxo CLI

npx coloxo add holographic-liquid-orb

ES Module ImportPlayground / npm package

import { HolographicLiquidOrb } from '@coloxo/ui/visuals';

1. Live preview

This is the real component, not a recording. Move the pointer over it, then adjust the renderer settings.

Fragment shader

<HolographicLiquidOrb quality="low" />

2. Usage

Iridescent oil-film sphere with cursor-reactive refraction. npx coloxo add holographic-liquid-orb copies this effect in a Tailwind project or a Coloxo CSS project, and adds @coloxo/ui to package.json. You can also import it from @coloxo/ui/visuals.

3. Performance notes

Effects render on demand and dispose their GPU context when unmounted.

Every effect pauses when scrolled out of view or when the tab is hidden, so an idle page costs nothing.
quality caps the device pixel ratio. Keep it at low when several effects share one viewport.
With respectReducedMotion enabled, the effect renders a single static frame instead of animating.
The output is a decorative canvas hidden from assistive technology. Never place essential content only inside the effect.

4. Props

Name	Type	Default	Description
colorScheme	OrbColorScheme	`iridescent`	Base palette family.
iridescence	number	0.85	Strength of the oil-film colour shift, 0–1.
distortion	number	0.4	Surface wobble from the liquid simulation, 0–1.
rotationSpeed	number	0.35	Idle spin in radians per second, 0–3.
interactionStrength	number	0.6	How strongly the cursor displaces the surface, 0–1.
scale	number	0.78	Orb radius as a fraction of the container's shorter side, 0.2–0.95.
paused	boolean	false	Render a single static frame instead of animating.
respectReducedMotion	boolean	true	Freeze to a static frame when prefers-reduced-motion is set.
quality	"low" \| "medium" \| "high"	medium	Caps the renderer pixel ratio. Use low for grids of many effects.
className / style	string / CSSProperties	—	Applied to the container element.