Metric trend
PROIs this normal for me? A value over time against your band.
Every shadcn style · one file
v2.0 · Updated Oct 13Live preview
pnpm dlx shadcn@latest add @notchset-pro/metric-trendInstallation
pnpm dlx shadcn@latest add @notchset-pro/metric-trendNeeds your registry key. Every components.json style gets the same files.
Works with React 18.3 or 19 on Tailwind CSS v4, in any shadcn project. What's tested
Styles didn't apply?
The CLI adds the styles to the CSS file named in components.json (tailwind.css). Check that it points at your global stylesheet, that the project uses Tailwind CSS v4, and that the file is imported in your root layout. Installed by hand: paste styles.css into that file.
Usage
Import it and pass your content. The props that matter most are listed next.
Example
"use client";
import { MetricTrend, type TrendPoint } from "@/components/ui/notchset/blocks/metric-trend";
const VALUES = [56, 57, 55, 56, 58, 57, null, 56, 55, 57, 56, 62, 63, 62, 63, 59, 57, 56, 55, 56, 57, 56, 55, 56, 57, 55, 56, 55, 56, 55];
const POINTS: TrendPoint[] = VALUES.map((value, i) => ({ label: `${i + 26} Sep`.replace(/^(3[1-9]|[4-5]\d) Sep/, (m) => `${Number(m.split(" ")[0]) - 30} Oct`), value }));
export default function MetricTrendDemo() {
return (
<div className="max-w-[720px]">
<MetricTrend title="Resting heart rate" unit="bpm" points={POINTS} band={{ low: 54, high: 59, label: "Your usual" }} events={[{ at: 11, label: "Sore throat" }]} trend="Steady over 30 days" gapLabel="Ring off" />
</div>
);
}Anatomy
Source
components/ui/notchset/blocks/metric-trend.tsx
This component is included with Pro.
Try the live preview above. Get Pro to install the source.
Props
title–stringRequired.
unit–stringRequired.
points–TrendPoint[]Required.
kind"days""days" | "draws""days": a continuous measure with gaps; "draws": sparse lab results, dots joined by a dotted line
band–{ low?: number | undefined; high?: number | undefined; label: string }the band it's read against, named: "Your usual", "Lab range"
events[]{ at: number; label: string }[]what you logged, at the index of the point it explains
Show all 15 propsShow fewer
trend–stringthe trend in words, from the engine ("Steady over 30 days"), or why there isn't one
gapLabel"No data"stringwhat a stretch with no data was ("Ring off"), said in the gap
format(n) => formatReading(n)(n: number) => stringperiods–{ value: string; label: string }[]the periods the host offers, and the chosen one
luminous–booleanLight itself, where the surface is lit (the night ground, a flood's wash): the line's core turns near-white (`--ns-series-core`) over its Signature glow. On a plain light ground the token is the series, so it stays the family's line.
hideValue–booleanthe page already shows the latest value at scale (a body page's flood tile): leave the number out, keep the words
echo–{ values: (number | null)[]; label: string }a faint second trace behind the line, in the Signature's tint: your usual over the same days (one per point)
period–stringonPeriod–(v: string) => void
For coding agents
Give your coding assistant the Markdown guide instead of screenshots.
Where agents read it
- Guide for this component: https://notchset.dev/md/metric-trend.md
- Every component, for tools without MCP: /llms.txt
- MCP server:
https://notchset.dev/api/mcp(setup)
Changelog
v2.0.0 · 2026-10-13
Released with the Notchset system.
Used in
The same file, at work in a finished app. Open it live and find it on its pages.
Part of a kit
Lab results. Upload a lab report, confirm what was read, and see every result against its range, ready to share with a clinician.
2 free · 7 ProSee the Lab results kit
Part of
Included with Pro
Pro is in early access.
