Fragiola

Special

Special components

Special components are Fragiola's headless libraries, styled by Fragiola UI and installed with one command, with the package behind them pinned.

Some components are too large to live as copy-paste source: a docking layout, a data grid, a tree view. Fragiola builds them as headless libraries, published on npm as @fragiola/<name> (a framework-free core) and @fragiola/<name>-react (the React primitives). They ship behaviour and accessibility, but no CSS, icons or text: their state is exposed as data-* and ARIA attributes.

A special component is the styled layer over one of those libraries. One command installs the package and writes the layer into your project:

npx shadcn@latest add @fragiola/dockable

What you get

  • The package, added to your dependencies at the range the layer is written for (@fragiola/dockable-react@^0.3.0). The libraries are 0.x, and a minor may break, so the item pins the version it was built and tested against.
  • The styled parts, one namespace named after the library (Dockable.Root, Dockable.Tab, …). They mirror the package's primitives one-to-one and are painted with the palette roles, so a palette class re-tints them, and they follow dark mode, RTL and the design axes like every other component.
  • One template, <Name>.Template.Simple, which renders the whole component in one line. When you need another arrangement, compose the parts yourself: the examples on each page show how.

The package owns the behaviour: its model, its commands and its keyboard and pointer handling. Import those from the package. The layer re-exports none of them. Your copy of the layer owns the look, and you can edit it like any other Fragiola UI file.

The special components

componentwhat it isitemlibrary docs
Dockabledockable panels: tabs, splitters, drag and drop, borders, popout windowsdockablefragiola.com/dockable
Splitterresizable split views: nested groups, collapsible panels, keyboard resizingsplitterfragiola.com/splitter
Treean accessible tree view: selection, tri-state checks, drag and drop, rename, async children, virtualizationtreefragiola.com/tree
Grid Layoutdraggable, resizable dashboard grids: compaction, breakpoints, keyboard moves, items dragged in from outsidegrid-layoutfragiola.com/grid-layout
Data Grida virtualized data grid: sorting, column resizing and pinning, row selection, filters, editing, paginationdata-gridfragiola.com/data-grid

Every published Fragiola library has its styled layer here. A library published later joins this table when its layer ships; until then, use its package directly and style it with palette roles.

An AI agent can tell the two kinds apart for you. The Fragiola MCP server answers which items are Fragiola UI source and which are library packages, and how to install each. See AI agents.