Skip to content

    Browse components

    Matrix Orb

    A liquid metaball orb for voice or AI status: it breathes when idle, ripples when listening and churns off droplets when thinking.

    Credit: Calamansi UI (MIT)

    Open
    Customize
    calamansi
    white
    slate
    citrus

    Installation

    npx shadcn@latest add @glint-ui/matrix-orb

    First time using @glint-ui? Add the registry to components.json once, or install by URL: npx shadcn@latest add https://glintui.vercel.app/r/matrix-orb.json

    Usage

    import { MatrixOrb } from "@/components/ui/matrix-orb";
    
    <MatrixOrb state="listening" variant="calamansi" size={200} />

    Props

    PropTypeDefaultDescription
    variant"calamansi" | "white" | "slate" | "citrus""calamansi"Body ink.
    sizenumber240Stage width and height, in px.
    lobesnumber5Satellites around the core. More means a busier body.
    gooeybooleantrueRun the metaball fuse. Off, the circles just overlap.
    thresholdnumber19Alpha ramp slope: how hard the fused edge is.
    captionbooleantrueShow the state caption under the orb.
    colorstring—Body colour, overriding the variant ink.
    state"idle" | "listening" | "thinking""idle"What the orb is doing. The demo cycles it.
    levelnumber—Drive the amplitude yourself (e.g. an audio level), 0-1.
    labelsReactNode—Caption per state, e.g. `{ thinking: "Working" }`.
    viscositynumber—Fuse blur in px. Defaults to 0.078 of the size.
    wavinessnumber—Max px the edge undulates. Defaults to 0.012 of the size.
    wavinessFreqnumber0.018Noise frequency of the edge undulation.
    shadowstring—CSS filter for the cast shadow; "none" for a bare orb without shadow or rim.
    classNamestring—Extra classes for the root element.