RemixRemix

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.

ItemSurface you getAxes
iconsUiIcons—
accordionUiAccordion—
app_barUiAppBar—
avatarUiAvatar—
badgeUiBadgevariant
breadcrumbsUiBreadcrumbs, UiBreadcrumbItem (Vanilla; installs theme and link)—
buttonUiButtonvariant, size
calendarUiCalendar—
date_pickerUiDatePicker—
date_range_pickerUiDateRangePicker—
range_calendarUiRangeCalendar—
calloutUiCalloutvariant
cardUiCard—
chartUiLineChart, UiBarChart, UiPieChart—
checkboxUiCheckbox, UiCheckboxGroupItem—
comboboxUiCombobox (every preset; installs theme and textfield)—
dashboard_demoUiDashboardDemo, UiDashboardOverview—
dashboard_shellUiDashboardShell—
data_listUiDataList—
data_tableUiDataTable—
dialogUiDialog—
disclosureUiDisclosure—
dividerUiDivider—
icon_buttonUiIconButtonvariant, size
linkUiLink—
menuUiMenu—
popoverUiPopover—
progressUiProgress—
radioUiRadio—
range_sliderUiRangeSlider (depends on slider)—
search_fieldUiSearchField (Vanilla; installs theme, textfield, and icon_button)—
segmented_controlUiSegmentedControl—
selectUiSelect—
sidebarUiSidebar—
sidebar_layoutUiSidebarLayout—
skeletonUiSkeleton—
sliderUiSlider—
spinnerUiSpinner—
switchUiSwitch—
tabsUiTabBar, UiTab, UiTabViewvariant
textfieldUiTextField, UiTextArea—
toastUiToastvariant
toggleUiTogglevariant, size
toggle_groupUiToggleGroupvariant, size
tooltipUiTooltip—

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 chart

It 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 --overwrite

For 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 --overwrite

For 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 --overwrite

Icons 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_recipe

No 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.

View page source on GitHub

On this page