ActivityTimeline
Recent activity list with avatar rails, action badges, and timestamps.
Quick Preview
Recent Activity
- MUpdateMusa updated this listing 2h ago
- SApprovedSarah approved this listing 4h ago
- TCommentedTom 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
- MUpdateMusa updated this listing 2h ago
- SApprovedSarah approved this listing 4h ago
- TCommentedTom commented on this listing 1d ago
Recent Activity
- MUpdateMusa updated this listing 2h ago
- SApprovedSarah approved this listing 4h ago
- TCommentedTom commented on this listing 1d ago
- MUpdateMusa updated this listing 2h ago
- SApprovedSarah approved this listing 4h ago
- TCommentedTom commented on this listing 1d ago
Props
| Prop/API | Type | Default | Description |
|---|---|---|---|
ActivityTimeline | section props | - | Root card surface. |
ActivityTimelineTitle | h3 props | - | Optional heading. |
ActivityTimelineList | ol props | - | Timeline list wrapper. |
ActivityTimelineItem | li props + highlighted, highlightOnHover | - | Row surface. |
ActivityTimelineRail | div props | - | Avatar and connector column. |
ActivityTimelineAvatar | Avatar props + src, alt, initials | - | Timeline avatar shortcut. |
ActivityTimelineConnector | span props | - | Vertical rail connector that joins the current avatar to the next item. Omit it from the last item. |
ActivityTimelineContent | div props | - | Badge and description column. |
ActivityTimelineBadge | Badge props + icon | - | Action badge. |
ActivityTimelineDescription | div props | - | Activity copy and timestamp. |
Composition
ActivityTimeline
├── ActivityTimelineTitle
└── ActivityTimelineList
└── ActivityTimelineItem
├── ActivityTimelineRail
│ ├── ActivityTimelineAvatar
│ └── ActivityTimelineConnector
└── ActivityTimelineContent
├── ActivityTimelineBadge
└── ActivityTimelineDescriptionAccessibility
- Keep
descriptionmeaningful 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.