Range bar
FREEWhere one value stands: its range, its limits and the word.
Every shadcn style · one file
v2.0 · Updated Oct 13Live preview
pnpm dlx shadcn@latest add https://notchset.dev/r/range-bar.jsonInstallation
pnpm dlx shadcn@latest add https://notchset.dev/r/range-bar.jsonFree, no account or key. One command for every shadcn style. With the @notchset registry added, @notchset/<name> works too.
Works with React 18.3 or 19 on Tailwind CSS v4, in any shadcn project. What's tested
Install by hand
- 1. No extra packages: React is enough.
- 2. Copy the files to these paths (the source, or save them all as a .zip)
- components/ui/notchset/range-bar.tsx
- lib/notchset/physics.ts
- lib/notchset/standing.ts
- 3. No stylesheet needed.
- 4. Install what it builds on first: shadcn's cn helper (lib/utils.ts, from npx shadcn init), the theme foundation (its tokens and base styles), Rolling number, Status pill
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 { RangeBar } from "@/components/ui/notchset/range-bar";
export default function RangeBarDemo() {
return (
<div className="flex max-w-[520px] flex-col gap-8">
<RangeBar
name="Vitamin D"
value={41}
unit="ng/mL"
range={{ low: 30, high: 100, kind: "lab", source: "Northside Lab" }}
optimal={{ low: 40, high: 60, kind: "optimal", source: "Your clinic's optimal set" }}
previous={{ value: 23, label: "25 Mar" }}
measured="Northside Lab · 16 Oct"
>
Back in range since March, when it was low.
</RangeBar>
<div className="grid grid-cols-[120px_48px_minmax(0,1fr)] items-center gap-3 text-[13px]">
<span>LDL cholesterol</span>
<span className="text-right tabular-nums">128</span>
<RangeBar size="row" name="LDL cholesterol" value={128} unit="mg/dL" range={{ high: 99, kind: "lab", source: "Northside Lab" }} previous={{ value: 143, label: "25 Mar" }} />
</div>
</div>
);
}Anatomy
Source
components/ui/notchset/range-bar.tsx
Loading the code
Props
name–stringwhat's measured: "Vitamin D"
value–number | nullthe value; null when there's no result yet
unit–stringRequired.
range–ValueRangethe range it's read against: the lab's printed reference range, or your baseline
optimal–ValueRangean optimal range inside it, with its source
previous–{ value: number; label: string }the previous value, drawn as an ink tick with the way it moved
Show all 10 propsShow fewer
flag–ValueFlagmeasured–stringwhen and where it was measured: "Lab · 16 Oct", "Ring · synced 7:02"
size"full""full" | "card" | "row"format(n) => formatReading(n)(n: number) => stringhow a value is written (default: one decimal under 10)
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/range-bar.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
