Skip to content
MIZU.

Sparkline

A compact history trace with the underlying readings in its accessible name.

View .md

Live — this one is real

Illustrative build duration in seconds: 4, 3, 3.6, 2.2, 2.8, 1.5, 1.2

Usage

tsx
import { Sparkline } from "mizu-ui";

export function Example() {
  return (
    <Sparkline
      label="Illustrative build duration in seconds"
      values={[4, 3, 3.6, 2.2, 2.8, 1.5, 1.2]}
    />
  );
}

Source & setup

Add this component to your project with the shadcn CLI. The command copies its source into your configured UI directory, with base.css, Mizu’s tokens, and the stylesheets that hold its rules. Each rule lives in one stylesheet, so components you add together never repeat CSS. In a project without a components.json, run npx shadcn@latest init 0xuser64bit/mizu/preset first: plain init installs shadcn’s theme into your global CSS. Then load the fonts.

sh
npx shadcn@latest add 0xuser64bit/mizu/sparkline

Every component imports from its own path, its name in kebab case. Its source, data/Charts.tsx, also holds BarChart and Heatmap. Each has its own command and path; adding one after this copies only its small entry file. To paste the example, replace its mizu-ui import with:

tsx
import { Sparkline } from "@/components/ui/mizu/sparkline";

For npm imports, import mizu-ui/styles.css once. Fonts are optional via mizu-ui/fonts.css. Override --mizu-* tokens or use className for local styling. Uses native React and CSS; install the package peers for root imports. A Client Component: its source starts with “use client”.

Inspect data/Charts.tsx

Source is included in the npm package under src/data/Charts.tsx.

Open full source ↗

Props

PropTypeDefaultDescription
valuesnumber[]—Sequential readings; non-finite values are omitted.
labelstring—Describe the quantity and units.

Accessibility

SVG has a unique title with the full readings. Use a table for large datasets; this is a compact trend.

Motion

Static SVG, no background loop.

Works alongside