Skip to content

Timeline

⋯

Timeline implements the activity-note anatomy from Figma with semantic ordered-list markup. It composes existing Avatar and Badge components rather than owning product-specific activity data.

import { Avatar } from "@nesra/ui/avatar";
import { Timeline } from "@nesra/ui/timeline";
export function ActivityHistory() {
return (
<Timeline aria-labelledby="activity-title">
<Timeline.Heading id="activity-title">Activity</Timeline.Heading>
<Timeline.List aria-label="Activity history">
<Timeline.Item>
<Timeline.Time dateTime="2026-09-20T15:10:00Z">Sep 20, 2026</Timeline.Time>
<Timeline.Marker>
<Avatar initials="I" name="Irni Susanti" />
</Timeline.Marker>
<Timeline.Content>Updated payment terms</Timeline.Content>
</Timeline.Item>
</Timeline.List>
</Timeline>
);
}

The exports are also available from @nesra/ui.

Timeline
├── Timeline.Heading
└── Timeline.List
└── Timeline.Item × n
├── Timeline.Time
├── Timeline.Marker
│ └── Avatar or another 24px visual
└── Timeline.Content
├── Timeline.ItemHeader
│ ├── Timeline.Actor
│ │ ├── Timeline.ActorName
│ │ └── Timeline.ActorMeta
│ └── Timeline.Separator and consumer metadata
└── Timeline.Note
├── Timeline.NoteLabel
└── Timeline.NoteContent

Activity notes

  1. Irni SusantiAP TeamEditUpdated payment termsDefault term: 14 days → 30 days

    Note

    Renegotiated contract terms

  2. Michael OwenLeadCreateAdded a new vendor

    Note

    No note yet

Compose Avatar, Badge, actor metadata, and an optional decision note for multi-step approvals.

Approval history

  1. Dewi WulandariFinance DirectorApprovedApproved invoice INV-2026-0912

    Decision note

    Budget and supporting documents verified.

  2. Rizky AnandaAP ManagerReviewRequested director approval

The marker slot accepts any 24px visual. Hide decorative icons when the adjacent content already communicates the event.

Document history

  1. Document signedAll signatories completed the document
  2. Signature requestedSent to two reviewers
  3. Document uploadedvendor-agreement.pdf

Omit actor metadata, badges, and note surfaces when the event label is sufficient.

Recent events

  1. Payment completed
  2. Payment processing started
  3. Payment submitted

Headers and note content wrap without changing the marker or connector alignment.

Case history

  1. Automatic review scheduledThe case will be reviewed again after all requested supporting documents arrive.

    Additional context

    The vendor was notified by email and can upload the missing tax certificate and bank ownership letter through the supplier portal.

At widths below the sm breakpoint, the timestamp moves above the entry content while the marker stays in the first column. The desktop layout uses the Figma 100px timestamp column.

Timeline uses semantic roles only and follows the page theme through .dark or data-theme="dark". Times, actor context, note labels, and muted note content use --nesra-text-support. Names and note content use --nesra-text-body. The note surface uses --nesra-surface-card-bg-neutral with a --nesra-stroke-border border, and the connector uses --nesra-stroke-divider. Figma has no Timeline component yet, so these roles follow the color contract rather than a Figma component.

  • Timeline.List renders an ordered list and Timeline.Item renders each list item.
  • Supply a machine-readable dateTime on every Timeline.Time.
  • Name the timeline through visible heading association or an aria-label on the list.
  • Timeline.Marker does not hide its child. Avatar names and other meaningful marker content remain exposed.
  • Timeline.Separator is decorative and hidden from assistive technology.

Timeline forwards native div props. Timeline.Heading accepts as with "h2" through "h6" and defaults to "h2". Choose the heading level from the surrounding page hierarchy.

Timeline.List forwards native ol props. Timeline.Item forwards native li props and owns the responsive time, marker, and content grid.

Timeline.Time forwards native time props. Set dateTime to an ISO or otherwise machine-readable timestamp. Children supply the visible localized date and time.

Timeline.Marker and Timeline.Content forward native div props. The marker draws a connector except on the last item and expects a 24px visual. Content groups the item header and optional body.

Timeline.ItemHeader forwards native div props and wraps metadata. Timeline.Actor, Timeline.ActorName, and Timeline.ActorMeta forward native span props. Timeline.Separator forwards native span props except children and is always decorative.

Timeline.Note forwards native div props. Timeline.NoteLabel and Timeline.NoteContent forward native p props. Timeline.NoteContent accepts muted, which defaults to false and applies the support text role to absent or placeholder copy.

Visual values come from the semantic color roles, typography, layout, and shape tokens.