# UI components (/ui)

Whole recruiting workflows, not buttons and cards. Each has its own page: a live example, what it shows, its props and the data it needs.

## Copy to your agent [#copy-to-your-agent]

```text title="Copy to your agent"
pnpm dlx shadcn@latest add RecruiterOS/recruit-ui/recruit-workflows
```

## How it fits together [#how-it-fits-together]

The components draw the screens. The data layer keeps the records. Your app sits in between and stays yours.

1. **Install.** One command, or one line pasted into your coding agent.
2. **Compose.** Lay out your pipeline, profiles and shortlists from the components.
3. **Connect.** Point them at the Kith data layer, or at a backend you already run.
4. **Ship.** Deploy it where you like. The code is yours.

## All 71 components [#all-71-components]

### Review [#review]

- [Review card](/ui/candidate-review-card): One person against a role, with your actions.
- [Inline card](/ui/candidate-inline-card): A compact candidate row for lists and messages.
- [Decision bar](/ui/candidate-decision-bar): Equal-weight decision buttons with a pressed state.
- [Quote](/ui/candidate-quote): A quiet excerpt, such as a call note.

### Review actions [#review-actions]

- [Header actions](/ui/candidate-header-actions): The controls beside a card's name.
- [Voice note](/ui/candidate-voice-note): A hook that lets a note be spoken from a card.
- [Selectable avatar](/ui/candidate-selectable-avatar): An avatar that selects a person for a batch.
- [Pending note](/ui/candidate-pending-note): A note just left, before your records catch up.
- [Review action row](/ui/candidate-review-action-row): The row of controls at the foot of a review card.
- [Decision buttons](/ui/candidate-decision-buttons): Yes and No that start your own decision flow.
- [Decision reason dialog](/ui/candidate-decision-reason-dialog): Asks why before a decision is recorded.
- [Decision reason sheet](/ui/candidate-decision-reason-sheet): The voice-first Why? after a Yes or a No.
- [Stage actions](/ui/candidate-stage-actions): Advance, contact, present, reject or mark declined.
- [Stage select](/ui/candidate-stage-select): A compact select for a pipeline stage.

### Lists and card actions [#lists-and-card-actions]

- [Card list](/ui/candidate-card-list): A searchable grid of your candidate cards.
- [Card columns toggle](/ui/candidate-card-columns-toggle): One or two cards per row, remembered.
- [Favourite button](/ui/candidate-favourite-button): A star that marks a favourite.
- [Profile link button](/ui/candidate-profile-link-button): Opens a person's profile elsewhere.
- [Shared profile button](/ui/candidate-shared-profile-button): Previews the page a person was shared on.
- [Contact channels menu](/ui/candidate-contact-channels-menu): Records which channels a person was contacted on.

### Relationships and roles [#relationships-and-roles]

- [Relationship card](/ui/candidate-relationship-card): A person in your network and the roles they fit.
- [Filter chips](/ui/candidate-filter-chips): Chips that narrow a list of people to one kind.
- [Signal menu](/ui/candidate-signal-menu): Act on a signal, snooze it or dismiss it.
- [Signal list](/ui/candidate-signal-list): The signals about one person.
- [Role matches](/ui/candidate-role-matches): Roles a person may fit, with why.
- [Suggested roles panel](/ui/candidate-suggested-roles-panel): A counted section for a person's suggested roles.

### Calls [#calls]

- [Call list](/ui/candidate-call-list): The calls linked to one person.
- [Call card](/ui/candidate-call-card): One call linked to a person, with its transcript.
- [Matched call card](/ui/matched-call-card): A call already linked to people.
- [Call matching](/ui/call-reconcile-card): Attach a recorded call to the right person.

### Candidate detail [#candidate-detail]

- [Detail layout](/ui/candidate-detail-layout): The frame of a person's detail pane.
- [Decision summary](/ui/candidate-decision-summary): The recorded decision and the grade, together.
- [Job evidence](/ui/candidate-job-evidence): Why a person was sourced for a role.
- [Notes](/ui/candidate-notes): The notes on a person, and a composer.
- [Fact list](/ui/candidate-fact-list): Facts gathered about a person.
- [Contact details](/ui/candidate-contact-details): How to reach a person, and when they were contacted.
- [Channel actions](/ui/candidate-channel-actions): Email, call, message and profile links.
- [Activity timeline](/ui/candidate-activity-timeline): A person's history, grouped by period.
- [Outreach composer](/ui/candidate-outreach-composer): Drafts a first message to a person.
- [Outreach drafts](/ui/candidate-outreach-drafts): Messages drafted, then approved before sending.
- [Pipeline list](/ui/candidate-pipeline-list): The roles a person is in the pipeline for.
- [Document list](/ui/document-list): The files attached to a person or a role.

### Profile [#profile]

- [Profile](/ui/candidate-profile): Identity, career history and contact channels.
- [Profile dialog](/ui/candidate-profile-dialog): A profile in a dialog, or a drawer on a phone.
- [Cover header](/ui/candidate-cover-header): A cover and an identity, as cards and profiles share them.
- [Career history timeline](/ui/candidate-career-history-timeline): Roles grouped by employer, with dates.
- [Career history panel](/ui/candidate-career-history-panel): A career history under a counted header.
- [Current company label](/ui/current-company-label): A person's current company, on one line.
- [Current company popover](/ui/current-company-popover): A company that opens your content on hover or tap.

### Assessment and delivery [#assessment-and-delivery]

- [Assessment](/ui/candidate-assessment): A grade with its evidence and caveats.
- [Grade badge](/ui/candidate-grade): A grade letter with your own label and tone.
- [Destination status](/ui/candidate-destination-status): Where candidates are delivered, and how it is going.
- [Shortlist](/ui/candidate-shortlist): People, a note from you, and a client decision.
- [Shortlist note](/ui/candidate-shortlist-note): A personal note above a shortlist you send.
- [Client decision](/ui/candidate-client-decision): A client's Yes or No on a person, with why.
- [Presentation recorder](/ui/candidate-presentation-recorder): A short voice note to send with a profile.
- [Share dialog](/ui/candidate-share-dialog): Makes a link to a person's profile, and hands it over.
- [Shared profile](/ui/candidate-shared-profile): A profile as the person it was shared with sees it.
- [Shared profile sections](/ui/candidate-shared-profile-sections): The sections of a shared profile, each on its own.

### Jobs and pipeline [#jobs-and-pipeline]

- [Job summary card](/ui/job-summary-card): A job at a glance.
- [Job brief](/ui/job-brief-card): A versioned brief with must-haves, nice-to-haves and red flags.
- [Job brief changes](/ui/job-brief-changes): What one version of a brief changed.
- [Job client badge](/ui/job-client-badge): The organisation a job is for.
- [Pipeline card](/ui/candidate-pipeline-card): A dense card for a board column.
- [Pipeline board](/ui/candidate-pipeline-board): A job's pipeline as a board, a column per stage.
- [Add to job popover](/ui/candidate-add-to-job-popover): Adds people to a job, at a stage.
- [Search progress](/ui/job-search-progress): Where a search stands, step by step.
- [Sourcing trace](/ui/sourcing-trace): How a sourcing run went, a line per step.
- [Client search page](/ui/client-search-page): A search as its client sees it, on one page.
- [Client search conversation](/ui/client-search-conversation): The conversation that gets a brief ready.
- [Client search sections](/ui/client-search-sections): The sections of an open search, each on its own.