Imported from starc007/ui-components (
skills/beui/SKILL.md) via skills.sh. Install upstream withnpx skills add starc007/ui-components --skill beui. Copyright stays with the author.
beUI
Use beUI as copy-paste source through the @beui shadcn registry.
Workflow
- Fetch the live registry before choosing a component:
curl -fsS https://beui.dev/r/registry.json- Pick the closest install slug from
items[].name. - Inspect before installing:
npx shadcn@latest view @beui/<slug>- Install with the user's package runner:
npx shadcn@latest add @beui/<slug>
# or
pnpm dlx shadcn@latest add @beui/<slug>
# or
bunx --bun shadcn@latest add @beui/<slug>- Read the files that were added, then compose with the named exports. There is no
beuiruntime package.
The live registry is the source of truth. Use the table below only to resolve common lookalikes.
Picker
| User asks for | Install @beui/... |
Avoid |
|---|---|---|
| Toast or snackbar | animated-toast-stack |
notification-stack |
| Expanding notification inbox | notification-stack |
animated-toast-stack |
| Mobile bottom sheet, Vaul-style panel | bottom-sheet |
drawer |
| Side panel or app drawer | drawer |
bottom-sheet |
| App chrome sidebar | animated-sidebar |
bounce-sidebar, ai-sidebar |
| AI files, folders, bookmarks | ai-sidebar |
animated-sidebar |
| Whole agent workspace | chat-app |
hand-rolled chat shell |
| Streaming thread that follows tokens | message-scroller, message |
custom scroll math |
| Just a chat bubble | message-bubble |
custom bubble |
| Prompt box or composer | prompt-input |
textarea plus custom buttons |
| Agent reasoning, search, tool trace | agent-activity |
plain log list |
| Task plan | todo-list |
custom checklist |
| Code surface | code-block |
pre/code from scratch |
| File diff | file-diff |
custom diff renderer |
| Tool output | tool-result |
raw terminal block |
| Tool permission card | tool-approval |
alert dialog |
| Approval or HITL question | approval-card |
custom form |
| Inline citations | citations |
plain numbered links |
| Generated image canvas | image-generation |
image card from scratch |
| Liquid popover | popover |
popover-morph |
| Corner morph popover | popover-morph |
popover |
| Dropdown select | select |
select-morph, combobox |
| Select that grows into panel | select-morph |
select |
| Searchable select | combobox |
select |
| Cmd+K palette | command-palette |
combobox |
| Right-click or long-press menu | context-menu |
bloom-menu |
| Button that blooms into a menu | bloom-menu |
context-menu |
| Press button | button-base |
custom motion.button |
| Loading/success/error button | button-stateful |
spinner button |
| Magnetic button | button-magnetic |
custom pointer tracking |
| Hold to confirm | hold-action-button |
button-base |
| Slide to confirm | slide-action-button |
swipeable-list |
| Hover CTA with expanding arrow | expanding-arrow-button |
button-base |
| Spinner, dots, bars loader | loader |
thinking-shimmer |
| Agent thinking status | thinking-shimmer |
loader, text-shimmer |
| Cycling reasoning phrases | reasoning-text |
text-cascade |
| Timed agent progress glyph | agent-progress |
loader |
| Shimmer headline text | text-shimmer |
thinking-shimmer |
| Word or letter reveal | text-reveal |
text-cascade |
| Chromatic cycling word | chromatic-text-reveal |
text-shimmer |
| Slot-machine letters | text-cascade |
text-scramble |
| Scramble resolving text | text-scramble |
text-cascade |
| Rolling digits | number-ticker |
animated-number |
| Count-up on view | animated-number |
number-ticker |
| Tick-dot slider | range-slider |
other range-slider-* |
| Inline label slider | range-slider-inline |
range-slider |
| Liquid fill slider | range-slider-fluid |
range-slider |
| Equalizer slider | range-slider-wave |
range-slider |
| Tilting value bubble slider | range-slider-bubble |
range-slider |
| Ruler slider | range-slider-ruler |
range-slider |
| iOS wheel picker | wheel-picker |
select |
| macOS dock | dock |
expandable-action-bar |
| Icon actions with labels | expandable-action-bar |
dock |
| Overflow action rail | overflow-actions |
expandable-action-bar |
| Icon tabs with active label | expandable-tabs |
tabs |
| Morphing tab content room | morphing-tabs |
tabs |
| Pill or underline tabs | tabs |
expandable-tabs |
| Hover gliding background | shared-layout-bg |
tabs |
| Preview ticks or rail | preview-rail |
bounce-sidebar |
| Dynamic Island | dynamic-island |
notification-stack |
| Swipe row actions | swipeable-list |
slide-action-button |
| Pull to refresh | pull-to-refresh |
custom touch math |
| Basic upload queue | file-upload |
attachment-upload |
| Mixed file, audio, image attachments | attachment-upload |
file-upload |
| OTP or PIN boxes | otp-input |
input |
| Sign-up form | signup-form |
manual form assembly |
| Theme wipe | theme-toggle |
class toggle only |
| Shader background | shader-background |
custom canvas |
| Cylinder carousel | cylinder-carousel |
marquee |
| Logo or text marquee | marquee |
cylinder-carousel |
| Data table | table |
HTML table from scratch |
| Activity heatmap, contribution graph | heat-calendar |
custom grid |
| Monthly returns grid | returns-calendar |
heat-calendar |
| Analyst price target chart, forecast fan | price-target-fan |
custom svg chart |
| Editable table | table-editable |
table |
| Async table | table-async |
table |
| Tournament bracket | knockout-bracket |
knockout-wheel |
| Radial tournament wheel | knockout-wheel |
knockout-bracket |
| 404 page | not-found-glitch |
custom 404 |
| Project folder card | project-folder |
folder card from scratch |
| Token or chain swap | swap |
custom swap form |
| Weekly availability editor | availability-scheduler |
custom calendar grid |
| Wallet overview card | wallet-card |
custom wallet card |
| Prediction market ticket | prediction-market |
custom trade ticket |
| Feedback popup | feedback-widget |
animated-toast-stack |
| Infinite masonry grid | infinite-masonry |
CSS columns |
| Accordion | bouncy-accordion |
custom accordion |
| 3D tilt card | tilt-card |
custom glare math |
| Tooltip | tooltip |
popover |
| Switch, checkbox, radio, input | switch, checkbox, radio, input |
restyled native controls |
Composition rules
- Prefer installed beUI source over custom one-off motion widgets.
- Import named exports from the files shadcn adds.
- Use
classNamefor layout and small styling changes. Do not fork internals unless the user asks. - Keep helpers installed by the registry, such as
@/lib/ease,@/lib/utils, and hooks. - If adding new motion around beUI components, use
useReducedMotion()frommotion/react. - Gate decorative hover effects like magnetic pull and tilt behind
useHoverCapable(). - Animate
transformandopacity; avoid layout-property animation.
In this repo
When contributing to beUI itself, follow AGENTS.md. A new public component needs source, preview, registry entry, and a passing bun run check:registry. Never rename existing /r/{name}.json slugs.
Chart components (heat-calendar, returns-calendar, price-target-fan) live under /charts in the docs. Their @beui install slugs are unchanged.
Compose charts from their root and exported parts. HeatCalendar provides HeatCalendarGrid, HeatCalendarLegend, and HeatCalendarTooltip; ReturnsCalendar provides ReturnsCalendarGrid and ReturnsCalendarTooltip. Put each calendar tooltip inside its grid. Both accept selection, defaultSelection, and onSelectionChange.
PriceTargetFan provides Header, Plot, Svg, Axes, History, Targets, Now, Cursor, and Tooltip parts (prefix each with PriceTargetFan). Put SVG parts inside Svg and put Tooltip beside Svg inside Plot. Pass current, targets, and an optional chronological history of { date: ISOString, price }; omitted history renders no historical series. Use active, defaultActive, and onActiveChange to control the readout. Each chart exports a use... hook for custom descendant content; tooltip children may be a render function. Sample data belongs in the consuming app, not the chart implementation. HeatCalendar.endDate uses the UTC calendar date.