# Fragiola > Fragiola is an ecosystem of components and libraries for the web. Fragiola UI is source code copied into a project through the shadcn registry; the libraries are headless npm packages (a core and framework adapters). Two kinds of components, consumed differently: - **Fragiola UI** (source code): `npx shadcn@latest add @fragiola/` after adding the registry to components.json. The project owns the copied code. - **Libraries** (npm packages): install only the adapter for the project's framework (`@fragiola/-react`, `-vue`, `-angular`): it brings the core and re-exports it. They ship behaviour and accessibility, never CSS. ## For agents - [MCP server](https://fragiola.com/mcp/): `npx fragiola@latest mcp` gives AI agents every component, page and API below - [Agent index](https://fragiola.com/agents/index.json): every project, page, example and component as JSON - [Overview](https://fragiola.com/agents/overview.md): the ecosystem, written for agents ## Fragiola UI A copy-paste component library built on Base UI and Tailwind v4. Six colour roles, any number of palettes. (source code, shadcn registry) - [Introduction](https://fragiola.com/agents/ui/getting-started/introduction.md): A copy-paste component library built on Base UI primitives and Tailwind v4. - [Installation](https://fragiola.com/agents/ui/getting-started/installation.md): Install Fragiola UI with the shadcn CLI: there is no @fragiola/ui package, the CLI copies the source into your project, and it is yours. - [Registry](https://fragiola.com/agents/ui/getting-started/registry.md): Fragiola UI's registry, in shadcn's format: a static directory of JSON that the shadcn CLI reads, with no server and no compute. - [Theming](https://fragiola.com/agents/ui/architecture/theming.md): Fragiola's colour system is built on **palettes**: sets of six roles applied by class. Components read roles, never colours. - [Palettes](https://fragiola.com/agents/ui/architecture/palettes.md): The palette set: chromatic palettes, where the colour is the element, and surface-ring palettes, neutral surfaces with a chromatic focus ring. - [Style families](https://fragiola.com/agents/ui/architecture/style-families.md): Components sharing a visual skeleton share a **family** — one source of style, consumed by all of them. - [Composition](https://fragiola.com/agents/ui/architecture/composition.md): How components compose: render instead of asChild, one wrapper for identical parts, the body on the field frame, one export per component. - [Dark mode](https://fragiola.com/agents/ui/architecture/dark-mode.md): Light and dark themes switch with one data-theme attribute on : the palettes are scoped to it, so there is no reload and no flash. - [RTL](https://fragiola.com/agents/ui/architecture/rtl.md): RTL is an MVP goal: logical properties on the inline axis (ps/pe, border-s/border-e, start/end), while the block axis stays physical. - [Design axes](https://fragiola.com/agents/ui/architecture/design-axes.md): Spacing, radius, typography, elevation and motion: five independent data attributes that reshape every component in a subtree, with no variant. - [Text](https://fragiola.com/agents/ui/atoms/text.md): The typography primitive other components wear through render, so a dialog title, a field label and a menu label never grow their own class. - [Clickable](https://fragiola.com/agents/ui/atoms/clickable.md): The button surface: one component with three exports, Button, Link and ExternalLink, that every clickable part of Fragiola UI composes. - [Field](https://fragiola.com/agents/ui/fields/field.md): One way to write a field, and one input. The box lives on the row; the control is only its middle. The field family has ten members and zero variants. - [Input](https://fragiola.com/agents/ui/fields/input.md): Input, Textarea and Numeric: one input with no box of its own. The border, focus ring and invalid state come from the row around it. - [Choice Controls](https://fragiola.com/agents/ui/fields/choice.md): Checkbox, Radio with RadioGroup, and Switch: three controls that share one choice family, so the box, focus ring and states are written once. - [Select](https://fragiola.com/agents/ui/fields/select.md): The recombination test. Select is field + popup + menu — and it declares no new style. Every class comes from a family. - [Combobox](https://fragiola.com/agents/ui/fields/combobox.md): A text input with a filtered list of options, built only from the field, popup and menu families: the second recombination test. - [Dropdown Menu](https://fragiola.com/agents/ui/menus/dropdown-menu.md): A menu of actions opened by a button. It shares the popup and menu families with context-menu, select and combobox, adding its own parts and positioning. - [Context Menu](https://fragiola.com/agents/ui/menus/context-menu.md): A menu of actions opened by a right-click. It shares the popup and menu families with dropdown-menu: installed after it, it adds one file. - [Dialog](https://fragiola.com/agents/ui/overlays/dialog.md): A modal layer: a centred panel over a scrim. It shares the layer family with alert-dialog and drawer, declaring only Root, Trigger, Portal and centring. - [Alert Dialog](https://fragiola.com/agents/ui/overlays/alert-dialog.md): A modal layer that only an explicit action dismisses: no backdrop click, no close button. It declares only what differs from dialog. - [Drawer](https://fragiola.com/agents/ui/overlays/drawer.md): An edge-anchored layer with real swipe and snap-point support, built on Base UI's Drawer primitive, which is why there is no sheet. - [Popover](https://fragiola.com/agents/ui/overlays/popover.md): A floating surface positioned against a trigger: the popup.content box of dropdown-menu, plus Title, Description and Close through render. - [Tooltip](https://fragiola.com/agents/ui/overlays/tooltip.md): A transient text label that appears on hover or focus, drawn by popup.tooltip: a member of the popup family, not a variant. - [Accordion](https://fragiola.com/agents/ui/disclosure/accordion.md): A group of expand/collapse items, one open at a time or many. It composes the disclosure family and declares only Root, Item and Header. - [Collapsible](https://fragiola.com/agents/ui/disclosure/collapsible.md): A single expand/collapse section on its own, built from the same disclosure family (trigger, panel, content) as the accordion. - [Tabs](https://fragiola.com/agents/ui/navigation/tabs.md): A strip of tabs where one is current, with an animated indicator that follows resizes and RTL through the primitive's CSS variables. - [Navigation Menu](https://fragiola.com/agents/ui/navigation/navigation-menu.md): A strip of triggers that each open a popup, with a viewport that resizes between items. The popup is popup.content, as in dropdown-menu. - [Pagination](https://fragiola.com/agents/ui/navigation/pagination.md): A strip of page links, all Clickable. The current page carries aria-current="page" and stands out by its fill, never by a colour. - [Breadcrumb](https://fragiola.com/agents/ui/navigation/breadcrumb.md): A navigation trail: a semantic