OPUS/UI

Navigation

Liquid Marble

Inigo-Quilez-style triple domain warp f(p + f(p + f(p))) coloured from four inks. The pointer stirs a vortex into the flow, faster when you move faster.

webglpointerfbmdomain-warp6 files · 619 locdeps: clsx, tailwind-merge

Installation

With the shadcn CLI, pointing at this platform’s registry:

npx shadcn@latest add https://opusui.131199999.xyz/r/liquid-marble.json

Or offline, straight from your opus55 checkout (copies every file it needs):

node ../tailwind_component/opus55/scripts/add.mjs liquid-marble

Usage

import { LiquidMarble } from "@/components/opus/backgrounds/liquid-marble";

<LiquidMarble className="absolute inset-0" />

API

PropTypeDefaultDescription
colors[string, string, string, string]—Base, ink, vein, highlight.
scalenumber1Pattern zoom.
contrastnumber1Vein contrast.
speednumber1Time multiplier. 0 freezes the animation; the pointer stays live.
interactivebooleantrueReact to the pointer (tracked on window, so overlaid content never blocks it).
classNamestring—Classes for the wrapper. Use `absolute inset-0` to fill a relative parent.
childrenReactNode—Optional content rendered above the canvas.

Notes

  • Renders with WebGL2 into a single full-screen triangle — no three.js, no textures, no dependencies.
  • Pauses automatically when scrolled off-screen or when the tab is hidden; resumes on return.
  • prefers-reduced-motion: reduce renders one still frame and ignores the pointer.
  • A CSS gradient fallback paints instantly and stays if WebGL2 is unavailable.
  • Renders at 75% resolution (resolution={0.75}) — 20 noise evaluations per pixel.

Command palette