recruit/candidate-relationship-card · CandidateRelationshipCard

Relationship card

A person in your network: where they work, the newest signal about them, three facts, the roles they fit and your latest note.

Sam Lindqvist

RevOps Lead

Sample Analytics· Stockholm

Signal

Open to a move in the first quarter.

Last spoke

3 weeks ago

Known for

4 years

Placed

Once

Recruiter note

3 weeks ago

Wants to build again, not manage. Would move for the right founder.

Select the card, open the suggested roles, or add a favourite.

Install

With your coding agentInstall RecruiterOS/recruit-ui and build a network view of relationship cards with signals and suggested roles.
With the shadcn CLIpnpm dlx shadcn@latest add RecruiterOS/recruit-ui/recruit-workflows

Props

PropTypeWhat it does
namerequiredReactNodeThe person's name, a level-3 heading on one truncated line.
avatarReactNodeAvatar at the start of the header.
coverReactNode | nullThe person's own cover, as media the host owns, softened until the card is hovered. Left out, the kit's stock banner (`CoverBanner`) is drawn in its place, in the theme's colours, so everyone's card is the same height; `null` draws no cover.
coverSeedCandidateCoverSeedDeals the stock banner its design, the same one every time: the person's id, say. Left out, the name is the seed where it is plain text.
coverSizeCandidateCoverImageSizeThe cover's size, the person's own or the stock one. `compact` caps it at 96px, for a card wide enough that a full 4:1 banner would dwarf it; narrower than 384px it is 4:1 either way.
verifiedbooleanMarks a verified contact with a check after the name.
headlineReactNodeThe line under the name, usually the current title.
companyReactNodeThe current company, usually a CurrentCompanyPopover or CurrentCompanyLabel.
locationReactNodeWhere they are, after the company.
actionsReactNodeControls at the end of the header, such as a favourite button and a profile link.
signalCandidateRelationshipSignal
factsrequiredreadonly CandidateRelationshipFact[]Up to three facts, in a row that stacks on narrow screens.
suggestionCandidateRelationshipSuggestion
noteCandidateRelationshipNote
selectedbooleanSelected treatment, and aria-current.
onSelectrequired() => voidCalled when the card is activated, but not from a click on a nested control.

Data

On the Kith data layer, a relationship card reads a person's record, notes and suggested roles. With your own backend, pass the same values and callbacks.