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 agentInstall RecruiterOS/recruit-ui and add a voice-first sheet that asks why after a yes or a no on a candidate.
With the shadcn CLIpnpm dlx shadcn@latest add RecruiterOS/recruit-ui/recruit-workflows

Props

PropTypeWhat it does
openrequiredboolean
onCloserequired() => voidCalled from the close button and Escape. Nothing is decided.
decisionCandidateDecisionChoiceThe 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.
candidateNamestringThe candidate's name, for the default wording only.
titleReactNodeThe question, as the sheet's heading and its accessible name.
subtitleReactNodeThe line under the question, which also describes the sheet to a screen reader.
voiceTitlestringThe dictation overlay's title, such as "Why no on Mei Tanaka?".
reasonsreadonly string[]One-tap reasons, already worded. Picking one confirms with it.
onConfirmrequired(reason?: string) => unknownCalled 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.
reasonRequiredbooleanTakes Skip away, so the only ways out are a reason or the close button. A reason is optional without it: encouraged, never demanded.
skipLabelReactNodeSkip's wording, such as "Skip — just reject Mei Tanaka".
footerReactNodeHost 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.
actionsReactNodeHost controls in the bottom row, before Skip, such as another way to decide.
voiceboolean`false` leaves dictation out, and the sheet opens on the typed reason. It also opens there wherever dictation can't run.
voiceLangstringThe language dictation listens for, as a BCP 47 tag.
labelsPartial<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.