recruit/candidate-activity-timeline · CandidateActivityTimeline
Activity timeline
A person's history grouped by period: each row a glyph, a title, a line of context and a timestamp, with a longer body behind a toggle or a link to open.
Today
Intro call: Founding GTM Engineer
todayCall · Meeting notes
Re: Founding GTM Engineer at Example Labs
todayEmail · Riley
This week
Founding GTM Engineer at Example Labs
3dEmail · you
Older
Met at a GTM engineering meetup; open to a move next year.
1yNote
Install
With your coding agent
Install RecruiterOS/recruit-ui and add an activity timeline of calls, emails and notes to a candidate's detail pane.With the shadcn CLI
pnpm dlx shadcn@latest add RecruiterOS/recruit-ui/recruit-workflowsProps
| Prop | Type | What it does |
|---|---|---|
| groupsrequired | readonly CandidateActivityGroup[] | The periods, in order, usually newest first. Empty groups are left out. |
| loading | boolean | Skeleton rows in place of the timeline. |
| empty | CandidateEmptyCopy | The blank slate's wording. Defaults to "No activity yet". |
| spacing | TimelineProps["spacing"] | The kit Timeline's spacing between rows in a period. Defaults to `tight`. |
| labels | Partial<CandidateActivityTimelineLabels> |
Data
The component takes plain values and callbacks and keeps no records of its own. Pass it yours, from the Kith data layer or from a backend you already run.