Skip to content

NewMCP server for your coding agent. Set it up ›

Nexus UI
Get Pro

Liquid Status, animated React component

Status cards where each icon is a glass vessel holding a glowing liquid, filled to the number on the card. The liquid rolls in two layers of waves under a bright meniscus with bubbles rising through it, and lights the dark card around it. Point at a card and it turns and rolls; the liquid inside stays level and sloshes back. Press to top it up.

  • Pro
  • Dashboards
  • Hover
  • 3D

A soft slosh as a vessel tops up. Sound is off on this site until you switch it on.

Play with it

Move the controls and watch it change. Copy code gives you a snippet with only the props you changed.

Battery
0%
Almost there,
full in 12 min
Cloud storage
0%
Room to grow,
38 GB free
Security score
0%
All clear,
scanned today

Props

PropTypeDefaultWhat it does
statssample dataUp to four stats: { id, label, value, unit?, line1, line2, color, icon }.
enableSoundtrueSoft synthesised sounds as you use it. They also follow the site-wide sound switch.
volume0.6Sound level, 0 to 1.
autoplayfalsePlays a short demo by itself until the visitor touches it. Never runs under reduced motion.
className""Extra classes for the outer element.

Add it to your project

  1. 1

    Set up your project once

    You need a Next.js project with Tailwind CSS and the @/ import alias. In its root folder, run this once. It creates components.json and the cn() helper in src/lib/utils.ts:

    npx shadcn@latest init -d

    Starting from nothing? The Quick Start walks through the whole thing.

  2. 2

    Connect the registry with your API key

    Liquid Status is a Pro item, so the CLI has to send your API key. Do this once per project:

    1. Create a key at nexus-ui.com/dashboard/api-key. Copy it straight away: it starts with nxs_ and is shown only once.
    2. In your project root, next to package.json, create a file named .env.local with this line, using your own key:
      NEXUS_API_KEY=nxs_your_key_here
    3. Open components.json and add this entry inside the outermost braces, next to "aliases". Leave {name} and ${NEXUS_API_KEY} exactly as written; the CLI fills them in:
      "registries": {
        "@nexus-labs": {
          "url": "https://www.nexus-ui.com/api/registry/{name}",
          "headers": {
            "Authorization": "Bearer ${NEXUS_API_KEY}"
          }
        }
      }

How Liquid Status works

Status cards where each icon is a glass vessel holding a glowing liquid, filled to the number on the card. The liquid rolls in two layers of waves under a bright meniscus, bubbles rise through it and it lights the dark card other way and sloshing back. Press a card to top it up.

The source, the install command and the build prompt come with Pro.

Liquid Status questions

Does it make sound, and how do I turn it off?

A soft slosh as a vessel tops up. Sounds are synthesised with the Web Audio API, so there are no audio files, and they only play after a click or key press. Pass `enableSound={false}` to silence this component, or call `setSoundsEnabled(false)` from `@/lib/ui-sounds` to switch every sound off at once. The CLI installs `@/lib/ui-sounds` with the component.