Trace

The steps an assistant takes, with status and details that unfold.

@cupertinoui/traceRegistry JSON

Installation

pnpm dlx shadcn@latest add @cupertinoui/trace

The first install also adds the macOS theme. See Installation to set up the registry.

Usage

import { Trace, TraceLine, TraceTitle } from "@/components/ui/trace"

<Trace>
  <TraceLine status="running">
    <TraceTitle>Writing a summary…</TraceTitle>
  </TraceLine>
</Trace>

API Reference

Every part forwards the props of the underlying element. The props below are the ones CupertinoUI adds or changes.

TraceLine

PropTypeDescription
status"running" | "error" | "pending"Shimmers while running, red for errors, dimmed while pending.
classNamestringExtra classes, merged with the component's own.

TraceIcon / TraceTitle / TraceDescription / TraceCollapsible / TraceCollapsibleTrigger / TraceCollapsibleContent

PropTypeDescription
classNamestringExtra classes, merged with the component's own.