# Mosaic > Clerk’s next-generation component library: components, primitives and hooks. Install with `pnpm add @clerk/mosaic`. Each page below documents one component, primitive or hook: what to use it for, its practices, its API and examples. ## Components - [ActionBar](/docs/components/action-bar.md): A floating `role="toolbar"` of bulk actions that rests on the bottom edge of a table while rows are selected. Portals, follows its anchor, moves focus between actions with the arrow keys and announces the selection in a live region. - [ActionMenu](/docs/components/action-menu.md): A row's "more actions" menu built from a list of actions: an icon trigger that opens a `Menu` with one item per action. An action with a `status` keeps the menu open and shows a spinner while pending, then closes it. - [Avatar](/docs/components/avatar.md): Represents a user or entity as an image, with a blank placeholder while the image is missing or fails to load. - [Badge](/docs/components/badge.md): A small label that marks nearby content with a status or category. Renders a `span`, or the `render` element, and forwards its ref. - [Banner](/docs/components/banner.md): A tinted strip with a status message inside content: info, warning, error or success. `Banner.Root` draws the icon for its `color`. - [Branding](/docs/components/branding.md): The "Secured by Clerk" mark, with the Clerk logo linking to clerk.com in a new tab. Takes no children. - [Button](/docs/components/button.md): A clickable action. `color`, `variant` and `size` are independent axes, with `shape` and `fullWidth` as modifiers. - [Card](/docs/components/card.md): The surface a flow renders on: header, message slot, content and footer, signed with "Secured by Clerk". Rendered as the content of a `Dialog.Popup`, the title and description name the dialog and the header carries its close button. - [Checkbox](/docs/components/checkbox.md): A native `input type="checkbox"` with a styled indicator for checked and indeterminate. Inside a `Field` it takes the field's id, `disabled`, `required` and ARIA wiring. - [ClerkLogo](/docs/components/clerk-logo.md): The Clerk wordmark as an inline `svg` in `currentColor`, with `role="img"` and the accessible name "Clerk". Takes any `svg` prop. - [Combobox](/docs/components/combobox.md): A styled single-select input that searches its options as the user types. Wraps the headless `Combobox` primitive; the popup portals and positions itself. - [CopyButton](/docs/components/copy-button.md): An icon `Button` that copies `value` to the clipboard and confirms with a short "Copied" toast beside it. Takes every `Button` prop but `children`. - [DataList](/docs/components/data-list.md): Label and value pairs for read-only detail, as a `dl` of `dt` and `dd`, so assistive technology reads each value with its label. - [Dialog](/docs/components/dialog.md): A modal surface over the page. The popup holds a `Card` or a `Profile`, and owns focus, scroll lock and the backdrop. - [Drawer](/docs/components/drawer.md): A bottom sheet that rises from the bottom of the screen, with a scrim and a grip. Drag it down, press Escape or press outside to dismiss. Wraps the headless `Drawer` primitive. - [EmptyState](/docs/components/empty-state.md): The placeholder a list or table shows when it has nothing in it: an icon, a label, a description and actions. - [Entity](/docs/components/entity.md): A media-and-text row for one user, organization or other thing: an avatar or icon beside a label and a one-line description. - [Field](/docs/components/field.md): Wraps one form control with its label, description and feedback, and wires them together: the control takes the field's id, `disabled`, `required`, `aria-invalid`, `aria-labelledby` and `aria-describedby`. - [Flow](/docs/components/flow.md): One screen replacing another on the same card or dialog. The surface stays put, its height animates, and the outgoing step stays mounted, inert, until its exit finishes. Wraps the headless `Flow` primitive. - [Heading](/docs/components/heading.md): A themeable heading with `size` and `color` from the typography scale. Renders an `h2` unless `level` says otherwise. `HeadingLevelProvider` sets the level for headings nested below it. - [Icon](/docs/components/icon.md): Renders a Mosaic glyph, hidden from assistive tech. A glyph can be swapped by name through the `icons` prop on `MosaicProvider`, and the override gets the same sizing. `IconFrame` is a square box that frames an icon or image. - [Input](/docs/components/input.md): A single-line text input. Inside a `Field` it takes its id, label, description, disabled, required and invalid state from the field. Inside an `InputGroup` it drops its chrome and takes the group size. - [InputGroup](/docs/components/input-group.md): Draws one field chrome around an `Input` and addons on either side, such as an icon, a prefix or a button. A click on a bare part of the group focuses the input. - [Item](/docs/components/item.md): A bordered row for lists of accounts, organizations and settings: media, a label and description, and trailing actions. Every part takes `render` and forwards its ref. - [Link](/docs/components/link.md): An inline text link, underlined on hover. With `target='_blank'` it appends an external-link icon. - [Menu](/docs/components/menu.md): A dropdown of actions opened from a trigger. Handles focus, arrow keys and typeahead, and closes when an item is clicked. - [Otp](/docs/components/otp.md): A fixed-length verification code field: one box per character. Focus moves on as the user types, and a pasted code fills every box. The ref points at the first box. - [Pagination](/docs/components/pagination.md): Page controls for a paged list: the item range, an optional results-per-page select, first, previous, next and last buttons, and the page over the total. Pages start at 1. - [Panel](/docs/components/panel.md): A page of content with a title and its sections. `Panel.Sections` sit one heading level below `Panel.Title`. `usePanelTitle` returns a getter for the title element, to move focus to it. - [PasswordInput](/docs/components/password-input.md): A password input with a trailing button that shows or hides what was typed. The ref, `Field` wiring and input attributes such as `autoComplete` go to the input. - [PhoneInput](/docs/components/phone-input.md): A phone number input with a searchable country picker. Formats the national number as the user types and reports the value in E.164, such as `+14155550123`. Typing a number that starts with `+` picks the country from it. - [Popover](/docs/components/popover.md): A floating box anchored to a trigger, for content that is not a list of actions. The popup paints no surface of its own. - [Profile](/docs/components/profile.md): A surface you navigate: a column of pages beside the page each one opens, as tabs. When narrow, the nav becomes a select on the page title, then a sheet on a phone. Inside a `Dialog` it adds the close control. - [ProviderButton](/docs/components/provider-button.md): A full-width outline button that starts sign-in with a third-party provider. While pending, a spinner replaces the icon and the labels stay put. `ProviderButtonGroup` lays several out and picks which label each shows. - [Radio](/docs/components/radio.md): A set of choices where one is picked. `Radio.Group` holds the value, typed from what you pass. Each choice is a bare `Radio.Item`, or a `Radio.Card` laid out as an `Item` row with media, a label and a description. - [Reveal](/docs/components/reveal.md): Shows and hides its children by animating their height open and closed. The children mount when it opens and unmount once the close ends; while closing they are frozen and inert. No animation under reduced motion. - [ScrollArea](/docs/components/scroll-area.md): StyleX styles for a scroll surface, spread onto an element you already render. There is no component. The viewport fades its edges while there is more to scroll, styles a thin scrollbar under a fine pointer, and contains overscroll. `scrollAreaVars` exposes the per-element `--cl-scroll-area-progress-start` and `-end` values, which are read, never set. - [Section](/docs/components/section.md): A compound layout for a topic of settings. `Section.Root` stacks groups; each `Section.Group` is named by the `Section.Title` in its `Section.Header`, above a `Section.Body` card holding `Section.Row`s (one setting each) or a `Section.Items` list of values. Each `Section.Group` is a `cl-section` size container that switches to a compact layout below 26rem; `sectionCompactStyles.hidden` and `.only` show or hide content inside a group at that width. - [SegmentedControl](/docs/components/segmented-control.md): A row of mutually exclusive options with a sliding indicator under the selected one. A `role='radiogroup'` with one tab stop; the arrow keys move and select at once. - [Select](/docs/components/select.md): A dropdown that picks one value, or several with `multiple`, from a list of `items`. Keyboard navigation and typeahead; values can be any type and compare with `Object.is`. Inside a `Field` the trigger takes the field id, label, disabled, required, invalid and message wiring. Each part is also exported on its own, such as `SelectTrigger`. - [Separator](/docs/components/separator.md): A horizontal rule between blocks of content, as `role="separator"`. Without children it is a 1px line; with children it is a labelled divider with a line on each side. Carries `data-labelled` when labelled. - [Skeleton](/docs/components/skeleton.md): A placeholder for content that is still loading. Wraps the content it stands in for: text becomes a cap-height bar as wide as the text, and an element becomes a block its size, hidden underneath. `aria-hidden`. - [Spinner](/docs/components/spinner.md): Indeterminate loading spinner, sized to match an `Icon`. Decorative (`aria-hidden`) by default; with `label` it is a `progressbar` named by the label. - [Stepper](/docs/components/stepper.md): Shows how far the user is through a fixed number of steps: a label, the current step over the total, and one segment per step. Steps are 1-based; `value` and `max` floor to whole numbers of at least 1, and `value` clamps to `max`. - [Switch](/docs/components/switch.md): An on/off toggle: a native checkbox `input` with `role='switch'`, styled as a track and thumb (`cl-switch-thumb`). The ref and other props go to the input (`cl-switch-input`). Inside a `Field` it takes the field id, label, disabled, required, invalid and message wiring. - [Table](/docs/components/table.md): A styled native `table` with optional row actions, selection, sorting and expandable tree rows, over the headless `Table` primitive. `Table.Root` owns the selection, expanded and sort state, and scrolls sideways when wider than its container. With actions, selection, sorting or tree rows it becomes a `grid` or `treegrid` with one tab stop and arrow-key navigation. - [Tabs](/docs/components/tabs.md): Horizontal tabs that switch between panels, with a sliding indicator under the selected tab. The arrow keys move between tabs. A hidden panel unmounts its children once its exit animation ends. - [TagInput](/docs/components/tag-input.md): A field that turns typed and pasted entries into removable tags. A delimiter, Enter or blur commits the draft; entries are trimmed and duplicates dropped. Backspace or the reading-direction arrow at the start of the input moves to the last tag, and Backspace or Delete on a tag removes it. The ref and other props go to the text input (`cl-tag-input-input`). Inside a `Field` it takes the field id, label, disabled, required, invalid and message wiring. - [Text](/docs/components/text.md): Themeable body copy with `size` and `color` variants. Renders a `p`, or the `render` element. Defaults can come from `TextContext`. - [Tooltip](/docs/components/tooltip.md): A short label that shows on hover or focus of its trigger, and closes on Escape. Styled over the headless `Tooltip` primitive; the popup portals and positions itself. - [VisuallyHidden](/docs/components/visually-hidden.md): Content exposed to assistive technology but not painted. ## Primitives - [Accordion](/docs/primitives/accordion.md): Headless, unstyled stack of collapsible sections, with one or many open at once. Wires `aria-expanded`, `aria-controls` and `role="region"`, and moves focus between triggers with the arrow keys. - [Autocomplete](/docs/primitives/autocomplete.md): Headless, unstyled text input with a list of suggestions the caller filters. Focus stays on the input while the arrow keys move a virtual highlight through the options via `aria-activedescendant`. Selecting an option sets the input text to its label and closes the list. - [Button](/docs/primitives/button.md): Headless, unstyled button that can stay focusable while disabled, and gives button semantics to an element that is not a `