Skip to content

Commerce

Transaction timeline

Renders the audit trail of a transaction as a vertical list of events joined by a dashed rail, from payment authorization through refunds or disputes.
Available
Ports as-is

Examples

Rendered live from the maintained Storybook story. Lantern stores only the story id and embeds Storybook rather than duplicating the component or its demo.

Transaction timeline

Rendered live from Storybook

Storybook must be running for this to load — bun run start:storybook from the monorepo root, or set NEXT_PUBLIC_STORYBOOK_URL to a deployed instance.

Props

The component's public API, read from its TypeScript source. Descriptions come from TSDoc on the prop, so this table cannot drift from the component.

PropTypeDefaultDescription
events*TransactionTimelineEvent[]—Events in any order — the component sorts newest-first itself and marks the newest with the filled, ringed indicator.

Reference

Transcribed from the component audit. If this disagrees with the source, the source is right.

Source
src/components/transactions/TransactionTimeline.tsx
Portability
Copies across unchanged — only the utils import path moves.
Notes
Use it to show the history of state changes for a single transaction; events can be passed in any order since the component sorts them newest-first and gives the latest entry a larger, ringed indicator. Timestamps are formatted absolutely, not as relative "time ago" text.