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

today

Call · Meeting notes

Re: Founding GTM Engineer at Example Labs

today

Email · Riley

This week

Founding GTM Engineer at Example Labs

3d

Email · you

Older

Met at a GTM engineering meetup; open to a move next year.

1y

Note

Install

With your coding agentInstall RecruiterOS/recruit-ui and add an activity timeline of calls, emails and notes to a candidate's detail pane.
With the shadcn CLIpnpm dlx shadcn@latest add RecruiterOS/recruit-ui/recruit-workflows

Props

PropTypeWhat it does
groupsrequiredreadonly CandidateActivityGroup[]The periods, in order, usually newest first. Empty groups are left out.
loadingbooleanSkeleton rows in place of the timeline.
emptyCandidateEmptyCopyThe blank slate's wording. Defaults to "No activity yet".
spacingTimelineProps["spacing"]The kit Timeline's spacing between rows in a period. Defaults to `tight`.
labelsPartial<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.