recruit/candidate-decision-reason-sheet · CandidateDecisionReasonSheet
Decision reason sheet
The voice-first “Why?” asked once a reviewer has said Yes or No: speak the reason, tap a suggested one, type it, or skip.
Sam Lindqvist · RevOps Lead at Sample Analytics
Sam Lindqvist is waiting for a decision.
Install
With your coding agent
Install RecruiterOS/recruit-ui and add a voice-first sheet that asks why after a yes or a no on a candidate.With the shadcn CLI
pnpm dlx shadcn@latest add RecruiterOS/recruit-ui/recruit-workflowsProps
| Prop | Type | What it does |
|---|---|---|
| openrequired | boolean | |
| onCloserequired | () => void | Called from the close button and Escape. Nothing is decided. |
| decision | CandidateDecisionChoice | The answer being explained. It only words the defaults ("Why no?", "Skip — just mark No"): the sheet neither holds nor saves a decision, so leave it out for any other question and pass the wording yourself. |
| candidateName | string | The candidate's name, for the default wording only. |
| title | ReactNode | The question, as the sheet's heading and its accessible name. |
| subtitle | ReactNode | The line under the question, which also describes the sheet to a screen reader. |
| voiceTitle | string | The dictation overlay's title, such as "Why no on Mei Tanaka?". |
| reasons | readonly string[] | One-tap reasons, already worded. Picking one confirms with it. |
| onConfirmrequired | (reason?: string) => unknown | Called with the reason a person spoke, typed or picked, trimmed, or with none when they skipped. The host saves the decision and closes the sheet. It may return a promise: while that is pending the sheet shows `labels.saving` in place of the composer and Skip is disabled, though the sheet can still be closed; if it rejects, the composer comes back with a typed or spoken reason still in it and `labels.failed` under it. |
| reasonRequired | boolean | Takes Skip away, so the only ways out are a reason or the close button. A reason is optional without it: encouraged, never demanded. |
| skipLabel | ReactNode | Skip's wording, such as "Skip — just reject Mei Tanaka". |
| footer | ReactNode | Host content over the bottom row, such as a switch that changes what the decision does. Its state stays the host's, read when `onConfirm` runs. |
| actions | ReactNode | Host controls in the bottom row, before Skip, such as another way to decide. |
| voice | boolean | `false` leaves dictation out, and the sheet opens on the typed reason. It also opens there wherever dictation can't run. |
| voiceLang | string | The language dictation listens for, as a BCP 47 tag. |
| labels | Partial<CandidateDecisionReasonSheetLabels> |
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.