Reference

Components

Every installable 4AF component, generated directly from the registry.

The catalog contains 47 installable components, generated from registry.json, the file the published registry is built from.

Shared foundation items such as the theme, cn, slot, motion presets, and use-action are installed as dependencies and aren't listed here.

Actions

Install nameMain APIWhat it provides
buttonButtonSix variants, eight sizes, optical icon alignment, and a loading state that doesn't resize.
button-groupButtonGroupTwo or more Buttons joined into one control: flattened inner corners, one hairline per seam, horizontal or vertical.
toggleToggleA button with a persistent pressed state and optional icon fill.
morphMorphAnimated content swap — icons or text. Copy to check, Follow to Following.
action-buttonActionButtonRuns an async action, shows pending/success/error, and reverts without resizing; pending can keep its label or show a centered loader only.
action-toggleActionToggleA toggle that changes state after its action succeeds and preserves its previous state on failure.
copy-buttonCopyButtonCopies to the clipboard and confirms it — visually, and to screen readers.
delete-buttonDeleteButtonA destructive button that arms on the first press and confirms on the second, with Escape, blur, and timeout exits.

Fields and selection

Install nameMain APIWhat it provides
inputInputA Base UI input with token-based surfaces, focus states, an optional leading icon, custom number steppers, and default, plain, and underline variants.
textareaTextareaA multiline text field with neutral or accent focus styling and an optional resize handle.
switchSwitchA switch that slides and grows a rounded center pill toward the track center when pressed. Adaptive or fixed thumb tone.
checkboxCheckboxA checkbox whose tick draws itself in. Presses on click, not on hover.
radioRadioGroup, RadioA radio group — the Checkbox's sibling, a single choice with a dot that scales in.
sliderSliderA slider whose thumb springs between steps and grabs while held, with optional range mode, ticks, labels, and a live value tooltip. Base UI behaviour.
selectSelect, SelectTrigger, SelectContent, SelectItem, SelectSortTrigger, submenu partsSingle or multiple selection with optional search, nested options, and footer actions.
select-searchSearchSelect and input/content/item partsA searchable single or multi-select on Base UI's Combobox — type to filter the list, with full keyboard and ARIA support. Multi-select keeps its animated checkbox list open while choices are toggled.
select-alignedAlignedSelect, AlignedSelectTrigger, AlignedSelectContent, AlignedSelectItemA single-select menu that aligns the selected option with its trigger when space and input method allow.
date-pickerDatePicker, DateRangePicker, CalendarDate and date-range fields with a desktop popover, mobile sheet, and standalone Calendar.

Feedback and status

Install nameMain APIWhat it provides
progressProgress, ProgressLabel, ProgressValueA determinate progress bar. Base UI Progress behaviour; the fill slides on transform (translateX), never width, so it stays off the layout path.
alertAlertAn inline status line — a glyph plus a sentence, no surface. Destructive error (role=alert), amber warning, green success, neutral info, and a muted loading line with AsciiLoader by default.
badgeBadge, BadgeIconsProviderA status badge with animated content changes, optional icons or dots, and plain, solid, or outline styles.
skeletonSkeletonA muted placeholder with square corners by default, shaped by utility classes. Pulses while content loads; reduced motion disables the pulse.
emptyEmpty and composition partsAn empty state — a centred column of media, title, description and an action. Composable parts; borderless by default with an optional dashed placeholder outline.
text-shimmerTextShimmerText with a highlight sweeping across it — a looping working-in-progress affordance. Gradient clipped to the glyphs, switched off (not sped up) under reduced motion.
scramble-textScrambleTextA short random-character reveal for text that is appearing or changing, with whitespace preservation and reduced-motion support.
ascii-loaderAsciiLoaderA looping braille spinner for compact async status affordances.
matrix-loaderMatrixLoaderA 4×4 matrix dot loader with scan, twinkle, and size variants.
classic-loaderClassicLoaderTwelve fading radial bars adapted from loading.dev, with CSS-only motion, size variants, and speed control.

