Updating

Installed components are source files you own, so nothing updates behind your back. When you want a newer version, re-run the install with --overwrite.

Check what changed

Every component has a version (shown on its page and at the top of its file) and a changelog. The whole library’s changes are also machine-readable at /r/changelog.json, newest first.

Patch or minor (1.1.0 → 1.2.0): safe to update; props keep working.
Major (1.x → 2.0): a prop changed. The changelog entry says what to change.

Update a component

Free component, Base UI project

npx shadcn@latest add https://beautiful-ui.dev/r/lumen-button.json --overwrite

Free component, Radix project

npx shadcn@latest add https://beautiful-ui.dev/r/radix-nova/lumen-button.json --overwrite

Pro component (your style picks the build)

npx shadcn@latest add @beautiful-ui-pro/lumen-flow-funnel --overwrite

This replaces the component files and the shared files they need, and writes the item's CSS into your global stylesheet again (keep your own overrides in separate rules). Older glass-* items also refresh the .AI.md guide installed next to them. If you edited the component, review the diff before committing: your changes are in git, so nothing is lost.

Your AI can do it too

.beautiful-ui/AGENTS.md (added with npx shadcn@latest add https://beautiful-ui.dev/r/beautiful-ui-ai.json) tells agents how to update. Ask: “Update the Beautiful UI components, check the changelog for breaking changes first.”

After a subscription ends

Everything you installed keeps working forever; nothing phones home. You only need an active plan to pull new items or updates for Pro components. See Pro setup.