Skip to content

Indicator

⋯

The Indicator family implements the Breadcrumb, Step Indicator, Progress Bar, and Stepper Figma sets. All variants use semantic color roles and render in Light and Dark.

import { Breadcrumb } from "@nesra/ui/indicator";
export function ProjectBreadcrumb() {
return (
<Breadcrumb.Root>
<Breadcrumb.List>
<Breadcrumb.Item>
<Breadcrumb.Link href="/projects">Projects</Breadcrumb.Link>
</Breadcrumb.Item>
<Breadcrumb.Separator />
<Breadcrumb.Item>
<Breadcrumb.Page>Overview</Breadcrumb.Page>
</Breadcrumb.Item>
</Breadcrumb.List>
</Breadcrumb.Root>
);
}
import { ProgressBar } from "@nesra/ui/indicator";
export function UploadProgress() {
return <ProgressBar aria-label="Upload progress" value={65} />;
}

The exports are also available from @nesra/ui.

Breadcrumb.Root
└── Breadcrumb.List
├── Breadcrumb.Item
│ └── Breadcrumb.Link | Breadcrumb.Page
├── Breadcrumb.Separator
└── Breadcrumb.Item
└── Breadcrumb.Ellipsis
Stepper
└── StepperItem × N

Basic and collapsed compositions are available in sm and md.

StepIndicator supports pass, active, and disabled, with labels at the top, bottom, both positions, or neither.

CompleteComplete
CurrentCurrent
UpcomingUpcoming

ProgressBar accepts any number and clamps it to 0–100.

x
x
x
x
x

Stepper composes step sequences from StepperItem parts with done, active, and inactive states. Each item can show a subtitle below its label.

  1. Step 1
  2. Step 2
  3. Step 3
  1. Step 1
  2. Step 2
  3. Step 3
  4. Step 4
  1. Step 1
  2. Step 2
  3. Step 3
  4. Step 4
  5. Step 5
  1. Diajukan05 Sep 2026, 14:20
  2. Ditolak08 Sep 2026, 14:00

Set separator="arrow" on each item for the arrow connector. Use subtitle for supporting text below a label. The last item hides its connector.

  1. Submitted05 Sep 2026, 14:20
  2. Approved06 Sep 2026, 08:00
  3. Partially paid12 Sep 2026, 08:00
  4. Paid
  5. Awaiting journal entry
  6. Recorded

The step counts are compositions rather than separate prop values. The sequence remains horizontally scrollable when it does not fit.

Indicator colors come from semantic roles, so they follow .dark or data-theme="dark" on an ancestor.

Part Roles
Breadcrumb Links text-support, hover text-body. Separators and ellipsis icon-muted. Current page text-body. Link focus shadow-nesra-focus-ring
Step indicator Track categorical-neutral-border with a stroke-divider border and an action-primary-default bar
Step indicator icon pass: icon-neutral. active: icon-brand-primary. disabled: icon-disabled with a text-support label
Progress bar Track categorical-neutral-border; fill gradient categorical-blue-border to categorical-blue-base; value text-body
StepperItem active foundation-bg-brand-solid marker with a text-on-brand number. The number is white in Light and gray-950 in Dark
StepperItem inactive action-primary-disabled marker, text-tertiary number, text-support label
StepperItem done foundation-bg-success-solid marker with an icon-static-white check
Stepper connectors 2px stroke-border line; arrow stroke-border, or text-support after a done step
  • Breadcrumb.Root renders a named navigation landmark and Breadcrumb.Page marks the current page.
  • Breadcrumb.Ellipsis names the omitted portion but is not interactive. Use a menu control separately when users must open omitted destinations.
  • ProgressBar uses Base UI progress semantics. Supply a task-specific aria-label when visible context does not name it.
  • StepIndicator communicates visual state only. Stepper renders an ordered list and the active StepperItem sets aria-current="step".
Prop Type Default Description
size "sm" | "md" "md" Text size and separator spacing.
aria-label string "Breadcrumb" Navigation landmark name.
className string — Adds or overrides classes.

Breadcrumb.Root forwards native nav props.

Breadcrumb.List renders an ordered list and forwards native ol props.

Breadcrumb.Item renders one list item and forwards native li props.

Breadcrumb.Link renders an ancestor destination and forwards native anchor props, including href.

Breadcrumb.Page renders the current destination as a span, sets aria-current="page", and forwards native span props.

Breadcrumb.Separator renders a decorative li with a right chevron by default. Its optional children replace the chevron. It forwards native li props.

Breadcrumb.Ellipsis renders a non-interactive marker. Its aria-label defaults to "More breadcrumb items"; other native span props are forwarded.

Prop Type Default Description
label ReactNode required Visible label.
state "disabled" | "pass" | "active" "pass" Marker, text, and track treatment.
labelPosition "top" | "bottom" | "both" | "none" "both" Positions where the label is rendered.
className string — Adds or overrides classes.
Prop Type Default Description
value number required Completion percentage, clamped to 0–100.
showValue boolean true Shows the rounded percentage after the track.
className string — Adds or overrides classes.

Other Base UI Progress Root props are forwarded.

Prop Type Default Description
aria-label string "Progress steps" Names the ordered list.
className string — Adds or overrides classes.

Other native ordered-list props are forwarded.

Prop Type Default Description
step ReactNode required Short marker, normally the step number.
state "active" | "inactive" | "done" "inactive" Visual state and current-step announcement.
separator "line" | "arrow" "line" Connector after the item.
children ReactNode required Visible step label.
subtitle ReactNode — Supporting text below the icon and label.
className string — Adds or overrides classes.

Other native list-item props are forwarded.

Visual values come from the semantic color roles, typography, layout, and shape tokens.