A button with its shortcut drawn as keycaps that sink as the real keys go down.
FreeWeb and MobileMotion
Preview
npx shadcn add @fetaui/command-buttonPlayground
Mac and Windows
Shortcut
Disabled
OS
Icons animation
Motion
Installation
Terminal· bash
npx shadcn add @fetaui/command-button
Shortcut
shortcutKey sets the letter. The shortcut works anywhere on the page and clicks the button.
Motion
Accessibility
- A native button with aria-keyshortcuts.
- The keycaps are hidden from screen readers.
Motion
- Keycaps sink 2 px in 75 ms and return in 150 ms.
- With reduced motion, the press scale is off and color changes stay. Keycaps stay put.
Responsive behavior
- Keycaps drop on touch screens.
Performance
- Each instance adds keydown, keyup and blur listeners to window. They are removed on unmount and while disabled.
- State changes only when the modifier or letter goes down or up, so typing elsewhere does not re-render it.
- Keycaps sink with a CSS transition.
Note for AI
Give your coding assistant the Markdown reference instead of screenshots.
- Import from @/components/fetaui/command-button. Run your action in onClick: the shortcut clicks the button.
- shortcutKey sets the letter, default k. The modifier is ⌘ on Mac and Ctrl elsewhere.
- The listener is global and calls preventDefault, so use one button per shortcut on a page.
- Leave os out in production. It is detected in an effect, so the first render shows Mac.
- Demo clicks do nothing. Wire up onClick.
Related
SearchComponentA search field and a command palette for finding anything and running commands.CommandComponentA keyboard first menu for every action in the product, with fuzzy search, submenus and inline confirmation.KbdComponentA keycap for showing keyboard input. One key per cap, grouped as a combo, chord or sequence.ButtonComponentOne family for every action, with a label, optional icons and a shortcut key.ToolbarComponentA floating tool dock for canvas apps. It holds the current tool on an ink plate and redocks to any edge.