Trace
Follow reasoning, tool results and sources with compact, expandable activity traces.
Why does this install fail in CI?
package.json | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
package.json changed, but pnpm-lock.yaml did not. Run pnpm install locally and commit the updated lockfile so CI can install the same dependency versions.
Installation
Install the shared package once in your Exact app. This version is a beta.
bun add --exact @rightui/ui@0.4.0-beta.4
The Exact compiler requires Bun 1.4.2, regardless of which package manager installs the package.
Complete the font, app metadata and root provider setup (required for both installation methods).
Import
use Trace, TraceFrame, TraceLine, TraceTitle, TraceDescription, TraceDisclosure, TraceCollapsible, TraceSource, TraceIcon from "@rightui/ui"
Usage
Use Trace for a simple list of steps. Compose TraceFrame, TraceLine, TraceDisclosure and TraceSource for rich activity with controlled disclosure, per-step icons and running, pending or error states. Pass the reduced-motion preference to the composable primitives. The preview uses a local scripted clock: Replay demonstrates the UI and does not execute commands or contact an AI service. Its source includes the injected clock used by the demo.
Keyboard
Tab moves between disclosures, source links and Replay. Enter or Space toggles the focused disclosure. Closed content is hidden from keyboard navigation.
API Reference
Properties from the component source. State lives in your component; actions receive the updated value.
TraceIcon.icon
string
TraceIcon.status
string
TraceIcon.reduced
bool
TraceTitle.title
string
TraceTitle.running
bool
TraceTitle.reduced
bool
TraceLine.title
string
TraceLine.icon
string
TraceLine.status
string
TraceLine.reduced
bool
TraceDescription.description
string
TraceDisclosure.id
string
TraceDisclosure.title
string
TraceDisclosure.icon
string
TraceDisclosure.status
string
TraceDisclosure.open
bool
TraceDisclosure.reduced
bool
TraceDisclosure.toggle
action
TraceCollapsible.id
string
TraceCollapsible.title
string
TraceCollapsible.icon
string
TraceCollapsible.status
string
TraceCollapsible.initiallyOpen
bool
TraceCollapsible.reduced
bool
TraceSource.title
string
TraceSource.href
string
TraceSource.reduced
bool
Trace.id
string
Trace.title
string
Trace.status
string
Trace.steps
string[]
Trace.details
string[]