ActivityTimeline

Recent activity list with avatar rails, action badges, and timestamps.

Quick Preview

Recent Activity

  1. M
    Update
    Musa updated this listing 2h ago
  2. S
    Approved
    Sarah approved this listing 4h ago
  3. T
    Commented
    Tom commented on this listing 1d ago

Usage

import {
  ActivityTimeline,
  ActivityTimelineAvatar,
  ActivityTimelineBadge,
  ActivityTimelineConnector,
  ActivityTimelineContent,
  ActivityTimelineDescription,
  ActivityTimelineItem,
  ActivityTimelineList,
  ActivityTimelineRail,
  ActivityTimelineTitle,
} from "@giddaa-housing/ui/activity-timeline";

<ActivityTimeline>
  <ActivityTimelineTitle>Recent Activity</ActivityTimelineTitle>
  <ActivityTimelineList>
    <ActivityTimelineItem>
      <ActivityTimelineRail>
        <ActivityTimelineAvatar initials="S" />
        <ActivityTimelineConnector />
      </ActivityTimelineRail>
      <ActivityTimelineContent>
        <ActivityTimelineBadge variant="success">Approved</ActivityTimelineBadge>
        <ActivityTimelineDescription>
          Sarah approved this listing 4h ago
        </ActivityTimelineDescription>
      </ActivityTimelineContent>
    </ActivityTimelineItem>
  </ActivityTimelineList>
</ActivityTimeline>

Examples

States

Use highlighted on ActivityTimelineItem to show the active/hovered row from the design. Omit ActivityTimelineTitle when the surrounding card already supplies a title.

Recent Activity

  1. M
    Update
    Musa updated this listing 2h ago
  2. S
    Approved
    Sarah approved this listing 4h ago
  3. T
    Commented
    Tom commented on this listing 1d ago

Recent Activity

  1. M
    Update
    Musa updated this listing 2h ago
  2. S
    Approved
    Sarah approved this listing 4h ago
  3. T
    Commented
    Tom commented on this listing 1d ago
  1. M
    Update
    Musa updated this listing 2h ago
  2. S
    Approved
    Sarah approved this listing 4h ago
  3. T
    Commented
    Tom commented on this listing 1d ago

Props

Prop/APITypeDefaultDescription
ActivityTimelinesection props-Root card surface.
ActivityTimelineTitleh3 props-Optional heading.
ActivityTimelineListol props-Timeline list wrapper.
ActivityTimelineItemli props + highlighted, highlightOnHover-Row surface.
ActivityTimelineRaildiv props-Avatar and connector column.
ActivityTimelineAvatarAvatar props + src, alt, initials-Timeline avatar shortcut.
ActivityTimelineConnectorspan props-Vertical rail connector that joins the current avatar to the next item. Omit it from the last item.
ActivityTimelineContentdiv props-Badge and description column.
ActivityTimelineBadgeBadge props + icon-Action badge.
ActivityTimelineDescriptiondiv props-Activity copy and timestamp.

Composition

ActivityTimeline
├── ActivityTimelineTitle
└── ActivityTimelineList
    └── ActivityTimelineItem
        ├── ActivityTimelineRail
        │   ├── ActivityTimelineAvatar
        │   └── ActivityTimelineConnector
        └── ActivityTimelineContent
            ├── ActivityTimelineBadge
            └── ActivityTimelineDescription

Accessibility

  • Keep description meaningful without relying on badge color alone.
  • Use stable keys when mapping live activity data into composed items.
  • Keep product fetching, routing, and authorization logic in the consuming app.

On this page