recruit/candidate-role-matches · CandidateRoleMatchList
Role matches
Roles a person may fit: a compact summary of rows, and a list with why and a confirmed add action.
Summary
Open a role
Possible roles for Riley
A — Strong fit
Built the outbound stack at Example Labs and wants to do it again from scratch.
Install
With your coding agent
Install RecruiterOS/recruit-ui and add a list of the roles a person may fit, with why and an add to role action.With the shadcn CLI
pnpm dlx shadcn@latest add RecruiterOS/recruit-ui/recruit-workflowsProps
CandidateRoleMatchList
| Prop | Type | What it does |
|---|---|---|
| headingrequired | ReactNode | The eyebrow over the list, such as "Possible roles for Mei". |
| matchesrequired | readonly TItem[] | |
| onOpen | (id: TItem["id"]) => void | Opens a role in place. When set, a click on the title calls it instead of following `href`, for a surface that already shows the person. |
| onAddToRole | (id: TItem["id"]) => Promise<void> | Enables the add action. Resolve once the candidate is on the role (the row then shows the added badge); reject when it failed, having told the person why, and the role stays addable. |
| confirmrequired | CandidateRoleMatchConfirm<TItem> | |
| labels | Partial<CandidateRoleMatchListLabels> |
CandidateRoleMatchSummary
| Prop | Type | What it does |
|---|---|---|
| matchesrequired | readonly TItem[] | |
| onOpenrequired | (id: TItem["id"]) => void | Called with a role's id when its row is activated. |
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.