# Still UI > Quiet, carefully built React components. Copy the source or install with the shadcn CLI. Every component lists the states it handles and respects reduced motion. ## Setup Still UI components are React 19 + Tailwind CSS v4 + motion (`motion/react`). Each one is a single file that you own after installing. They use shadcn's color tokens (`bg-background`, `text-foreground`, `bg-muted`, `bg-primary`, ...) and import one helper, `cn`, from `@/lib/utils`. 1. If the project has no shadcn setup yet, run `npx shadcn@latest init` (or the pnpm, yarn or bun equivalent below). 2. Once per project, add the registry to `components.json`: ```json { "registries": { "@stillui": "https://stillui.netlify.app/r/{name}.json" } } ``` 3. Add a component by name. Use the line for the project's package manager (look for `pnpm-lock.yaml`, `yarn.lock`, `bun.lock` or `package-lock.json`): - npm: `npx shadcn@latest add @stillui/` - pnpm: `pnpm dlx shadcn@latest add @stillui/` - yarn: `yarn dlx shadcn@latest add @stillui/` - bun: `bunx --bun shadcn@latest add @stillui/` The CLI writes the file to `components/ui/.tsx` and installs its npm dependencies. Import from there, e.g. `import { Button } from "@/components/ui/button"`. ## Paid components Components marked paid install from `@stillui-pro` instead. They need an account with access and its token (made on https://stillui.netlify.app/account): 1. Put the token in the project's `.env.local` as `STILLUI_TOKEN=...`. Never commit it. 2. Add the paid registry next to the free one in `components.json`: ```json "@stillui-pro": { "url": "https://stillui.netlify.app/r/pro/{name}.json", "headers": { "Authorization": "Bearer ${STILLUI_TOKEN}" } } ``` 3. Install with `npx shadcn@latest add @stillui-pro/` (same runners as above). A 401 means the token is missing or wrong; a 403 means the account's access has ended. Without shadcn: install `motion clsx tailwind-merge`, add the `cn` helper and the theme tokens from https://stillui.netlify.app/docs/installation, then copy a component's source from its registry JSON. ## Rules when writing code with these components - Keep the component file as installed; pass props instead of editing it, unless the user asks for a change. - Every component handles reduced motion, keyboard use and screen readers already. Don't wrap them in extra motion or ARIA. - Use the theme tokens for color. Don't hardcode hex values next to them. - Navigation components take `linkComponent` (pass Next.js `Link`) so routing stays client-side. ## Components Each link is the component's registry JSON, which holds its full source. Install with the name in backticks. ### Accordion Sections that open to show more. Separated by space, not lines, in five styles from quiet lists to frosted glass. Page: https://stillui.netlify.app/components/accordion - [Accordion: Surface](https://stillui.netlify.app/r/accordion.json): `@stillui/accordion`. Collapsible sections separated by space, not lines. The open section sits on its own surface. - [Accordion: Cards](https://stillui.netlify.app/r/accordion-cards.json): `@stillui/accordion-cards`. Each section is its own raised card. The open card grows on a weighted spring and its neighbours glide aside. - [Accordion: Plus](https://stillui.netlify.app/r/accordion-plus.json): `@stillui/accordion-plus`. Large titles with a plus that folds into a minus. While one answer is open, the other titles step back. - [Accordion: Icon rows](https://stillui.netlify.app/r/accordion-icons.json): `@stillui/accordion-icons`. Rows with an icon and a one-line summary, like a settings list. Several can be open, and content lines up under the text. - Accordion: Glass (paid): `@stillui-pro/accordion-glass`, needs an account token. One sheet of frosted glass. The open section lifts out as its own card, catches a passing light, and its answer comes into focus. ### Button Actions people press. The standard set, plus buttons that confirm on hold, report their own result, or reveal their label. Three show a download as it runs, and one splits like liquid into the actions it holds. Page: https://stillui.netlify.app/components/button - [Button: Standard](https://stillui.netlify.app/r/button.json): `@stillui/button`. Primary, secondary and tertiary actions with press feedback and a loading state that keeps its width. - [Button: Hold to confirm](https://stillui.netlify.app/r/button-hold.json): `@stillui/button-hold`. A destructive action that asks for a deliberate press-and-hold instead of a confirmation dialog. - [Button: Stateful](https://stillui.netlify.app/r/button-stateful.json): `@stillui/button-stateful`. Follows its own request: idle, loading, then success or error. The button reshapes around each label. - [Button: Expand](https://stillui.netlify.app/r/button-expand.json): `@stillui/button-expand`. A round icon button that reveals its label when you hover or focus it, so toolbars stay compact without guessing. - Button: Download (paid): `@stillui-pro/button-download`, needs an account token. Fills with light as the download runs, and buds off a cancel button that rejoins the pill when it’s done. - Button: Progress (paid): `@stillui-pro/button-progress`, needs an account token. A download button whose outline draws itself as the download runs, closing into a full ring when it’s done. - [Button: Icon](https://stillui.netlify.app/r/button-download-icon.json): `@stillui/button-download-icon`. An icon-only download button. The arrow and tray pull apart into a spinner, which turns into a check when it’s done. - Button: Liquid (paid): `@stillui-pro/button-liquid`, needs an account token. A round add button that splits like a drop of liquid into the actions it holds, and melts back together when closed. ### Destination Card A photo card for a trip. The flight sits over the photo, and the buttons at the bottom switch places: the photo blurs into the next one and the route draws itself again. Page: https://stillui.netlify.app/components/card-destination - [Destination Card](https://stillui.netlify.app/r/card-destination.json): `@stillui/card-destination`. A photo card for a trip. The flight sits over the photo, and the buttons at the bottom switch places: the photo blurs into the next one and the route draws itself again. ### Carousel Photos you drag, flick, sweep or arrow through: a row with depth, a fanned hand, a rising diagonal, a spiral, a column that warps at the edges, thumbnails over a full-bleed photo, and a pager that counts down in each photo's colour. Page: https://stillui.netlify.app/components/carousel - [Carousel: Depth](https://stillui.netlify.app/r/carousel.json): `@stillui/carousel`. Photos in a row. The one in focus stands tall in the middle while its neighbours turn away and bunch up toward the edges. - Carousel: Fan (paid): `@stillui-pro/carousel-fan`, needs an account token. Photos fanned out like a hand of cards. Each one leans with the arc, and the hand slides round as you move. - Carousel: Stairs (paid): `@stillui-pro/carousel-stairs`, needs an account token. Photos climbing a diagonal. The one in focus is largest, and the rest step down and away toward each corner. - Carousel: Spiral (paid): `@stillui-pro/carousel-spiral`, needs an account token. Photos winding into a spiral. The one in focus sits large in front; the rest curl away behind it, smaller with every turn. - Carousel: Warp (paid): `@stillui-pro/carousel-warp`, needs an account token. Photos in a column of pills. The one in focus sits sharp in the middle; cards stretch, flare and split into colour as they slide off the top and bottom. - [Carousel: Backdrop](https://stillui.netlify.app/r/carousel-backdrop.json): `@stillui/carousel-backdrop`. A row of thumbnails over a full-bleed photo. Sweep across the row and the photo behind cuts to each one; the chosen thumbnail grows and its neighbours make room. - [Carousel: Pager](https://stillui.netlify.app/r/carousel-pager.json): `@stillui/carousel-pager`. Photos with a pill-shaped pager under them. The active dot stretches into a bar that fills as it counts down, and the pager takes on each photo's colour. ### Checkbox Choices that wait to be submitted: single boxes, whole cards, to-do items and compact chips. Page: https://stillui.netlify.app/components/checkbox - [Checkbox: Standard](https://stillui.netlify.app/r/checkbox.json): `@stillui/checkbox`. A choice that waits to be submitted. The check draws in, and a parent can show a partial selection. - [Checkbox: Card](https://stillui.netlify.app/r/checkbox-card.json): `@stillui/checkbox-card`. A whole card that toggles, for choices that need an icon and a sentence of explanation. - [Checkbox: Todo](https://stillui.netlify.app/r/checkbox-todo.json): `@stillui/checkbox-todo`. A round checkbox for task lists. Checking it draws a line through the text, which then steps back. - [Checkbox: Chips](https://stillui.netlify.app/r/checkbox-chips.json): `@stillui/checkbox-chips`. Several choices as compact chips, for filters and preferences. A check slides in on the ones that are on. ### Command A search palette over the page. Type to filter, move with the arrow keys or the pointer, and press Enter to choose. It is this site's search. Page: https://stillui.netlify.app/components/command - Command (paid): `@stillui-pro/command`, needs an account token. A search palette over the page. Type to filter, move with the arrow keys or the pointer, and press Enter to choose. It is this site's search. ### Copy Field Ways to copy a value: a field, a labelled button, an install command per package manager, and a hidden secret. Page: https://stillui.netlify.app/components/copy-field - [Copy Field: Field](https://stillui.netlify.app/r/copy-field.json): `@stillui/copy-field`. A read-only value with a copy button that confirms in place and announces the result. - [Copy Field: Button](https://stillui.netlify.app/r/copy-button.json): `@stillui/copy-button`. A labelled copy button for places where the value is already on screen. The label turns into “Copied” in place. - [Copy Field: Command](https://stillui.netlify.app/r/copy-command.json): `@stillui/copy-command`. An install command with a switch for the package manager. Copies whichever command is showing. - [Copy Field: Secret](https://stillui.netlify.app/r/copy-secret.json): `@stillui/copy-secret`. A hidden value such as an API key, with buttons to reveal it and copy it. Copying works without revealing. ### Segmented Control Pick one of a few options that are all visible at once. Filled, underlined, icon-only or expanding. Page: https://stillui.netlify.app/components/segmented-control - [Segmented Control: Pill](https://stillui.netlify.app/r/segmented-control.json): `@stillui/segmented-control`. Pick one of two to five options. The selection glides between segments on a shared surface. - [Segmented Control: Underline](https://stillui.netlify.app/r/segmented-underline.json): `@stillui/segmented-underline`. Text options with a short line that glides under the chosen one. Lighter than a filled control, with optional counts. - [Segmented Control: Icons](https://stillui.netlify.app/r/segmented-icons.json): `@stillui/segmented-icons`. Icon-only options for view switches like grid, list and board. Each option keeps a text name for screen readers. - [Segmented Control: Expanding](https://stillui.netlify.app/r/segmented-expand.json): `@stillui/segmented-expand`. Icons that make room for the chosen option’s label. Compact like an icon control, but never mysterious. ### Sidebar App navigation along the left edge, from a full collapsible sidebar to a single rail or a menu behind a button. Eight variants, each one file. Page: https://stillui.netlify.app/components/sidebar - [Sidebar: Collapsible](https://stillui.netlify.app/r/sidebar.json): `@stillui/sidebar`. An app sidebar with sections that folds down to an icon rail. The active item’s surface glides between rows. - Sidebar: Rail (paid): `@stillui-pro/sidebar-rail`, needs an account token. A narrow icon rail that opens into a full sidebar. Closed, names slide out beside each icon on hover or focus; open, they sit beside the icons. - [Sidebar: Tree](https://stillui.netlify.app/r/sidebar-tree.json): `@stillui/sidebar-tree`. Grouped pages hanging from a thin guide line, for docs and settings. The active page lights up its stretch of the line. - [Sidebar: Dot](https://stillui.netlify.app/r/sidebar-dot.json): `@stillui/sidebar-dot`. A quiet text list where the current page steps aside for a dot. The dot runs between pages, stretching with its speed. - [Sidebar: Floating](https://stillui.netlify.app/r/sidebar-floating.json): `@stillui/sidebar-floating`. A compact menu card that floats off the edge, with counts for new items. A soft highlight follows the pointer row to row. - Sidebar: Two-level (paid): `@stillui-pro/sidebar-panels`, needs an account token. Two levels side by side: an icon rail picks the section and a panel lists its pages. Press the section again to fold the panel. - [Sidebar: Stretch line](https://stillui.netlify.app/r/sidebar-stretch.json): `@stillui/sidebar-stretch`. A text-only list with a line on the left. Moving pages, the line stretches to cover both rows, then lets go of the old one. - Sidebar: Menu (paid): `@stillui-pro/sidebar-menu`, needs an account token. Navigation tucked behind a menu button, with search that filters the pages in place. For sites where content should get the whole width. ### Slider Pick a value by dragging. All built on the native range input, so keyboards and screen readers work out of the box. Page: https://stillui.netlify.app/components/slider - [Slider: Standard](https://stillui.netlify.app/r/slider.json): `@stillui/slider`. Pick a value in a range. Built on the native range input, with the value always visible beside the label. - [Slider: Stepped](https://stillui.netlify.app/r/slider-stepped.json): `@stillui/slider-stepped`. A slider that snaps to named stops like Off, Weekly, Daily. Each stop has a dot and a label you can click. - [Slider: Range](https://stillui.netlify.app/r/slider-range.json): `@stillui/slider-range`. Pick a band, such as a price range, with two thumbs on one track. Built on two native range inputs. - Slider: Ruler (paid): `@stillui-pro/slider-ruler`, needs an account token. A ruler of ticks under a large readout. Ticks up to the value darken, so the amount reads at a glance. ### Switch On/off settings that take effect immediately. Four switches with different ways of showing their state. Page: https://stillui.netlify.app/components/switch - [Switch: Standard](https://stillui.netlify.app/r/switch.json): `@stillui/switch`. An on/off setting with a label and a one-line description. The thumb travels without overshoot. - [Switch: Stretch](https://stillui.netlify.app/r/switch-stretch.json): `@stillui/switch-stretch`. The thumb stretches toward the other side while you press, then slides there when you let go. - [Switch: Labelled](https://stillui.netlify.app/r/switch-labelled.json): `@stillui/switch-labelled`. A switch that writes its state inside the track, so on and off never depend on color alone. - [Switch: Icon thumb](https://stillui.netlify.app/r/switch-icon.json): `@stillui/switch-icon`. A switch with a check or a cross inside the thumb. The icon turns as the thumb travels. ### Text Field Inputs for words, numbers and codes, each with its label, hint and error handled. Page: https://stillui.netlify.app/components/text-field - [Text Field: Standard](https://stillui.netlify.app/r/text-field.json): `@stillui/text-field`. Label, input and one message row for hints and errors. Errors shake once; confirmed values get a check. - [Text Field: Floating label](https://stillui.netlify.app/r/text-field-floating.json): `@stillui/text-field-floating`. The label sits inside the field, then floats up when you focus or type. Compact forms without losing the label. - [Text Field: Password](https://stillui.netlify.app/r/text-field-password.json): `@stillui/text-field-password`. A password field with a show button and, for new passwords, a strength meter that says exactly what’s missing. - Text Field: Code (paid): `@stillui-pro/text-field-code`, needs an account token. A one-time code in separate boxes, backed by a single real input so typing, pasting and autofill all just work. - [Text Field: Search](https://stillui.netlify.app/r/text-field-search.json): `@stillui/text-field-search`. A rounded search field with a clear button, Escape to clear, and a shortcut key to jump to it from anywhere. ### Theme Toggle Switch between light and dark: a one-click toggle with page transitions, or a picker that can follow the system. Page: https://stillui.netlify.app/components/theme-toggle - [Theme Toggle: Button](https://stillui.netlify.app/r/theme-toggle.json): `@stillui/theme-toggle`. Switches light and dark with one of four page transitions. The icon’s sun becomes a moon as a shadow slides over it. - [Theme Toggle: Picker](https://stillui.netlify.app/r/theme-picker.json): `@stillui/theme-picker`. Light, dark, or follow the operating system. A three-way choice for settings menus, remembered between visits. ### Toast Short messages that confirm, report progress or offer an undo, then leave on their own. Five variants, each a single file. Page: https://stillui.netlify.app/components/toast - [Toast: Stack](https://stillui.netlify.app/r/toast.json): `@stillui/toast`. Brief confirmations that stack neatly, fan out on hover and leave on their own. - [Toast: Pill](https://stillui.netlify.app/r/toast-pill.json): `@stillui/toast-pill`. One short message in a capsule at the top of the screen. A new message reshapes the same pill instead of stacking. - [Toast: Action](https://stillui.netlify.app/r/toast-action.json): `@stillui/toast-action`. One message at the bottom of the screen with a single action, like Undo. It waits while you hover or focus it. - Toast: Promise (paid): `@stillui-pro/toast-promise`, needs an account token. Follows a request from start to finish in one toast. The spinner becomes a check or an error, and the text changes in place. - [Toast: Anchored](https://stillui.netlify.app/r/toast-anchored.json): `@stillui/toast-anchored`. A short message that appears right next to the button that caused it, where the eye already is. No provider needed. ### Tooltip Small labels and previews that appear on hover and focus, from plain names to cards with links inside. Page: https://stillui.netlify.app/components/tooltip - [Tooltip: Standard](https://stillui.netlify.app/r/tooltip.json): `@stillui/tooltip`. A short label for icon buttons. Waits before the first one opens, then opens instantly while you scan neighbors. - [Tooltip: Follow cursor](https://stillui.netlify.app/r/tooltip-follow.json): `@stillui/tooltip-follow`. A tooltip that follows the pointer along a wide target, like a chart or timeline, and reads out what’s under it. - [Tooltip: Shortcut](https://stillui.netlify.app/r/tooltip-shortcut.json): `@stillui/tooltip-shortcut`. A tooltip that teaches the keyboard shortcut along with the name, so people learn the faster way as they go. - [Tooltip: Hover card](https://stillui.netlify.app/r/tooltip-card.json): `@stillui/tooltip-card`. A larger preview, like a profile or link card, that opens on hover and stays open while you move into it. ## Docs - [Introduction](https://stillui.netlify.app/docs): what Still UI is and how it's meant to be used - [Installation](https://stillui.netlify.app/docs/installation): setup with and without shadcn, for npm, pnpm, yarn and bun - [Typography](https://stillui.netlify.app/docs/typography): the type rules the components follow - [Choosing a font](https://stillui.netlify.app/docs/fonts): how to pick and test a typeface, and how to swap the components' font ## Optional - [llms-full.txt](https://stillui.netlify.app/llms-full.txt): every component's source, exports, states and notes in one file - [registry.json](https://stillui.netlify.app/r/registry.json): the shadcn registry index