Liquid Metal Morph

<LiquidMetalMorph>CSS Modules

Chrome surface morphing between geometric forms.

InstallationColoxo CLI
npx coloxo add liquid-metal-morph
ES Module ImportPlayground / npm package
import { LiquidMetalMorph } 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
<LiquidMetalMorph quality="low" />

2. Usage

Chrome surface morphing between geometric forms. npx coloxo add liquid-metal-morph 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

NameTypeDefaultDescription
shapeMetalShape`torus`Target form.
morphSpeednumber0.6How far the morph has progressed toward `shape`, 0–1.
metalnessnumber0.9Specular reflectivity, 0–1.
roughnessnumber0.15Scatter of the reflection, 0–1.
cursorInfluencenumber0.5Pointer pull on the silhouette, 0–1.
reflectionIntensitynumber1Brightness of the environment reflection, 0–1.5.
pausedbooleanfalseRender a single static frame instead of animating.
respectReducedMotionbooleantrueFreeze to a static frame when prefers-reduced-motion is set.
quality"low" | "medium" | "high"mediumCaps the renderer pixel ratio. Use low for grids of many effects.
className / stylestring / CSSProperties—Applied to the container element.