App components / Activity & timelines
Activity feed
What happened, newest first, grouped by day. People show their initials and system events a grey dot, all on one thin line; times are mono on the right and comments sit in a quiet box underneath. One event can be marked orange as the one that matters.
Code
The component itself, ready to drop into your project. Switch between React, Vue and plain HTML; every version uses the same Tailwind classes on Ochre's tokens.
Today
- MS
Maya Shah released v2.14.0 to everyone
- TO
Tom Okafor commented on Usage-based billing
Caps work for seats. Events need a soft limit first, then the hard stop. - ID
Ines Duarte moved NW-142 to In review
Yesterday
Nightly export finished: 1,284 rows
- MS
Maya Shah assigned NW-139 to Tom Okafor
Installation
Examples
Live feed
New events pop in at the top and the rest glide down. Press Simulate activity.
Today
- TO
Tom Okafor assigned NW-142 to Maya
Deploy #4182 finished in 2 min 14 s
- ID
Ines Duarte opened Usage-based billing
Compact in a card
System events as dots, in a flat card beside other content.
Deploys
4 today28 Oct
a41f9c2 is live
7be0d13 built in 48s
c90e6a7 rolled back
Preview for billing-caps
Timeline items
Event, event with a note and a comment, each with its marker; the last item has no connector.
Ada Sterling approved the release.26 Oct
Sam Okafor changed the rollout.26 Oct
Shipped behind the new flag for 10% of workspaces.Lena Hart commented.26 Oct
Can we keep the old export button for one more release? Two customers still rely on it.Deploy #4182 failed its checks.25 Oct
Waiting for Maya Shah to sign off.Today
Markers
Every kind in Solid, Soft, Plain and Dot.
Motion
Built on Ochre's ease-out curves. With reduced motion switched on, everything still works, it just doesn't move.
Props
| Prop | Type | Default | Description |
|---|---|---|---|
| groups | { label: string; events: ActivityEvent[] }[] | – | Days in order, each with its events newest first. |
| ActivityEvent | { id, actor?, action, time, comment?, highlight? } | – | Leave out actor for a system event (a dot instead of initials). |
| density | "default" | "compact" | "default" | Tighter spacing for panels and cards. |
| ActivityRef | { children, mono? } | – | Strong text for the object in an action; mono for ids like NW-142. |
| ActivityEvent.marker / note | { kind, variant? } / ReactNode | – | A timeline marker in place of initials or a dot, and a short note on a grey strip. |
| <TimelineMarker kind variant> | "done" | "changed" | "failed" | "comment" | "event" | "pending", "solid" | "soft" | "plain" | "dot" | "event", "soft" | The dot or icon on a timeline. Solid for milestones, Soft for events, Plain for quiet updates, Dot for dense feeds. |
| <TimelineItem> | { kind, variant, layout?: "event" | "event-with-note" | "comment", connector?, date?, showDate?, note?, comment? } | – | One event inside <Timeline>, with an optional note or comment. Leave connector off the last one. |
Usage
Use it for
- The history of a record: an issue, an invoice, a deploy.
- A workspace's recent changes on a home or project page.
- Compact density in side panels and cards.
Avoid
- Colour per event type: the line stays grey, with at most one orange marker.
- Feeds that mix days without labels: group by Today, Yesterday, then dates.
- Notifications people must act on: use a list with actions instead.