# Kbd

The printed key. Any action used more than twice per session shows its key on the control. Renders ⌘ vs Ctrl by platform.

Install: `npx candlelight-ds add kbd`

Category: primitive · Grammar: G2

## Use when

A control has a keyboard binding.

## Don't use when

Explaining a concept — that's Tooltip's job.

## States

- default
- brass
- onBrass
- xs
- sm

## Keyboard

- (none — pointer/semantic only)

## Acceptance tests

- Never render a Kbd for a binding that doesn't fire (honest printed keys).
- 'mod' renders ⌘ on Apple platforms, Ctrl elsewhere.

## Files

- components/ui/Kbd.tsx

npm dependencies: @candlelight-ds/tokens, clsx, tailwind-merge

Rendered twin: https://candlelight-docs.vercel.app/components/kbd · Full spec: https://candlelight-docs.vercel.app/spec.md