Skip to content

Activity feed

A timeline of events with tone dots, avatars and relative timestamps.

The variant of an item colours its dot: create, update, delete, comment or status-change. ActivityFeedTimestamp writes the time as it stands when the page is drawn (3 days ago) and does not count on afterwards.

Default

Product commented on the launch checklist
Billing migration moved to In review
The due date of INV-1042 changed to 30 November
The draft of release 4.1.3 was deleted
The project Atlas redesign was created

With avatars

Ines Quill approved release 4.2.0
Tam Rook attached the test report
Wren Alder opened the release

Installation

npx shadcn@latest add @khaeli/activity-feed

Install @khaeli/foundation first: this item's styling lives in its tokens and [data-slot] rules.

Installs with

Registry items

Accessible name

  • The dot is hidden from assistive technology and its colour is the only thing the variant changes, so the sentence must say what happened: deleted, commented, moved to In review.
  • The feed and its items are plain divs. Give the feed role="list" and each item role="listitem" so the events are counted and read as a list.
  • ActivityFeedTimestamp is a time element: the relative text is read, and dateTime holds the exact moment.
  • An avatar beside the person's name is decoration: hide it with aria-hidden.

Registry JSON

The item as the shadcn CLI reads it, with every file it ships: https://ui.khaeli.com/r/activity-feed.json