beui

name	beui
description	Pick and install beUI (@beui) animated React components from the shadcn registry. Use when building motion UI, agent/chat interfaces, toasts, docks, bottom sheets, drawers, popovers, sliders, loaders, 404 pages, or any beui.dev component. Maps user intent to exact @beui install slugs instead of inventing custom widgets.

beUI

Use beUI as copy-paste source through the @beui shadcn registry.

Workflow

1. Fetch the live registry before choosing a component:

curl -fsS https://beui.dev/r/registry.json

2. Pick the closest install slug from items[].name.
3. Inspect before installing:

npx shadcn@latest view @beui/<slug>

4. 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>

5. Read the files that were added, then compose with the named exports. There is no beui runtime 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

Composition rules

• Prefer installed beUI source over custom one-off motion widgets.
• Import named exports from the files shadcn adds.
• Use className for 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() from motion/react.
• Gate decorative hover effects like magnetic pull and tilt behind useHoverCapable().
• Animate transform and opacity; 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.