Navigation and layout

Install nameMain APIWhat it provides
breadcrumbBreadcrumb, BreadcrumbList, item/link/page/separator parts, BreadcrumbEllipsis, BreadcrumbCollapseA breadcrumb trail with links, separators, and expandable middle items.
tabsTabs, TabsList, TabsTab, TabsCount, TabsPanelSegment, pill, or underline tabs with an animated indicator, optional counts, and horizontal scrolling.
collapsibleCollapsible, CollapsibleTrigger, CollapsibleContentA disclosure row built on Base UI Collapsible: the chevron rotates, the space slides open so the rows below travel rather than jump, and the content fades in out of a blur where it lands.
tableTable, TableCaption, TableHeader, TableBody, TableFooter, TableRow, TableHead, TableCellA presentational semantic table with a composable caption, two densities, optional grid lines, a pinned header, and a loading skeleton state. It has no controls and no state; install data-table for selection, sorting and row actions.
data-tableDataTable, DataTableRow, DataTableHead, DataTableRowActions, and the re-exported table layout partsA table with row selection, sort controls, bulk actions, and row menus. The caller orders the data.
table-of-contentsTableOfContentsA table of contents that tracks visible headings, keeps the last passed section active through long prose, and offers spanning or single-heading markers.
table-of-contents-linesTableOfContentsLinesA line-based table of contents where each heading has a longer rule and two shorter content rules, with a highlighted, expanding hover treatment.
separatorSeparatorAn accessible horizontal or vertical divider built on Base UI Separator.
command-paletteCommandPalette, panel/list/row/tab/footer parts, Kbd, useCommandSearch, useCommandPanelHighlightA keyboard-first command and search palette with nested panels, custom panel content, fuzzy filtering, async/server-driven and paginated search, keybind hints, panel tab bars with Tab/Shift+Tab switching, and Base UI dialog/autocomplete behavior.
sidebarSidebarProvider, Sidebar, SidebarPanel, SidebarHeaderButton, menu/group/submenu partsA collapsible application sidebar with default, floating, inset, and split layouts, animated split-rail icon tooltips, collapsible rows with built-in chevrons, nested rows, actions, badges, and loading skeletons.
sidebar-layoutSidebarLayoutAn optional viewport shell that composes Sidebar with a contained, independently scrolling inset surface, page title header, header actions, and a left-aligned collapse trigger before the title.

Overlays and menus

Install nameMain APIWhat it provides
tooltipTooltipProvider, TooltipBase UI positioning and timing with a CSS scale-and-blur enter. Opens on hover and focus, flips at the viewport edge.
sheetSheet and composition partsA dialog that slides in from an edge. Base UI Dialog behaviour, Motion enter/exit.
dialogDialog and composition parts, DialogSteps, DialogStepA modal centred over the page. Base UI Dialog behaviour; scales in from a blur and fades out with Motion.
alert-dialogAlertDialog and composition partsA confirmation dialog that blocks backdrop dismissal. Escape and close controls dismiss it.
popoverPopover and composition partsAn interactive panel anchored to a trigger. Base UI Popover behaviour with a CSS scale-and-blur enter from the trigger edge.
selection-toolbarSelectionToolbar, item parts, useSelectionToolbarA floating toolbar for selected text, with action buttons, async actions, and toggles.
hover-cardHoverCard, HoverCardTrigger, HoverCardContent, HoverCardSkeletonA rich preview of what is behind a link, on hover and focus. Base UI PreviewCard behaviour with a CSS scale-and-blur enter from the trigger edge, plus a built-in loading skeleton.
dropdown-menuDropdownMenu, DropdownMenuTrigger, DropdownMenuContent, DropdownMenuItem, DropdownMenuSelect, checkbox/radio/submenu partsA dropdown menu on Base UI Menu (keyboard nav, submenus, checkbox/radio items, searchable selection panels, and immediate disabled-reason tooltips). Instant row highlight; CSS scale-and-blur panel enter.