Preset catalogs
The items each preset installs, with charts, icons, behavioral widgets, and Agent surfaces
Vanilla preset catalog
The official registry is deliberately small, and every item after theme
depends on it:
theme installs tokens.dart, theme_data.dart, theme_scope.dart,
and effects.dart, giving you UiTokens (including the fixed spacing, size,
stroke, opacity, and motion scales), UiThemeData, UiTheme, and the shared
tint, shadow, and focus-ring helpers the recipes draw on. It also adds
remix_ui_fonts, the package that bundles Geist and Geist Mono, which the
shipped themes set the text steps in. Most component items
install one authored file plus their generated adapter under
components/<item>.dart. The following items differ: icons installs app-owned
icons.dart with no generated adapter; chart generates three adapters over
mix_chart; range_slider installs slider to share its rail, interval and
thumb styling; data_table also pulls in
checkbox, icon_button, and select, because its selection column, pager,
and page-size control are those components; adding it installs all four;
sidebar pulls in toggle and tooltip, because a destination is a toggle
and a collapsed rail labels it with a tooltip. toast pulls in button
and icon_button for its action and close control. sidebar_layout is a
layout with no Spec or generated adapter; it pulls in sidebar to compose
into its row and compact sheet. dashboard_shell composes those existing
primitives, with app_bar as its page header (title, an optional Widget?
headerTitle to override the default Text(title) in the app bar, and
headerActions), into a host-controlled responsive shell (collapsedWidth
defaults to 72 vs 48 on standalone UiSidebarLayout). It installs no
charts, tables, sample data, routes, or application entry point.
dashboard_demo adds the reference application. Vanilla and HeroUI ship five
destinations (Overview, Chat, Customers, Orders, and Settings) whose product
content and navigation match while each renders its own components and
variants. Fortal ships nine (Overview, Analytics, Schedule, Chat, Collection,
Customers, Orders, Themes, and Settings) around one product: an overview bento
with an emphasis hierarchy, an image-card collection with generated cover art,
a calendar, a page for its seven palettes, and a quick-find field in the
header. Every starter includes deterministic Agent flows, complete
customer and order tables, charts, appearance and notification chrome, and
local toast feedback.
Built-in chrome can be disabled; caller actions append to it and caller account
content replaces the default. It leaves the application, routes,
authentication, persistence, and backend search behavior with the host.
The registry's Remix floor includes RemixSidebar and the Toast APIs.
The installer rejects older resolved versions before it writes source.
| Item | Surface you get | Axes |
|---|---|---|
icons | UiIcons | — |
accordion | UiAccordion | — |
app_bar | UiAppBar | — |
avatar | UiAvatar | — |
badge | UiBadge | variant |
breadcrumbs | UiBreadcrumbs, UiBreadcrumbItem (Vanilla; installs theme and link) | — |
button | UiButton | variant, size |
calendar | UiCalendar | — |
date_picker | UiDatePicker | — |
date_range_picker | UiDateRangePicker | — |
range_calendar | UiRangeCalendar | — |
callout | UiCallout | variant |
card | UiCard | — |
chart | UiLineChart, UiBarChart, UiPieChart | — |
checkbox | UiCheckbox, UiCheckboxGroupItem | — |
combobox | UiCombobox (every preset; installs theme and textfield) | — |
dashboard_demo | UiDashboardDemo, UiDashboardOverview | — |
dashboard_shell | UiDashboardShell | — |
data_list | UiDataList | — |
data_table | UiDataTable | — |
dialog | UiDialog | — |
disclosure | UiDisclosure | — |
divider | UiDivider | — |
icon_button | UiIconButton | variant, size |
link | UiLink | — |
menu | UiMenu | — |
popover | UiPopover | — |
progress | UiProgress | — |
radio | UiRadio | — |
range_slider | UiRangeSlider (depends on slider) | — |
search_field | UiSearchField (Vanilla; installs theme, textfield, and icon_button) | — |
segmented_control | UiSegmentedControl | — |
select | UiSelect | — |
sidebar | UiSidebar | — |
sidebar_layout | UiSidebarLayout | — |
skeleton | UiSkeleton | — |
slider | UiSlider | — |
spinner | UiSpinner | — |
switch | UiSwitch | — |
tabs | UiTabBar, UiTab, UiTabView | variant |
textfield | UiTextField, UiTextArea | — |
toast | UiToast | variant |
toggle | UiToggle | variant, size |
toggle_group | UiToggleGroup | variant, size |
tooltip | UiTooltip | — |
The four calendar items are Vanilla hand-written composites with no generated
part. calendar wires IconButton and Select recipes; range_calendar adds
range day states. The pickers compose outline Button, elevated Popover and the
matching calendar, retaining all five child-styler overrides. breadcrumbs is
one too: a one-line trail of Link recipes with chevron separators, the current
page as plain text, and a navigation landmark around it. The Vanilla
dashboard_demo header uses it. So is search_field: a stateful text field
with a search icon and a clear button that shows for text, clears on Escape,
and owns its controller when you pass none. The Vanilla dashboard_shell
header search and the demo's customer search use it.
The fortal catalog contains the items above and adds base_button,
code, heading, kbd, text, typography, avatar_group, and
surface. base_button and typography are shared authored recipes that
arrive transitively with the components that use them. Fortal's own
avatar_group (UiAvatarGroup, size axis; installs avatar),
breadcrumbs (UiBreadcrumbs, size axis; installs link and text),
search_field (UiSearchField, variant and size axes; installs textfield
and icon_button) and surface (UiSurface, variant and size axes;
installs card) are hand-written compositions with no generated part. Fortal's component names use the configured prefix,
so an Acme installation exposes AcmeSidebar, AcmeHeading, and
AcmeText alongside its generated controls.
The heroui catalog follows HeroUI's names. Beside shared names such as
button, combobox, select, range_slider, calendar, range_calendar,
date_picker, date_range_picker, breadcrumbs, search_field, and tabs, it adds alert, avatar_group,
button_group, checkbox_group, chip, close_button, dropdown,
field_layout, input_group, modal, radio_group,
separator, surface, switch_group, table, textarea, toggle_button,
and toggle_button_group. It also ships app_bar, sidebar,
sidebar_layout, icons, and dashboard_shell as extensions: HeroUI web has
no navbar, sidebar, or application shell, so these are styled from HeroUI's
tokens and recipes (a destination is the ghost toggle_button, a rail label
the tooltip) without an upstream reference. HeroUI's sidebar pulls in
toggle_button and tooltip, and its dashboard_shell pulls in button and
search_field for its icon buttons and search. chart, the Agent items, and
dashboard_demo are extensions too. HeroUI's chart draws its series in an
ordered ramp of existing tokens (accent, muted, foreground, then
border-tertiary) and never in a status color. The Agent recipes pass HeroUI's
card, button, disclosure, and textarea styles into the shared Agent
components. HeroUI's dashboard_demo renders the same five destinations with
HeroUI's components, and pulls in chart, table, tabs, chip, and the
Agent items. Families that need
behavior Remix does not provide, such as Form and the separate popover-search Autocomplete, are not included.
One add installs every named item plus shared dependencies once. The names above use the default Ui prefix;
--prefix Acme gives you AcmeButton and friends. An axis is an enum the
recipe declares, and a recipe whose axis is named variant also gets one
named constructor per value, so UiBadge.destructive(label: 'Failing') works
out of the box.
A parameter is not an axis. UiDivider takes an orientation, but it is a
plain Flutter Axis the recipe accepts rather than an enum of its own, so it
generates no named constructors.
Charts in the Vanilla preset
The Vanilla preset's chart is an optional extension with its own compact
recipe:
remix add chartIt installs one editable recipe and generates UiLineChart, UiBarChart, and
UiPieChart. Line series can draw lines or areas. Bar data can be grouped,
stacked, or floating. A positive centerRadius makes a pie chart a donut.
The chart item requires stable mix_chart 0.0.1. UiLineChart and
UiBarChart accept valueFormatter for tooltip values, bar labels, and
semantics. Use ChartAxis.labelFormatter for axis ticks.
mix_chart retains the hard contract: data validation, rendering, pointer
interaction, transitions, tooltips, and chart semantics. Your copied file owns
the axes, grid, shared series geometry, and tooltip appearance. Series colors
come from the Theme's chart1 to chart5 tokens. A Theme installed by an
earlier CLI build lacks them: add the five tokens to tokens.dart and
theme_data.dart before adding chart.
Import chart data directly and give the chart finite dimensions:
import 'package:flutter/widgets.dart';
import 'package:mix_chart/mix_chart.dart';
import 'ui/ui.dart';
final chart = SizedBox(
height: 240,
child: UiLineChart(
semanticsLabel: 'Weekly revenue',
showMarkers: true,
series: [
LineSeries(
id: 'revenue',
label: 'Revenue',
points: [
ChartPoint(id: 'mon', x: 0, y: 18),
ChartPoint(id: 'tue', x: 1, y: 31),
],
),
],
),
);The palette is UiTokens.chart: chart1 to chart5 in series order. The
shipped values are a neutral gray ramp, the same five grays in both
brightnesses, so series are told apart by lightness. Pie labels are off by
default; a chart that turns them on colors each slice's label with
uiPieSliceLabelColor, which picks foreground or background by contrast.
Edit the tokens in UiThemeData for a design-system change.
Pass palette or style for a one-chart override. The UI barrel does not
re-export mix_chart.
Icons and behavioral widgets
In Vanilla and Fortal, remix add icons installs a small app-owned alias
surface. Registry templates resolve the iconLibrary in remix.yaml to either
RemixIcons (the default), RoundedIcons, or LucideIcons, and add the
selected package. Outline and Rounded each draw every icon the presets use, so
neither adds Lucide. See Icons in registry presets
for how presets size those icons.
Six items use icon placeholders in every preset: icons, dashboard_shell,
dashboard_demo, agent_glyphs_recipe, date_picker, and date_range_picker.
Vanilla and Fortal add breadcrumbs and search_field; HeroUI adds
breadcrumbs, close_button, and search_field.
To switch an existing install, change iconLibrary, then reinstall every one
of those you have installed in one command, reviewing first (--overwrite
replaces only the items you name, so one left out keeps the old library).
For Vanilla:
remix add icons dashboard_shell dashboard_demo agent_glyphs_recipe date_picker date_range_picker breadcrumbs search_field --diff
remix add icons dashboard_shell dashboard_demo agent_glyphs_recipe date_picker date_range_picker breadcrumbs search_field --overwriteFor Fortal:
remix add icons dashboard_shell dashboard_demo agent_glyphs_recipe date_picker date_range_picker breadcrumbs search_field --diff
remix add icons dashboard_shell dashboard_demo agent_glyphs_recipe date_picker date_range_picker breadcrumbs search_field --overwriteFor HeroUI:
remix add icons dashboard_shell dashboard_demo agent_glyphs_recipe date_picker date_range_picker breadcrumbs close_button search_field --diff
remix add icons dashboard_shell dashboard_demo agent_glyphs_recipe date_picker date_range_picker breadcrumbs close_button search_field --overwriteIcons you reference in your own code stay as you wrote them. Import
package:remix_ui_icons/remix_ui_icons.dart directly when you need the rest of
the Vector UI pack: RemixIcons (the Outline family) and RoundedIcons.
Upgrading an app from remix_ui_icons 0.1.x: the registry now requires the
1.0 line, which replaces every Radix glyph, so the installer refuses to write
source until your pubspec.yaml declares it. Raise the constraint with
flutter pub add remix_ui_icons:^1.0.0-beta.1, then follow the package's
migration guide
for your own icon references: 31 renamed names keep working as deprecated
aliases until 2.0.0, and the guide names a Lucide icon for each removed one.
Some Remix widgets are behavioral and carry no style, so the registry has
nothing to render for them. RemixCheckboxGroup, RemixRadioGroup,
RemixTabs, and RemixAccordionGroup are the four in this catalog: import
them from package:remix/remix.dart and put the installed adapters inside.
toggle_group, segmented_control, menu, and select work the other way
round. Their options are data, not widgets, and the parent's own recipe carries
the option style, so one add covers the container and every row, and a row
in a loop cannot be left unstyled.
One host note: an installed text field needs an Overlay ancestor once it
takes focus, for its selection handles. MaterialApp, CupertinoApp, and any
WidgetsApp with routes already provide one; a bare
WidgetsApp(builder: ...) does not.
Agent surfaces in the Vanilla, Fortal, and HeroUI presets
The Agent widgets live in package:remix/agent.dart (experimental). Each preset
ships recipes that style them with its own components and tokens; the widgets
themselves are not installed. agent_glyphs_recipe maps their glyphs onto the
preset icon set. The private authoring source (registry_source) is not a
consumer dependency.
remix add composer_recipeNo consumer build.yaml is needed for these items.
Available styled items: agent_glyphs_recipe, answer_recipe, composer_recipe, conversation_recipe,
message_recipe, sources_recipe, steps_recipe, suggestions_recipe, and
tool_call_recipe. Each styles one widget of package:remix/agent.dart with the
preset's own components.