Timeline
A chronology as an ordered list, with tone-coded markers and machine-readable timestamps.
Live preview
Source
The exact file rendered in the preview above.
components/demos/timeline.tsx
components/ui/timeline.tsx
Demo source — adapt to your project. Foundry is not published as a package.
Usage
For a sequence where the order is the meaning: release history, audit trail, incident timeline. Rendered as an ordered list precisely because the order is content.
- Timestamps use `<time datetime>` so the machine-readable date and the human-readable one cannot drift.
- Tone the marker by outcome, not by recency.
- For dense in-product feeds use ActivityItem, which is the compact sibling.
Variants and states
Every entry below is a genuine difference in behaviour or layout, and every one of them is visible in the preview above.
- Stacked
- Tone-coded markers
- With icons
- With descriptions
Accessibility
- Order
- An `<ol>`, so assistive tech announces position and count.
- Time
- Every entry pairs a display string with an ISO `datetime` attribute.
Foundry implements published ARIA patterns and is tested against them. No WCAG certification is claimed — see the accessibility documentation for what is and is not covered.
Related
All componentsActivity item
A compact feed row: actor, action, target, time and optional metadata.
starter3 variantsCompany history
Years down the left, events to the right, connected by one rule.
starter3 variantsStepper
Multi-step progress in horizontal and vertical orientations, with state conveyed in words as well as ticks.
starter3 variants