caliper uidocs

Live table

Pro

Values that update in place. A changed cell flashes once in the direction it moved and keeps a small arrow; rows never reorder. Pause freezes the view and counts waiting updates.

Installs components/ui/live-table.tsxDepends on @radix-ui/react-slot, lucide-reactMotion none in component source
pnpm dlx shadcn@latest add @caliper/live-table

Worker pools

Live
Worker pools, updating live
NameQueueRequests / sErrorsReplicas
eu-west-11202,4000.40%6
us-east-11602,0900.50%7
us-west-22001,7800.60%8
ap-south-12401,4700.70%6
sa-east-12801,1600.80%7

When to use #

Use it for

  • Prices, queue depths, replica health, campaign spend.
  • Operations views people watch for minutes.

Skip it when

  • Data that changes only on reload; use the data table.
  • Rankings; use the rank list.

Installation #

terminal
pnpm dlx shadcn@latest add @caliper/live-table

Adds its 4 files to components/ui/, each with its own stylesheet, and installs their packages. Pro installs with your access token, set up once per project. See Pro access. The first part also adds Caliper UI’s tokens; import them once as in Installation.

Usage #

Import it from your copy of the source. The example behind the preview comes with the source. It is built from diffRows and LiveTable.

example.tsx
import { diffRows, LiveTable } from "@/components/ui/live-table"

The worked example comes with Pro

The 32-line example behind the preview opens here with a Pro or Team licence.

Checking your licence…

API reference #

diffRows

component

No props of its own; it accepts the native props of its root element.

LiveTable

component
PropTypeDefault
label *string—
columns *readonly LiveColumn[]—
rows *readonly LiveRow[]—
classNamestring—

Accessibility #

It is built on native elements and keeps aria-pressed and aria-hidden in step with state.

No custom key handling; Tab and the native activation keys do the work.

Motion #

It declares no animation in its component source. Any transition comes from its stylesheet, which uses the duration tokens that collapse to instant under prefers-reduced-motion.