DocsGitHub
Getting Started
  • Overview
  • Design Tokens
Components
  • Accordion
  • Alert
  • Announcement
  • Avatar
  • Badge
  • BigCalendar
  • Breadcrumb
  • Button
  • ButtonGroup
  • Calendar
  • Card
  • Checkbox
  • Chip
  • CloseButton
  • Combobox
  • CommandPalette
  • ContextMenu
  • Currency
  • DatePicker
  • DescriptionList
  • Drawer
  • DropdownMenu
  • EmptyState
  • Field
  • FileUpload
  • FormGrid
  • Hotkey
  • Icon
  • Input
  • Metric
  • Modal
  • MultiSelect
  • NumberInput
  • Pagination
  • Popover
  • ProgressBar
  • Radio
  • Rating
  • SegmentedControl
  • Select
  • SelectionCard
  • Sidebar
  • Skeleton
  • Slider
  • Spinner
  • Stepper
  • Switch
  • Table
  • Tabs
  • Textarea
  • Timeline
  • TimePicker
  • Toast
  • Tooltip
  • TransferList
  • TreeView
  • Wizard
Charts
  • Overview
  • Area Chart
  • Bar Chart
  • Donut Chart
  • Line Chart
  • Pie Chart
  • Stacked Bar Chart

Timeline

Displays audit trails, status changes, and record activity in chronological order.

Default

A semantic activity feed for audit trails and record history.

  1. Invoice INV-2026-1042 created
    Today, 09:30
    Ada Lovelace created the invoice for Acme Corporation.
  2. Invoice sent
    Today, 09:42
    Delivered to accounts@acme.example.
  3. Payment received
    Today, 11:18
    $12,480.00 was matched automatically.
tsx
<Timeline items={items} />

Installation

tsx
import { Timeline } from "madagent";

Semantic colors

Use semantic colors to distinguish informational, warning, success, and error events.

  1. Invoice INV-2026-1042 created
    Today, 09:30
    Ada Lovelace created the invoice for Acme Corporation.
  2. Invoice sent
    Today, 09:42
    Delivered to accounts@acme.example.
  3. Payment received
    Today, 11:18
    $12,480.00 was matched automatically.
tsx
<Timeline items={[{ id: "paid", title: "Payment received", color: "positive" }]} />

Dense

Dense mode stacks timestamps and reduces vertical spacing.

  1. Invoice INV-2026-1042 created
    Today, 09:30
    Ada Lovelace created the invoice for Acme Corporation.
  2. Invoice sent
    Today, 09:42
    Delivered to accounts@acme.example.
  3. Payment received
    Today, 11:18
    $12,480.00 was matched automatically.
tsx
<Timeline items={items} dense />

Props

PropTypeDefaultDescription
items*
TimelineItem[]
-Ordered audit or activity records
dense
boolean
falseReduces spacing and stacks timestamps

RTL Support

Components automatically adapt to right-to-left languages using CSS logical properties.

Preview

  1. تم إنشاء الفاتورة
    اليوم، ٩:٣٠
  2. تم إرسال الفاتورة
    اليوم، ٩:٤٢
  3. تم استلام الدفعة
    اليوم، ١١:١٨

Usage

tsx
<Timeline items={[
  { id: "1", title: "تم إنشاء الفاتورة", timestamp: "اليوم، ٩:٣٠", color: "accent" },
  { id: "2", title: "تم استلام الدفعة", timestamp: "اليوم، ١١:١٨", color: "positive" },
]} />