recruit/candidate-cover-header · CandidateCoverHeader

Cover header

The shared cover-and-identity hierarchy behind review cards and profiles, with a stable 4:1 media frame.

RO

Riley Okafor

GTM Engineer at Example Labs

AM

Alex Marchetti

Growth Engineer at Fictional Robotics

Install

With your coding agentInstall RecruiterOS/recruit-ui and add a cover header with an avatar and a name to my own candidate card.
With the shadcn CLIpnpm dlx shadcn@latest add RecruiterOS/recruit-ui/recruit-workflows

Props

CandidateCoverHeader

PropTypeWhat it does
coverReactNodeHost-owned media for the 4:1 frame. `null` draws no cover, whatever `coverFallback` says.
coverFallbackCandidateCoverFallbackWhat stands in when `cover` is left out. `stock` draws the kit's `CoverBanner` in the frame: a banner in the theme's own colours, so someone with no cover is the same height as their neighbours. `none`, the default here, draws no frame; the cards and profiles that always show a cover pass `stock`. A stock cover isn't printed: it sits in a `data-slot="candidate-cover-stock"` wrapper that paper leaves out.
coverSeedCandidateCoverSeedDeals the stock cover its design. Left out, everyone gets the first.
coverSizeCandidateCoverImageSizeThe cover's size; the default keeps its full 4:1 ratio.
childrenrequiredReactNode
paddingCandidateCoverHeaderPaddingSpace around the identity. `none` sits it flush in a container the host pads; with no cover the header then doesn't clip, so a focus ring at its edge stays whole. `dialog` pads it like the kit's dialog header (16px), so as a CandidateProfileDialog's `header` it starts at the body's left edge.
softenCoverUntilHoverboolean

CandidateCoverImage

PropTypeWhat it does
childrenReactNodeCaller-owned media. The host owns source resolution and alt text.
sizeCandidateCoverImageSize`compact` keeps the 4:1 ratio until the frame reaches 96px high.
softenUntilHoverboolean

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.