# Zubra UI > Copy-in web components for any project (plain HTML, React, Vue, Svelte, Angular). Install one with the shadcn CLI; they're themed with shadcn/ui's CSS variables and share `@zubra/runtime` (at most 22.1 KB gzipped). Install: `npx shadcn@latest add https://zubra-js.github.io/zubra-ui/r/.json` writes `src/components/zubra/.js` and the theme. Import the file, then use the tag. Set arrays and objects as properties; listen for the events. ## Components - [accordion-panel](https://zubra-js.github.io/zubra-ui/components/accordion-panel/): A section that opens and closes, on the native
: the browser does the keyboard (Enter and Space on the heading), the find-in-page opening and the announcements. Panels with the same `group` form an accordion where one is open at a time (
). `open` is two-way. Properties: open, heading, group. Events: openchange. - [auto-grid](https://zubra-js.github.io/zubra-ui/components/auto-grid/): A grid with as many equal columns as fit, each at least `min` wide: four on a wide screen, one on a phone, with no media queries. Properties: min, gap. Events: none. - [chat-message](https://zubra-js.github.io/zubra-ui/components/chat-message/): One message: avatar, author, time, text (with @mentions and links picked out), the message it replies to, and reactions. `me` is the signed-in user's name: their messages, mentions of them and their reactions are marked. Properties: me, message. Events: reacttoggle, reply. - [choice-cards](https://zubra-js.github.io/zubra-ui/components/choice-cards/): Pick one of several cards: a radio group. A form control; arrow keys move the choice. Each item is `{ id, title, detail, price, note }` (`note` and `price` optional). Properties: value, items, required, disabled, label. Events: valuechange. - [cluster-layout](https://zubra-js.github.io/zubra-ui/components/cluster-layout/): Children in a row that wraps onto more lines when there isn't room: buttons, tags, footer links. `justify` and `align` line them up. Properties: gap, justify, align. Events: none. - [color-swatches](https://zubra-js.github.io/zubra-ui/components/color-swatches/): Pick a colour from `colors`. A form control (a radio group): arrow keys move the choice. `names` are what each colour is called, in the same order ("Barn red"), for screen readers and the tooltip; a colour without one is announced by its value. Properties: value, colors, names, disabled, label. Events: valuechange. - [combo-box](https://zubra-js.github.io/zubra-ui/components/combo-box/): A combobox: type to filter, arrow keys to move, Enter to pick, Escape to close. A form control. `items` is `[{ value, label }]`; `value` is two-way. Properties: value, label, placeholder, items, disabled. Events: valuechange. - [dashboard-shell](https://zubra-js.github.io/zubra-ui/components/dashboard-shell/): An app's frame: a sidebar of sections, a top bar with the page title and a user menu, and the page in the middle. In a narrow space it folds the sidebar behind a Menu button, measuring itself rather than the screen. Properties: product, heading, nav, current, menu, user. Events: currentchange, menuselect. - [date-range](https://zubra-js.github.io/zubra-ui/components/date-range/): A check-in and check-out date, as one value `{ start, end }` ("YYYY-MM-DD" strings). A form control: invalid until both are set and `end` is after `start`. Properties: value, min, disabled. Events: valuechange. - [donut-chart](https://zubra-js.github.io/zubra-ui/components/donut-chart/): A donut chart of `segments` (`[{ label, value, tone }]`, `tone` 0–7), with the total in the middle and a legend. Choosing a segment (or its legend entry) selects it; again clears it. Properties: segments, value, label. Events: valuechange. - [dropdown-menu](https://zubra-js.github.io/zubra-ui/components/dropdown-menu/): A menu of actions behind a button, on the platform's `popover`: the browser puts it in the top layer and closes it on Escape or a click outside. Down or Up on the button opens it; arrow keys, Home, End and typing a letter move among the items; Enter or Space picks one, and focus goes back to the button. It's placed below the button by CSS anchor positioning, or by script where that isn't supported. `items` is `[{ value, label, disabled? }]`. Properties: label, items. Events: itemselect. - [flip-card](https://zubra-js.github.io/zubra-ui/components/flip-card/): A card with two faces that flips in 3D. Click, Space or Enter flips it. Shadow DOM: the faces are slotted, and the page's CSS styles them, not the card's. Properties: flipped, hint. Events: flippedchange. - [image-gallery](https://zubra-js.github.io/zubra-ui/components/image-gallery/): A photo gallery: a masonry grid in reading order and a lightbox with previous and next (arrow keys too). Photos come from `items`, or from `src`, a gallery.json that `npx zubra-imager ` writes (sizes in AVIF, WebP and JPEG, alt text, placeholders). `index` is the open photo (-1 when closed) and is two-way. Properties: items, src, index, label. Events: indexchange. - [kanban-column](https://zubra-js.github.io/zubra-ui/components/kanban-column/): A board column: a heading with a count and an optional work-in-progress limit, its cards (the default slot) and a drop zone for cards dragged from anywhere on the board. Properties: heading, count, limit. Events: carddrop. - [line-chart](https://zubra-js.github.io/zubra-ui/components/line-chart/): A price chart: an area under a line, with the high, low and a crosshair that follows the pointer and shows the value under it. Properties: points, label. Events: pointhover. - [masonry-grid](https://zubra-js.github.io/zubra-ui/components/masonry-grid/): A masonry layout for any items of different heights (cards, notes, photos): packed into columns as wide as `column` allows, while the order stays the reading order, so Tab, screen readers and search see the items left to right, top to bottom, as written. Browsers with native masonry (CSS grid lanes) lay it out themselves; the others get a small script that measures each item. Properties: column, gap. Events: none. - [message-composer](https://zubra-js.github.io/zubra-ui/components/message-composer/): Writing a message: Enter sends, Shift+Enter adds a line, the box grows with the text, an emoji menu inserts at the caret, and a message being replied to shows above. Properties: placeholder, disabled, replyto. Events: typing, send, replycancel. - [modal-dialog](https://zubra-js.github.io/zubra-ui/components/modal-dialog/): A modal dialog on the native : the page behind is inert, focus moves into the dialog and back to where it was, and Escape, the close button or a click on the backdrop closes it. `open` is two-way. Properties: open, label. Events: openchange. - [money-input](https://zubra-js.github.io/zubra-ui/components/money-input/): An amount of money. Typing is free-form; on blur it's formatted (`1234.5` → `1,234.50`). The value is a number (or null when empty). A form control: `required` and `min` validate it. Properties: value, symbol, required, min, disabled, label. Events: valuechange. - [pricing-block](https://zubra-js.github.io/zubra-ui/components/pricing-block/): Pricing plans side by side, with a monthly or yearly switch, a featured plan, and what each includes. Choosing a plan fires `choose` with the plan and period. Properties: plans, period, currency, locale, heading, intro. Events: periodchange, choose. - [progress-ring](https://zubra-js.github.io/zubra-ui/components/progress-ring/): A ring that fills to `value` of `max`, with what's in the middle from the default slot (the percentage if empty). Properties: value, max, label. Events: none. - [quantity-stepper](https://zubra-js.github.io/zubra-ui/components/quantity-stepper/): A number with − and + buttons, between `min` and `max`. A form control. `editable` lets the number be typed as well (a stock count of 40 shouldn't take forty presses); what's typed is clamped to `min`..`max` when the field is left. Properties: value, min, max, label, editable, disabled. Events: valuechange. - [segmented-control](https://zubra-js.github.io/zubra-ui/components/segmented-control/): A row of mutually exclusive options. `options` is `[{ value, label }]`. Properties: value, options, label, disabled. Events: valuechange. - [settings-block](https://zubra-js.github.io/zubra-ui/components/settings-block/): An account settings page: profile, notification switches, light or dark appearance, and a delete that asks first. `value` holds it all and is two-way; Save fires `save`. Properties: value, notifications, heading, busy, status. Events: valuechange, save, delete. - [sidebar-layout](https://zubra-js.github.io/zubra-ui/components/sidebar-layout/): A sidebar beside the main content that moves above it when the content would get too narrow (`content-min`), with no media queries, so it works in any container. Properties: side, contentMin, gap, end. Events: none. - [signin-block](https://zubra-js.github.io/zubra-ui/components/signin-block/): A sign-in form: email, password with show and hide, keep me signed in, reset and sign-up links, and an error that's announced. Submitting fires `signin`; with an `action` it also posts as a plain form. Properties: heading, intro, action, error, errorField, busy, forgotHref, signupHref. Events: signin. - [spark-line](https://zubra-js.github.io/zubra-ui/components/spark-line/): A small line of recent values, green when it ends higher than it started, red when lower. Properties: points, label. Events: none. - [stack-layout](https://zubra-js.github.io/zubra-ui/components/stack-layout/): Children one above the other with the same `gap` between them: the vertical rhythm of a page, a form or a card. Properties: gap. Events: none. - [star-rating](https://zubra-js.github.io/zubra-ui/components/star-rating/): A star rating that is a form control: it submits its value under its `name`, is invalid while `required` and unset, and goes back to 0 when its form resets. `readonly` shows a rating. Properties: value, max, required, readonly, disabled, label. Events: valuechange. - [step-indicator](https://zubra-js.github.io/zubra-ui/components/step-indicator/): Where a multi-step flow is: steps done (which can be revisited), the current one, and those ahead. `readonly` shows where something is without offering to go back (an order's status): plain list items, not buttons. `current` past the last step shows every step done. Properties: steps, current, readonly. Events: stepselect. - [streak-grid](https://zubra-js.github.io/zubra-ui/components/streak-grid/): A habit's last weeks as a grid of days (a column per week, Monday at the top), shaded by how much of the goal was done. Choosing a day toggles it; arrow keys move between days. `log` maps "YYYY-MM-DD" to a count; `today` is "YYYY-MM-DD". Properties: log, goal, today, weeks, label. Events: daytoggle. - [tab-list](https://zubra-js.github.io/zubra-ui/components/tab-list/): Tabs: a tab list and the panels it switches between. The panels are the slotted elements with a `data-tab` attribute matching a tab's value; they get role=tabpanel, are labelled by their tab, and are hidden unless chosen. Arrow keys, Home and End move between the tabs (one tab stop), and the focused tab is chosen as it moves, unless `manual`, where Enter or Space chooses it. `tabs` is `[{ value, label }]`; `value` is two-way and defaults to the first tab. Properties: value, tabs, label, manual. Events: valuechange. - [tag-input](https://zubra-js.github.io/zubra-ui/components/tag-input/): A list of tags you type: Enter or comma adds one, Backspace in the empty field removes the last, × removes any. Suggestions come from `suggestions`. A form control. Properties: value, suggestions, max, disabled, label. Events: valuechange. - [toggle-switch](https://zubra-js.github.io/zubra-ui/components/toggle-switch/): An on/off switch with a label and a description. A form control (submits "on" when checked), switched off by `disabled` or a disabled fieldset. Properties: checked, disabled, label, description, extra. Events: checkedchange. - [tool-tip](https://zubra-js.github.io/zubra-ui/components/tool-tip/): A short description shown when its trigger is hovered or focused: the trigger is the slotted element, and the tip describes it (aria-describedby), so a screen reader reads it with the trigger's name. It shows after `delay` milliseconds, stays while the pointer is over it, and Escape hides it without moving focus (WCAG 1.4.13). It sits in the top layer (`popover`), placed above the trigger by CSS anchor positioning, or by script where that isn't supported. Properties: text, delay. Events: none. - [action-button](https://zubra-js.github.io/zubra-ui/components/action-button/): A button in six variants and three sizes, on a native