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 agoWants 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 agent
Install RecruiterOS/recruit-ui and build a network view of relationship cards with signals and suggested roles.With the shadcn CLI
pnpm dlx shadcn@latest add RecruiterOS/recruit-ui/recruit-workflowsProps
| Prop | Type | What it does |
|---|---|---|
| namerequired | ReactNode | The person's name, a level-3 heading on one truncated line. |
| avatar | ReactNode | Avatar at the start of the header. |
| cover | ReactNode | null | The 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. |
| coverSeed | CandidateCoverSeed | Deals 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. |
| coverSize | CandidateCoverImageSize | The 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. |
| verified | boolean | Marks a verified contact with a check after the name. |
| headline | ReactNode | The line under the name, usually the current title. |
| company | ReactNode | The current company, usually a CurrentCompanyPopover or CurrentCompanyLabel. |
| location | ReactNode | Where they are, after the company. |
| actions | ReactNode | Controls at the end of the header, such as a favourite button and a profile link. |
| signal | CandidateRelationshipSignal | |
| factsrequired | readonly CandidateRelationshipFact[] | Up to three facts, in a row that stacks on narrow screens. |
| suggestion | CandidateRelationshipSuggestion | |
| note | CandidateRelationshipNote | |
| selected | boolean | Selected treatment, and aria-current. |
| onSelectrequired | () => void | Called 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.