KQ-115 · CARD/FAN
Card Fan
A hand of cards that fans open around a shared pivot — sweep to raise one, siblings part around it, and picking flies the card to a played slot where it lands on the recoil spring.
KQ-115 · CARD/FAN
Protocol Hand · 5 CardsKQ-115
Active Protocol
Active · STANDBY
KQ-115 · Card Fan · Arc 36° · P 800 · ζ 0.98
Open the hand, sweep, and play a card - Escape folds it.
Install
One command — the source lands in your repo. Or copy it from the Code tab.
$ pnpm dlx shadcn@latest add @kinetiq/card-fan
Props
- cards
- { id, label, content }[]
- default —
- Up to seven cards in the hand.
- value / defaultValue / onSelect
- string | null / same / (id) => void
- default —
- Controlled or uncontrolled played card.
- open / defaultOpen / onOpenChange
- boolean / boolean / (open) => void
- default —
- Controlled or uncontrolled fan state.
- cardWidth
- number
- default 120
- Card width in px; height is 1.45×.
| Prop | Type | Default | Description |
|---|---|---|---|
| cards | { id, label, content }[] | — | Up to seven cards in the hand. |
| value / defaultValue / onSelect | string | null / same / (id) => void | — | Controlled or uncontrolled played card. |
| open / defaultOpen / onOpenChange | boolean / boolean / (open) => void | — | Controlled or uncontrolled fan state. |
| cardWidth | number | 120 | Card width in px; height is 1.45×. |