ProgressFreev1.0.0
shadcn's Progress in Notchset: a ruler whose fill settles on each update, stage nodes that pop once passed, ticks that ink, stage labels with a scanner, a rolling percentage, and a stretching indeterminate bar.
Live preview
Installation
Base UI
pnpm dlx shadcn@latest add https://beautiful-ui.dev/r/progress.jsonRadix
pnpm dlx shadcn@latest add https://beautiful-ui.dev/r/radix-nova/progress.jsonFree, no account or key. Use the command for your project's primitives: a radix-*, new-york or default style in components.json is Radix, a base-* style is Base UI. With the @beautiful-ui registry added, @beautiful-ui/<name> picks for you.
Install by hand
- 1. Add the packages
pnpm add @base-ui/react@^1 - 2. Copy the files to these paths (Source below, or save them all as a .zip)
- components/ui/notchset/progress.tsx
- lib/beautiful-ui/notchset/progress.tsx
- lib/beautiful-ui/notchset/calendar.tsx
- lib/beautiful-ui/notchset/instrument.tsx
- lib/beautiful-ui/notchset/root.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)
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
import { Progress } from "@/components/ui/notchset/progress";
const stages = [
{ label: "FETCH", at: 20 },
{ label: "PARSE", at: 45 },
{ label: "EMBED", at: 85 },
{ label: "INDEX", at: 100 },
];
export function IndexingProgress({ value }: { value: number }) {
// The stage still running; past the last one, the job is done.
const i = stages.findIndex((s) => value < s.at);
const status = i === -1 ? "DONE" : `STAGE ${i + 1} OF ${stages.length} · ${stages[i]!.label}`;
return <Progress value={value} stages={stages} label="INDEXING DOCS" status={status} />;
}Props
value–number | null0–100, or null for indeterminate.
stages–{ label, at }[]Where each stage ends (%).
ticks–numberDefault 50.
label / status–ReactNodeThe header and its line (announced).
statusSignal / paused–booleanSignal colour; stops the scanner.
Source
components/ui/notchset/progress.tsx
Loading the code
