build69
build69  /  Components  /  Timelines  /  Timeline

Timeline

v1.0.9Updated 27 Aug 2026

Vertical activity timeline of events with timestamps, icons, and descriptions. Use for audit logs, comments, status history.

Preview

Live · 14 stories
DefaultOpen ↗
Why this is recommendedtimelineactivityloghistory+2

The default, out-of-the-box Timeline.

Recommended for+14
  • Audit logs
  • Comment threads
  • Status history on detail pages
Tags+6
timelineactivityloghistoryfeeddefault
Features+4
  • Icon per event
  • Relative timestamps
  • Grouped by day
  • Author avatars
  • i18n: labels prop overrides every built-in string (reactions, toolbar, reply box, day headers, load-more, empty state); day-header dates and counts format via LocaleProvider
Not recommended for−2
  • Chat conversations (use Chat)
  • Calendar events (use BuildCalendar)

Install

Ask your agent, or call the MCP tool directly. The resolved bundle is written into your project.

get_registry_item({ name: "Timeline" })

Usage

import { Timeline } from '@/components/data-display/timeline';

<Timeline items={activity} />

Tick variants in the left menu — each adds a tab with that variant’s real story source, the same code the preview above renders.

Props

PropTypeRequired
items

Events in chronological order

TimelineItem[]yes
labels

Override any built-in UI string — reaction names, toolbar, reply box, day headers, load-more, empty state (i18n). Merged over DEFAULT_TIMELINE_LABELS; {token} templates for counts

Partial<TimelineLabels>

Related