utopia_ui 0.1.0
utopia_ui: ^0.1.0 copied to clipboard
A token-driven Flutter design system for AI and HTML design workflows: an HTML twin, a component manifest and design tokens keep every screen on reusable components.
0.1.0 #
Initial release - extracted from utopia_cms_ui 0.1.0 under the Utopia prefix, then grown
into a token-driven design system with a machine-readable contract for AI and HTML design
tools.
- Theme system:
UtopiaTheme(InheritedWidget) over freezedUtopiaThemeData,UtopiaThemeColorsandUtopiaThemeTextStyles, built from a token ladder (UtopiaTokens: spacing, radius, border, shadow, duration, font weight, breakpoints) viaUtopiaThemeData.fromTokens.context.theme/context.colors/context.textStylesand the field-state decorations (fieldDecorationplus hover, focus, error, error-focus and read-only variants) resolve every visual from the theme, never from widget code. - Dark mode out of the box:
UtopiaThemeColors.darkThemeandUtopiaThemeData.darkTheme. A palette alone is enough to re-skin:textBody,onPrimaryandshadoware palette tokens,UtopiaThemeTextStyles.fromColorsre-tints the type family, and the shadow presets take their tint fromcolors.shadow. - Buttons and text:
UtopiaButton,UtopiaGhostButton,UtopiaRemoveIconButton,UtopiaTitle,UtopiaHeader,UtopiaCopyableText. - Fields:
UtopiaTextField,UtopiaSearchField,UtopiaDropdownField,UtopiaDatePicker,UtopiaFieldWrapper,UtopiaLabeledField. Fields carry hover, focus, error and read-only chrome that never shifts layout, and share one 48px resting height withUtopiaButton. The date picker's Material theme is derived entirely from utopia tokens, so it renders consistently under any hostMaterialApp. - Selection controls:
UtopiaCheckbox(withindeterminate),UtopiaRadio<T>,UtopiaCheckRow,UtopiaSwitch,UtopiaSwitchField,UtopiaSlider- fully controlled, Material-free and drawn from the tokens. - Table:
UtopiaTable<T>withUtopiaTableEntry<T>columns (includingnumericcolumns with tabular figures), sort options with a direction caret, search panel, empty state and theuseUtopiaTableStatehook. - Dialogs and navigation:
UtopiaDialog(raw and.form),UtopiaConfirmDialog,UtopiaSidebar(rail/drawer) with a destination/action/custom item model. - Layout, loading and misc:
UtopiaCard,UtopiaDivider,UtopiaChip,UtopiaChipList,UtopiaGradientBackground,UtopiaPageWrapper,UtopiaBreakpoints,UtopiaOverlayAnchor,UtopiaLoader,UtopiaThreeBounce,UtopiaLoadingBox(skeleton shimmer), plus vendoredUtopiaFormLayout,UtopiaCollapsibleandUtopiaMultiWidget(replacing the formerutopia_widgetsdependency). - Utopia Design Protocol 0.4.0, shipped in the package so every artifact is
version-matched through the pub cache:
protocol/- the spec, versioning rules and JSON schemas.tokens/utopia.tokens.json- the default theme as a DTCG token document.manifest/utopia.manifest.json- every component with its props, states and token bindings, so an agent or design tool knows what exists before it invents anything.twin/- the HTML twin:tokens.css, a Tailwind@themevariant,components.html, a composed gallery andDESIGN.md, kept in parity with the Flutter widgets.skills/utopia-design- a Claude Code skill for designing against the twin.
- Companion package
utopia_ui_toolsvalidates token documents, generates a project's theme from them and keeps manifests and twins fresh.