NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
pub.dev
pub.dev, #2749 most downloaded on pub.dev
An expressive way to effortlessly build design systems in Flutter.
Latest stable
2.4.0
Last release 12 days ago
10 Nov 2026
Ships fairly regularly
a new release about every 3 weeks
Nearly every release is documented
notes for 38 of 39 stable releases
Nothing withdrawn
no release was ever pulled
5 years old
72 releases · first in 2021
Drag across the ruler to compare, or tap a release to open it.
Callable grid styles: GridBoxStyler now constructs a GridBox with grid(children: [...]), forwarding its style, key, and children. GridBox(style: ...,
GridBoxStyler now constructs a GridBox with
grid(children: [...]), forwarding its style, key, and children.
GridBox(style: ..., children: ...) still works.false instead of throwing. Non-List
iterables with the same elements in the same order compare equal, and maps
whose values are deeply equal collections now share a hash code (#1113).Release mix 2.3.1: Prop conversion fallback and debug reporting ( #1096 ).
Release mix 2.3.1: Prop conversion fallback and debug reporting (#1096).
Mix, the latest
source now wins, as everywhere else in Mix. Previously the value was dropped
and an earlier Mix source was used instead. Debug builds report the missing
converter through FlutterError.reportError instead of debugPrint, so it
shows up in FlutterError.onError and fails widget tests.Your coding agent can read these notes before it upgrades. Set up the MCP server →
chore(mix): release 2.3.0
chore(mix): release 2.3.0 (#1102)
BoxStyler.pressable(...) returns a
PressableBox that uses the style, so button.pressable(onPress: save, child: label('Save')) replaces PressableBox(style: button, ...). It accepts
the same parameters and defaults as PressableBox.FocusVisibility and
FocusVisibilityScope expose the same signal to widgets that draw their own
focus indicators or publish widget states themselves. Call
FocusVisibility.ensureInitialized() at startup if a pointer press can
happen before the first Mix widget builds.onFocusVisible hides focus indicators after a pointer
press until the next keyboard input, so focus from a mouse click, or moved
in code after one, no longer shows a focus ring on desktop. This follows the
pointer and keyboard part of CSS :focus-visible but not its text-input
exception; use onFocused for a ring on any focus.
FocusHighlightStrategy.alwaysTraditional and alwaysTouch still override
input.Co-Authored-By: Claude Opus 5.5 (1M context) noreply@anthropic.com
Co-Authored-By: Claude Opus 5.5 (1M context) noreply@anthropic.com
.rotate(0.1) now
animate back to their neutral value on exit without an explicit .rotate(0).
Modifier tweens preserve exact endpoints, support interrupted transitions,
and snap additions/removals at the midpoint when no neutral value exists.
Interpolated opacity, padding, and blur remain within renderable bounds
during spring overshoot; rotation and valid overshoot still extrapolate.MixScope.orderOfModifiers now affects rendering, with
style-local order taking precedence. Animated modifier lists retain this
order, including when scope order changes during removal, and phase styles
respond to inherited order changes without duplicating completion callbacks.
Implicit return animations keep their timing when a variant drops its
animation config. Existing scope
order settings that were previously ignored can change wrapper nesting.Co-authored-by: Claude Opus 5 (1M context) noreply@anthropic.com
Co-authored-by: Claude Opus 5 (1M context) noreply@anthropic.com
linearGradient, radialGradient,
sweepGradient, and their foreground*Gradient counterparts (plus the
generated BoxStyler, FlexBoxStyler, StackBoxStyler, and WrapBoxStyler
factories) now accept an optional GradientTransform transform, so a
gradient can be rotated, for example
.sweepGradient(colors: colors, transform: GradientRotation(angle)), without
switching to gradient(SweepGradientMix(...)). The parameter is optional and
existing calls are unchanged.BlurModifier, BlurModifierMix, and the
WidgetModifierConfig.blur factory and instance method now accept an optional
TileMode tileMode, carried through the protocol as well. The parameter is
optional and defaults to the previous TileMode.clamp behavior, so existing
calls are unchanged.Co-authored-by: Claude Opus 5 (1M context) noreply@anthropic.com
Co-authored-by: Claude Opus 5 (1M context) noreply@anthropic.com
Stable release of the 2.2.0 line, cumulative over the 2.2.0-beta.0 through
2.2.0-beta.6 prereleases. This release adds the GridBox and WrapBox layout
families, a typed and extensible context-variant system with focus-visible
support, a fuller Pressable input and semantics surface, and complete
WidgetModifierConfig convenience APIs; it fixes variant merge priority and
nested widget-state discovery, and it carries breaking changes to Pressable
and to GridBox implicit rows.
GridTrack, GridBoxSpec, GridBoxStyler, and
GridBox API with fixed/fractional tracks, explicit and repeated rows, gaps,
row-major placement, clipping, and local Breakpoint-based constraint
branches. Equal fractional columns use equalColumns; numeric tracks and
gaps support Mix tokens; compatible geometry participates in implicit style
animation. GridTrack.auto() adds content-sized row tracks for rows and
autoRows: an auto row sizes to its tallest child's natural height at the
resolved column width, then stretches shorter children to fill the row. auto
is vertical-only; columns rejects it.WrapSpec, WrapStyler, WrapBoxSpec,
WrapBoxStyler, and WrapBox family with flattened fluent Wrap styling,
collision-safe Box/Wrap names, generated constructors and factories, and a
runnable gallery example.WidgetModifierConfig convenience APIs: mouseCursor and
scrollView are now available as factories and chain methods, and skew,
defaultIcon, iconTheme, box, and reset gained the chain methods their
factories were missing. Every built-in modifier can now be reached without
.modifier(SomeModifierMix(...)), for example
BoxStyler().wrap(.mouseCursor(SystemMouseCursors.click)). The chained
reset() clears the modifiers accumulated in that configuration only; use the
WidgetModifierConfig.reset() factory when the reset must also clear the
configuration it is merged into.ContextVariant.widgetStateDependencies: Context variants now declare the
widget states they read, so custom variants participate in nested dependency
discovery instead of relying on the framework recognizing a specific variant
type. Automatic self-tracking is limited to pointer-driven hover and press;
other states still require an ancestor scope or external controller.FocusVisibleVariant,
ContextVariant.focusVisible(), and onFocusVisible(...), which apply while
focus is highlighted in Flutter's traditional (keyboard/directional) mode.PressableSemanticsRole with button,
link, and neutral roles. PressableBox now forwards the full Pressable
focus, keyboard, controller, feedback, cursor, action, and semantics surface.BrightnessVariant, BreakpointVariant,
OrientationVariant, DirectionalityVariant, PlatformVariant,
WebVariant, and NotVariant are now public value objects behind their
ContextVariant factories, giving schema and tooling code stable typed data
to inspect instead of parsing keys.WidgetStateStyleOverride lets tooling and
tests force widget-state variants through normal style resolution, taking
precedence over controllers and nested interaction providers without
changing component behavior.StylerFieldMetadata.$stylerFieldNames, allowing schema tooling to validate
coverage without maintaining duplicate string manifests. Handwritten and
previously generated Stylers do not implement this capability until they opt
in or are regenerated.CssKeywordLinearTransform: Adds a reusable bounds-aware
GradientTransform for CSS linear-gradient keyword directions, so Tailwind
corner gradients can round-trip through schema tooling without losing visual
parity.semanticButtonLabel with
semanticsLabel, added semanticsRole, and removed the deprecated onKey
callback. Use onKeyEvent for custom keyboard handling.onKeyEvent. onPress still honors ActivateIntent dispatched
by remapped shortcuts or programmatic invocation, and custom actions can
override that binding or handle other intents. Only those five reserved keys
are claimed raw; they are left untouched when a descendant holds focus, and
modified chords are left to application shortcuts. A link-role Pressable
activates with Enter but leaves Space available for scrolling.autoRows no longer throws: Children needing more rows
than were declared previously required an explicit autoRows track, or the
Grid threw. Omitted autoRows now defaults to GridTrack.auto(), so
implicit rows size to their tallest child — both when no rows are declared
and when explicit rows run out. Fractional rows still require a bounded
height, and fixed tracks remain hard constraints. If you relied on the throw
to catch an under-declared Grid, declare rows explicitly or set autoRows
to the track you want repeated.ContextVariant.widgetStateDependencies rather than by whether they are a
WidgetStateVariant, so onFocusVisible(...) competes by declaration order
instead of always losing to any widget-state variant sharing a property, which
had been silently replacing focus rings. Variants built on
ContextVariant.not(...) move with their inner variant, so onEnabled(...)
now outranks an ambient variant such as onDark(...) declared after it.List.sort, which fell back to an unstable
quicksort at 32 elements and could reorder equal-priority variants in styles
that large.Style.widgetStates now discovers state
requirements recursively through nested and negated context-variant branches
with identity-based cycle protection, so variants like
onDark(BoxStyler().onHovered(...)) and onEnabled(...) are tracked instead
of silently never activating. Branches under un-applied named variants are
deliberately not tracked because they cannot activate until applyVariants
hoists them to the top level.StyleBuilder now
installs its pointer-interaction detector only for the states that detector
actually drives (hovered/pressed). States such as disabled and focused
can only come from an external WidgetStatesController or an ancestor scope,
so styles depending solely on those no longer gain an opaque hit-test target
that swallowed pointer events aimed at widgets beneath them, and no longer
hijack the state scope of descendants that do track hover.onFocusVisible also resolves — and repaints on input
modality changes — outside a Pressable. A WidgetStateStyleOverride forcing
focused now applies it too, matching onFocused.Variant.key. Equivalent
named, enum-backed, and built-in context variants still coalesce, while
unrelated variants with the same label retain their own predicates. Dynamic
builders keep their existing build-then-merge behavior and use function
equality instead of a hash string for merge identity.ContextVariant.brightness,
ContextVariant.breakpoint, ContextVariant.orientation,
ContextVariant.directionality, ContextVariant.platform,
ContextVariant.web, and ContextVariant.not now compare by their typed
values instead of identity, so equivalent variants deduplicate and
round-trip predictably.DefaultTextStyleModifierMix
overrides now merge with the ambient DefaultTextStyle instead of replacing
inherited text style fields.BoxShadowMix now preserves non-default
BoxShadow.blurStyle values across construction, conversion, merging,
resolution, diagnostics, equality, and its fluent and factory APIs (#992).tokenFromReferenceValue is now public for schema/tooling code that needs
to identify unresolved token references, including sentinel-backed
DoubleRef values, without importing Mix internals.Complete WidgetModifierConfig convenience APIs: mouseCursor and scrollView as factories and chain methods, plus the chain methods skew, defaultIcon, i
Complete WidgetModifierConfig convenience APIs: mouseCursor and scrollView as
factories and chain methods, plus the chain methods skew, defaultIcon,
iconTheme, box, and reset were missing. Additive only; no migration needed.
WidgetModifierConfig convenience APIs: mouseCursor and
scrollView are now available as factories and chain methods, and skew,
defaultIcon, iconTheme, box, and reset gained the chain methods their
factories were missing. Every built-in modifier can now be reached without
.modifier(SomeModifierMix(...)), for example
BoxStyler().wrap(.mouseCursor(SystemMouseCursors.click)). The chained
reset() clears the modifiers accumulated in that configuration only; use the
WidgetModifierConfig.reset() factory when the reset must also clear the
configuration it is merged into. Existing factories and chain methods are
unchanged, and .modifier(...)/.modifiers([...]) remain the entry points
for custom modifiers.Content-sized GridTrack.auto() row tracks; omitted GridBox autoRows now defaults to auto instead of throwing (breaking). Generated Styler field metada
Content-sized GridTrack.auto() row tracks; omitted GridBox autoRows now
defaults to auto instead of throwing (breaking). Generated Styler field
metadata via StylerFieldMetadata.$stylerFieldNames.
GridTrack.auto(): Content-sized row tracks for rows and autoRows.
An auto row sizes to its tallest child's natural height at the resolved
column width, then stretches shorter children to fill the row. Use it — or
omit autoRows — when child heights are unknown, such as a card grid in a
scroll view. auto is vertical-only; columns rejects it. Grids built only
from fixed and fr tracks are unaffected and still lay each child out once.StylerFieldMetadata.$stylerFieldNames, allowing schema tooling to validate
coverage without maintaining duplicate string manifests. Handwritten and
previously generated Stylers do not implement this capability until they opt
in or are regenerated.autoRows no longer throws: Children needing more rows
than were declared previously required an explicit autoRows track, or the
Grid threw. Omitted autoRows now defaults to GridTrack.auto(), so
implicit rows size to their tallest child — both when no rows are declared
and when explicit rows run out. Fractional rows still require a bounded
height, and fixed tracks remain hard constraints. If you relied on the throw
to catch an under-declared Grid, declare rows explicitly or set autoRows
to the track you want repeated.Variant merge priority follows declared state dependencies: Priority now groups active variants by whether they declare ContextVariant.widgetStateDepe
ContextVariant.widgetStateDependencies rather than by whether they are a
WidgetStateVariant, so onFocusVisible(...) competes by declaration order
instead of always losing to any widget-state variant sharing a property, which
had been silently replacing focus rings. Variants built on
ContextVariant.not(...) move with their inner variant, so onEnabled(...)
now outranks an ambient variant such as onDark(...) declared after it.List.sort, which fell back to an unstable
quicksort at 32 elements and could reorder equal-priority variants in styles
that large.Pressable input and semantics: Replaced semanticButtonLabel with semanticsLabel, added semanticsRole, and removed the deprecated onKey callback. Use o…
ContextVariant.widgetStateDependencies: Context variants now declare the
widget states they read, so custom variants participate in nested dependency
discovery instead of relying on the framework recognizing a specific variant
type. Automatic self-tracking is limited to pointer-driven hover and press;
other states still require an ancestor scope or external controller.FocusVisibleVariant,
ContextVariant.focusVisible(), and onFocusVisible(...), which apply while
focus is highlighted in Flutter's traditional (keyboard/directional) mode.PressableSemanticsRole with button,
link, and neutral roles. PressableBox now forwards the full Pressable
focus, keyboard, controller, feedback, cursor, action, and semantics surface.semanticButtonLabel with
semanticsLabel, added semanticsRole, and removed the deprecated onKey
callback. Use onKeyEvent for custom keyboard handling.onKeyEvent. onPress still honors ActivateIntent dispatched
by remapped shortcuts or programmatic invocation, and custom actions can
override that binding or handle other intents. Only those five reserved keys
are claimed raw; they are left untouched when a descendant holds focus, and
modified chords are left to application shortcuts. A link-role Pressable
activates with Enter but leaves Space available for scrolling.Style.widgetStates now discovers state
requirements recursively through nested and negated context-variant branches
with identity-based cycle protection, so variants like
onDark(BoxStyler().onHovered(...)) and onEnabled(...) are tracked instead
of silently never activating. Branches under un-applied named variants are
deliberately not tracked because they cannot activate until applyVariants
hoists them to the top level.StyleBuilder now
installs its pointer-interaction detector only for the states that detector
actually drives (hovered/pressed). States such as disabled and focused
can only come from an external WidgetStatesController or an ancestor scope,
so styles depending solely on those no longer gain an opaque hit-test target
that swallowed pointer events aimed at widgets beneath them, and no longer
hijack the state scope of descendants that do track hover.onFocusVisible also resolves — and repaints on input
modality changes — outside a Pressable. A WidgetStateStyleOverride forcing
focused now applies it too, matching onFocused.GridBox: Added the public GridTrack, GridBoxSpec, GridBoxStyler, and GridBox API with fixed/fractional tracks, explicit and repeated rows, gaps, row-m
GridTrack, GridBoxSpec, GridBoxStyler, and
GridBox API with fixed/fractional tracks, explicit and repeated rows, gaps,
row-major placement, clipping, and local Breakpoint-based constraint
branches. Equal fractional columns use equalColumns; numeric tracks and
gaps support Mix tokens; compatible geometry participates in implicit style
animation.WrapSpec, WrapStyler, WrapBoxSpec,
WrapBoxStyler, and WrapBox family with flattened fluent Wrap styling,
collision-safe Box/Wrap names, generated constructors and factories, and a
runnable gallery example.Box shadow blur styles: BoxShadowMix now preserves non-default BoxShadow.blurStyle values across construction, conversion, merging, resolution, diagno
BoxShadowMix now preserves non-default
BoxShadow.blurStyle values across construction, conversion, merging,
resolution, diagnostics, equality, and its fluent and factory APIs (#992).Style-state override scope: WidgetStateStyleOverride lets tooling and tests force widget-state variants through normal style resolution, taking preced
WidgetStateStyleOverride lets tooling and
tests force widget-state variants through normal style resolution, taking
precedence over controllers and nested interaction providers without
changing component behavior.CssKeywordLinearTransform: Adds a reusable bounds-aware
GradientTransform for CSS linear-gradient keyword directions, so Tailwind
corner gradients can round-trip through schema tooling without losing visual
parity.BrightnessVariant, BreakpointVariant,
OrientationVariant, DirectionalityVariant, PlatformVariant,
WebVariant, and NotVariant are now public value objects behind their
ContextVariant factories, giving schema and tooling code stable typed data
to inspect instead of parsing keys.Variant.key. Equivalent
named, enum-backed, and built-in context variants still coalesce, while
unrelated variants with the same label retain their own predicates. Dynamic
builders keep their existing build-then-merge behavior and use function
equality instead of a hash string for merge identity.ContextVariant.brightness,
ContextVariant.breakpoint, ContextVariant.orientation,
ContextVariant.directionality, ContextVariant.platform,
ContextVariant.web, and ContextVariant.not now compare by their typed
values instead of identity, so equivalent variants deduplicate and
round-trip predictably.DefaultTextStyleModifierMix
overrides now merge with the ambient DefaultTextStyle instead of replacing
inherited text style fields.tokenFromReferenceValue is now public for schema/tooling code that needs
to identify unresolved token references, including sentinel-backed
DoubleRef values, without importing Mix internals.This release adds context-derived token resolution and richer animation configuration, fixes variant resolution in nested styles and animation interpo
This release adds context-derived token resolution and richer animation configuration, fixes variant resolution in nested styles and animation interpolation edge cases, and hardens the token-reference system while tightening the public API around the internal token registry.
ContextToken: Zero-config token whose value is derived directly from
the build context, so context-dependent values resolve without first
registering a token in a scope (#938).AnimationConfig statics are now factories,
with added spring-curve wrappers for configuring physics-based transitions
(#937).Style nested inside another style's Prop
(a component sub-style) now applies its own context variants — widget states,
brightness, breakpoints. Previously Prop.resolveProp resolved the merged
nested style via resolve(), which skips variants. No-op for nested styles
without variants (#926).Matrix4 interpolation: Tween a transform against the identity matrix
when one endpoint is null, instead of producing a degenerate result (#931).DoubleRef sentinel collisions: Two distinct MixToken<double>
instances whose hashes landed in the same bucket previously aliased to the
same sentinel. The registry now hands out sentinels from a monotonic
counter, so sentinels are unique among registered tokens; a reverse cache
re-issues the same sentinel for the same token.BreakpointToken.resolve no longer masks type errors: the built-in
mobile/tablet/desktop defaults are only used when the scope is
absent or omits the entry. A scope entry of the wrong type now surfaces
the underlying StateError from MixScope.getToken.Prop.value(x).mergeProp( Prop.token(t)).multiply(2) and similar chains now resolve instead of
throwing — _asPropNum rebuilds every source as Prop<num> and merges
in order.Prop.value null safety: the token-ref detection branch no longer
crashes when V is nullable and the supplied value is null.ValueRef.noSuchMethod throws UnsupportedError (was
UnimplementedError). The detailed message is unchanged; only the error
type differs. Any user code that catches the specific class needs to
switch.getReferenceValue no longer silently casts an unsupported token
type — it now throws UnsupportedError naming the token and T. All
concrete MixToken subclasses override call() and never hit this path;
the change only affects custom MixToken authors who relied on the cast.clearTokenRegistry and
getTokenFromValue are no longer re-exported from package:mix/mix.dart
(both are now @internal; tests reach them via package:mix/src/...).
The public DoubleRef(double) constructor was removed — DoubleRef
instances are only ever obtained through MixToken<double>.call().
For an explicit, type-safe handle to a double token, use
Prop.token(token).isAnyTokenRef drops the brittle runtimeType.toString().endsWith(...)
check; a Prop carrying a TokenSource is now the sole class-based
invariant.StyleWidget defaults to IdentityStyle<Spec>, giving widgets a
well-defined no-op style when none is supplied (#921).`ColorRef` directive overrides: Non-deprecated Color methods on ColorRef (e.g. withValues) are now overridden to return a ref carrying a directive, ke…
This release adds finer-grained control over scope inheritance and theming, and restores compatibility with newer Flutter SDKs.
MixScope.inherit: Opt into merging with the nearest ancestor MixScope instead of replacing it, so nested scopes can extend tokens and breakpoints without re-declaring them (#914).ColorRef directive overrides: Non-deprecated Color methods on ColorRef (e.g. withValues) are now overridden to return a ref carrying a directive, keeping color tokens unresolved until rendering (#908).TextDecorationRef so Mix builds against newer Flutter SDKs where TextDecoration is no longer extendable (#913).Legacy utility classes and mutable stylers: All remaining deprecated utility classes and mutable stylers were removed, finishing the transition to the…
This release completes the 2.0 Styler migration by removing the remaining legacy utility surface, and adds new ergonomic shorthands and variant tooling.
TextStyler values down the widget tree via a modifier, matching the pattern used by other default stylers (#905).MixStyler export: MixStyler is now exported from the public API, matching the documentation (#900).fix: React Server Components RCE vulnerability by @vercel[bot] in https://github.com/btwld/mix/pull/798
<img width="1640" height="600" alt="image" src="https://github.com/user-attachments/assets/8ec9b464-d657-4ead-bda5-477baba7669d" />
Mix 2.0 introduces a fluent, type-safe styling system for Flutter with first-class variants, built-in animation APIs, and token-based theming. This release modernizes the developer experience by separating style semantics from widget structure while keeping composition ergonomic.
Styler API (BoxStyler, TextStyler, IconStyler, FlexBoxStyler, ImageStyler)onHovered, onPressed, onDark, breakpoints, platform, and more)MixScopeMix 2.0 replaces prefix-heavy utility declarations with chainable, strongly typed stylers that are easier to discover in IDE autocomplete and safer to refactor.
final card = BoxStyler()
.color(Colors.white)
.paddingAll(16)
.borderRounded(12)
.onHovered(.color(Colors.grey.shade50))
.onDark(.color(Colors.grey.shade900));
Box(style: card, child: child);
Stylers can be invoked directly as widget factories:
final box = BoxStyler().color(Colors.blue).size(100, 100)
box(child: child); // returns a Box
Mix now supports three animation types directly in style definitions, from simple state transitions to full timeline control:
Implicit (state/variant-driven)
final style = BoxStyler()
.color(Colors.blue)
.size(100, 100)
.animate(.easeInOut(300.ms))
.onHovered(.color(Colors.deepPurple).size(120, 120));
Phase (event-triggered multi-step flow)
final controller = PhaseAnimationController();
final base = BoxStyler().color(Colors.blue).size(100, 100);
PhaseAnimationBuilder(
controller: controller,
phases: [
PhaseConfig(base.size(80, 80), duration: 150.ms, curve: .easeIn),
PhaseConfig(base.size(120, 120), duration: 250.ms, curve: .bounceOut),
PhaseConfig(base, duration: 180.ms, curve: .easeOut),
],
builder: (context, phaseStyle) => Box(style: phaseStyle),
);
Keyframe (timeline + multiple tracks)
KeyframeAnimationBuilder(
duration: 1200.ms,
repeat: true,
keyframes: {
KeyframeTrack<double>(
property: KeyframeProperty.iconSize,
keyframes: [Keyframe(0.0, 40), Keyframe(0.5, 56), Keyframe(1.0, 40)],
),
KeyframeTrack<Color>(
property: KeyframeProperty.iconColor,
keyframes: [Keyframe(0.0, Colors.red), Keyframe(1.0, Colors.red.shade800)],
),
},
builder: (context, keyframeStyle) => StyledIcon(style: baseIcon.merge(keyframeStyle)),
);
See the Animations Guide for full concepts, API details, and additional examples.
Mix 2.0 is a major API evolution. Migration from 1.x requires updates.
$box, $text, $on, and $with are replaced by fluent stylersMigration reference:
// Before (1.x)
final style = Style(
$box.color.blue(),
$box.padding(16),
$on.hover($box.color.red()),
);
// After (2.0)
final style = BoxStyler()
.color(Colors.blue)
.paddingAll(16)
.onHovered(.color(Colors.red));
mix: Core styling frameworkmix_annotations: Annotation package for generationmix_generator: build_runner generator for specs/stylersmix_lint: Custom lint rules for Mix best practicesMore ecosystem packages and updates are coming soon.
See fluttermix.com for complete guides, widget references, and migration resources.
Stack and StackBox by @tilucasoli in https://github.com/btwld/mix/pull/779Full Changelog: https://github.com/btwld/mix/compare/mix-1.7.0...mix-v2.0.1
This patch release improves day-to-day styling ergonomics and makes looping animations more reliable in edge cases.
BoxStyler(), TextStyler(), IconStyler(), and related stylers are the primary styling surface. All deprecated spec utilities, legacy widget/style entry…
Mix 2.0 is a ground-up rethink of how styling works in Flutter. This release introduces Styler-first APIs with fluent chaining, leverages Dart 3.11+ dot shorthands for concise syntax, modernizes the widget modifier model, and adds full code generation for specs and stylers via mix_annotations / mix_generator.
$ utilities. BoxStyler(), TextStyler(), IconStyler(), and related stylers are the primary styling surface. All deprecated spec utilities, legacy widget/style entry points, and unused enum/color helpers have been removed (#806, #870).WidgetModifierConfig construction instead of older patterns (#775).resolveProp is @internal; use MixOps.resolve where you relied on the previous surface (#833).>=3.11.0, Flutter >=3.41.0.Styled* widget names deprecated in favor of new naming conventions (#619).Style usage (#644).MixWidgetStateModel (#698); MixWidgetStateController deprecated (#586).BoxStyler().color(Colors.blue).size(100, 100).paddingAll(16).applyVariants() for applying NamedVariant sets in one place (#801).Style.of() and Style.maybeOf() for reading resolved styles from the widget tree (#784).Stack / FlexBox (and related) for concise composition; Stack / StackBox restructured for the 2.0 model (#779).DefaultStyledText and DefaultStyledIcon typedefs for consistent defaults (#767).MixableSpec / MixableStyler generation, MixableField.setterType, and Style-class extension support in mix_generator (#835, #846, #845).SpecUtility, Style, and Attributes unified as compatible values (#643).StyleSpecBuilder build path simplified (#825).@immutable; clearer equality behavior (#821).BaseStyle utility class introduced for improved styling architecture (#659).MixBuilder to SpecBuilder (#651).VariantStyle merge and widget state handling in StyleBuilder (#774, #765).copyWith parameters; lerp respects nullability (including generator fixes) (#848, #849).chain getter on StackStyler; AnimationStyleMixin on FlexBoxStyler and StackBoxStyler (#818, #819).Mixable now extends EqualityMixin instead of StyleElement (#648).Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
refactor: Deprecate MixWidgetStateController by @tilucasoli in https://github.com/btwld/mix/pull/586
We’ve made an architectural decision to reorganize the Mix ecosystem for better clarity, scalability, and maintenance.
Remix and Naked have been moved to separate repositories, allowing them to evolve independently as standalone design system layers.
The Mix repository will continue to host:
This structure keeps the core styling engine unified, while encouraging modular growth across the ecosystem.
This update brings a breakthrough performance improvement to the Mix framework: ComputedStyle and ComputedStyleProvider – a new system that rebuilds only what’s needed, using InheritedModel under the hood.
Traditional rebuilds could affect entire widget subtrees. With ComputedStyle, we now get: • Up to 70% fewer unnecessary rebuilds • O(1) style resolution
This change makes Mix significantly more scalable for large apps.
We’ve simplified the way you write styles in Mix.
You no longer need .chain to compose multiple style elements. 🎉
👇 Before:
Style(
$box.chain
..padding.all(12)
..color.red()
..border.all.color.redAccent(),
)
✅ Now:
Style(
$box
..padding.all(12)
..color.red()
..border.all.color.redAccent(),
)
This is part of our ongoing effort to make Mix more intuitive, predictable, and joyful to use.
MixWidgetStateController by @tilucasoli in https://github.com/btwld/mix/pull/586autofocus to false in Menu and Select by @tilucasoli in https://github.com/btwld/mix/pull/609DefaultTextStyle Modifier by @tilucasoli in https://github.com/btwld/mix/pull/578mix_data file to mix_context by @tilucasoli in https://github.com/btwld/mix/pull/697Full Changelog: https://github.com/btwld/mix/compare/mix-1.6.0...mix-1.7.0
MixWidgetStateController (#586).REFACTOR: Fix deprecations and modernize codebase (#647).
MixWidgetStateController (#586).REFACTOR: Rename MixableProperty to MixableType
mix - v1.6.0MixableProperty to MixableType (#574)mix_annotations - v0.4.0MixableProperty to MixableType (#574).mix_generator - v0.4.0MixableProperty to MixableType (#574)MixableProperty to MixableType by @tilucasoli in https://github.com/btwld/mix/pull/574Full Changelog: https://github.com/btwld/mix/compare/mix-1.5.3...mix-1.6.0
FEAT: Accordion interaction based on open variable (#546).
In this release, FlexBox now has its own dedicated utility: $flexbox. Previously, you styled FlexBox using either $flex or $box. With $flexbox, you ge
FlexBox Gets a Dedicated Spec and UtilityIn this release, FlexBox now has its own dedicated utility: $flexbox. Previously, you styled FlexBox using either $flex or $box. With $flexbox, you get a utility that combines attributes from both, offering a more intuitive and efficient way to handle a common use case in most applications.
This enhancement simplifies your code by reducing the need to use both box and any flex widget, making it easier to define layouts with different children.
FlexBox(
direction: Axis.vertical,
style: Style(
$flexbox.chain
..flex.mainAxisAlignment.center()
..flex.crossAxisAlignment.center()
..flex.gap(12)
..padding.all(12)
..color.red()
..border.all.color.redAccent(),
),
children: const [
Text('Hello'),
Text('World'),
],
),
Important Note: Starting with the next major version, FlexBox will exclusively use $flexbox. This change ensures that FlexBox styling is fully aligned with the existing API conventions in Mix, offering a more consistent developer experience.
Remix now includes a fully interactive playground, allowing you to explore and preview all available components in one place.
Try out the playground today to get hands-on with Remix components and unlock new possibilities for your UI design!
The mix_generator and mix_annotation now include full support for design token generation. With this update, you can effortlessly define your design tokens and let the generator handle creating everything needed to integrate them into your MixThemeData.
Simply annotate a class with @MixableToken, specifying the token type, and the generator will do the rest. This feature supports all design token categories: Radius, Color, Space, and TextStyle.
@MixableToken(Color)
class CustomColors {
final Color primary;
final Color surface;
const CustomColors({
required this.primary,
required this.surface,
});
Map<ColorToken, Color> toMap() => _$CustomColorsToMap(this);
}
The generated code supports you reference tokens directly in your styles for a cleaner, more declarative approach:
$box.color.$primary()
You can also access tokens dynamically through the context
context.$color.primary()
This update ensure consistency across your app while reducing boilerplate. The added utilities make tokens easier to use, improving developer productivity.
mix - v1.5.3SpecConfiguration (#483).TokenResolver (#537).remix - v0.0.3mix_annotations - v0.3.1mix_generator - v0.3.2mix_lint - v0.1.2TokenResolver by @tilucasoli in https://github.com/conceptadev/mix/pull/537Full Changelog: https://github.com/conceptadev/mix/compare/mix-1.5.2...mix-1.5.3
SpecConfiguration (#483).TokenResolver (#537).mix - v1.5.2mix - v1.5.1REFACTOR: ShapeBorder merge (#490).
mix - v1.5.2Full Changelog: https://github.com/conceptadev/mix/compare/mix-1.5.1...mix-1.5.2
Packages with breaking changes:
Packages with other changes:
Packages with dependency updates only:
Packages listed below depend on other packages in this workspace that have had changes. Their versions have been incremented to bump the minimum dependency versions of the packages they depend upon in this project.
remix - v0.0.2-alpha.2FEAT: Add MixOutlinedBorder (#487).
mix - v1.5.1Full Changelog: https://github.com/conceptadev/mix/compare/mix-1.5.0...mix-1.5.1
Packages with breaking changes:
Packages with other changes:
Jakob Nielsen), a leading figure in UI/UX design, transformed the field with his Ten Usability Heuristics and emphasis on user-centered design. His wo
<img width="910" alt="Frame 37@2x" src="https://github.com/user-attachments/assets/d3c64860-1226-4a25-8422-0b57ad3f6de6">
Jakob Nielsen, a leading figure in UI/UX design, transformed the field with his Ten Usability Heuristics and emphasis on user-centered design. His work highlights the importance of intuitive, efficient interfaces and usability testing. Nielsen’s mantra, “users are not like you,” serves as a reminder to prioritize real user needs, making his contributions essential in shaping modern digital experiences.
The fluent API allows for more expressive and readable code when working with Mix specifications and utilities. It enables chaining of method calls and provides a more intuitive way to configure and build Mix components.
final style = Style(
$text.chain
..uppercase()
..textAlign.center()
..style.color.blue()
..style.fontSize(20),
);
This feature gives developers greater control over their Styles by allowing them to clear any spec modifier or color directive and start fresh with new ones.
final style = Style(
$box.chain
..width(100)
..height(100)
..color.red()
..color.withHue(200)
..color.withSaturation(0.3)
..color.withLightness(0.3)
..color.resetDirectives()
..color.withAlpha(140)
);
In this example, all previous directives are ignored after the resetDirectives attribute.
Previously, $on.dark relied on Material design because it was using Theme.of(context), causing issues when using the Cupertino theme. With this update, brightness detection works consistently across different design systems, ensuring better compatibility and reliability.
Key Points:
MediaQuery instead of Theme by @doug-orchard in https://github.com/conceptadev/mix/pull/471Full Changelog: https://github.com/conceptadev/mix/compare/mix-1.4.6...mix-1.5.0
MediaQuery instead of Theme (#471).FIX(docs): fix fn level docs for Style::applyVariants (#460).
mix - v1.4.6SingleChildScrollView widget modifier (#427).mix_annotations - v0.3.0mix_generator - v0.3.0SingleChildScrollView widget modifier by @Maksimka101 in https://github.com/conceptadev/mix/pull/427$ sign in dart code example by @withden in https://github.com/conceptadev/mix/pull/459Full Changelog: https://github.com/conceptadev/mix/compare/mix-1.4.5...mix-1.4.6
FIX: HitTestBehavior when there is an Interectable in the tree (#437).
mix - v1.4.5Full Changelog: https://github.com/conceptadev/mix/compare/mix-1.4.4...mix-1.4.5
Packages with breaking changes:
Packages with other changes:
Packages with dependency updates only:
Packages listed below depend on other packages in this workspace that have had changes. Their versions have been incremented to bump the minimum dependency versions of the packages they depend upon in this project.
remix - v0.0.2+4FIX: Pressable disposes controller only if it creates it (#424).
mix - v1.4.4Full Changelog: https://github.com/conceptadev/mix/compare/mix-1.4.3...mix-1.4.4
Packages with breaking changes:
Packages with other changes:
Packages with dependency updates only:
Packages listed below depend on other packages in this workspace that have had changes. Their versions have been incremented to bump the minimum dependency versions of the packages they depend upon in this project.
remix - v0.0.2+3FIX: Breakpoint utility merge exception (#421).
mix - v1.4.3Full Changelog: https://github.com/conceptadev/mix/compare/mix-1.4.2...mix-1.4.3
Packages with breaking changes:
Packages with other changes:
Packages with dependency updates only:
Packages listed below depend on other packages in this workspace that have had changes. Their versions have been incremented to bump the minimum dependency versions of the packages they depend upon in this project.
remix - v0.0.2+2FIX: FlexSpecWidget prioritizes the direction in spec (#414).
mix - v1.4.2Full Changelog: https://github.com/conceptadev/mix/compare/mix-1.4.1...mix-1.4.2
Packages with breaking changes:
Packages with other changes:
FIX: Added missing widget state utilities (#411).
mix - v1.4.1mix_generator - v0.2.2+1remix - v0.0.2+1Full Changelog: https://github.com/conceptadev/mix/compare/mix-v1.4.0...mix-1.4.1
Future releases will be named after influential figures in the UI/UX field, showcasing their contributions and encouraging our community to learn more
Future releases will be named after influential figures in the UI/UX field, showcasing their contributions and encouraging our community to learn more about their impactful work, and it is with great honor that we name our first release after Don Norman.
Don Norman, a pioneering figure in the field of user interface design, has profoundly influenced the way we interact with technology. As the author of "The Design of Everyday Things," his work has illuminated the principles of user-centered design, emphasizing the importance of intuitive, accessible, and human-centric interfaces. Norman's insights have guided designers worldwide, shaping products that are not only functional but also delightful to use, making him a cornerstone of modern UI/UX design.
The Spec Modifiers feature in Mix is a powerful and flexible tool that enhances the way you can style and modify specific widgets within your widget tree. This feature allows for precise control over individual elements, making it easier to create complex and dynamic layouts.
Key Points:
Pressable(
onPress: () {},
child: Box(
style: Style(
$icon.wrap.scale(1),
$on.hover(
$icon.wrap.scale(0.9),
),
$on.press(
$icon.wrap.scale(1.5),
),
).animate(curve: Curves.decelerate),
child: const StyledIcon(
Icons.check,
),
),
);
The examples provided demonstrate the versatility of Spec Modifiers. You can scale a Box widget or target a specific StyledIcon within a Box, applying a scale transformation only to the icon. This level of granular control is invaluable for creating polished and responsive user interfaces.
Spec Modifiers are a game-changer for Mix as they allow great support for third-party libraries and custom widgets. They provide a way to create a more consistent and maintainable codebase, making it easier to manage complex layouts and interactions.
This is an example of the use with the flutter_animate package.
final style = Style(
$animate()
.fadeIn(duration: 600.ms)
.then(
delay: 200.ms,
)
.slide(),
);
We are excited to see how developers will leverage Spec Modifiers to create more dynamic and engaging user interfaces. Also, we are currently planning a package that provides official support for flutter_animate.
Read more about Spec Modifiers in our documentation.
As we have matured some of these concepts, it has become clear that Widget Modifiers can reuse a lot of the same infrastructure as Specs, and with that, we have brought code generation to Widget Modifiers, making it easier than ever to create and use them.
Here is the implementation of our Padding modifier, which wraps a widget with a Padding widget.
part 'padding_widget_modifier.g.dart';
@MixableSpec()
final class PaddingModifierSpec extends WidgetModifierSpec<PaddingModifierSpec>
with _$PaddingModifierSpec {
final EdgeInsetsGeometry padding;
const PaddingModifierSpec([EdgeInsetsGeometry? padding])
: padding = padding ?? EdgeInsets.zero;
@override
Widget build(Widget child) {
return Padding(padding: padding, child: child);
}
}
With code generation, it is easier than ever to create custom Widget Modifiers as the creation of attributes and utilities are all handled for you.
Supercharge Your Mix Code Refactoring! We're excited to introduce the new assist in Mix Lint: Extract Attributes, a powerful new tool designed to enhance your Mix development experience.
Key Points:
https://github.com/user-attachments/assets/f27ea2ee-783d-4a86-9dc9-cca808fbff2f
Read more about the new assist to help you Extract Attributes in our documentation
Introducing defaultOrderOfModifiers in MixThemeData!
Key Points:
final overrideOrderTheme = MixThemeData(
defaultOrderOfModifiers: [
SizedBoxModifierSpec,
ClipRectModifierSpec,
TransformModifierSpec,
],
);
Read more about how to override the default order of modifiers in our documentation
The Controlling Widget State feature in Mix is an excellent addition that enhances the flexibility and power of custom widget creation. It provides a robust way to manage widget states using the MixWidgetStateController, allowing for fine-grained control over press, long press, focus, and hover interactions
Key Points:
Read more about Controlling Widget State in our documentation
We have improved debugging capabilities and the overall development experience. You can now check all attributes that a Mix widget holds.
Key Points:
Improved Visibility: Key classes now implement diagnosticable, providing deeper insights into object states. Intelligent Introspection: Leverage Flutter's powerful diagnostic tools to inspect your Mix objects. Design Tokens Support: DevTools can identify whether a value originated from a Design token or was directly applied.
https://github.com/user-attachments/assets/84941836-c13b-43db-9ebe-59ec187f5eea
mix - v1.4.0mix_annotations - v0.2.1withCopyWith, withEquality, withLerp, and skipUtility (#396).mix_generator - v0.2.2mix_lint - v0.1.1remix - v0.0.2Full Changelog: https://github.com/conceptadev/mix/compare/mix-v1.3.0...mix-v1.4.0
REFACTOR: use timer instead of future (#374).
Full Changelog: https://github.com/conceptadev/mix/compare/mix-v1.2.0...mix-v1.3.0
FIX: Exception when there is no children on flex (#345).
Fix: Improved merge behavior between ShapeDecoration and BoxDecoration by @leoafarias in https://github.com/conceptadev/mix/pull/316
Full Changelog: https://github.com/conceptadev/mix/compare/v1.1.2...v1.1.3
Fix/animated spec fix by @leoafarias in https://github.com/conceptadev/mix/pull/308
Full Changelog: https://github.com/conceptadev/mix/compare/v1.1.0...v1.1.1
Mix now uses mix_generator for Spec and Dto generation.
Full Changelog: https://github.com/conceptadev/mix/compare/v1.0.0...v1.1.0
A love letter to Flutter. Mix is meant to broaden the possibilities and bring proven ways of styling to the framework. We believe this helps create a
A love letter to Flutter. Mix is meant to broaden the possibilities and bring proven ways of styling to the framework. We believe this helps create a more robust ecosystem for custom design systems and UI libraries.
Mix is a simple and intuitive styling system for Flutter, enabling the creation of beautiful and consistent UIs with ease.
Mix brings industry-proven design system concepts to Flutter. It separates style semantics from widgets while maintaining an easy-to-understand and manageable relationship between them.
Flutter developers often face challenges when it comes to styling widgets and maintaining a consistent look and feel across their apps. Flutter is heavily dependent on the Material Design System and theming, and that can be challenging, especially when creating your own design system.
Mix addresses these challenges by creating a styling system that uses utility functions for a more intuitive and composable way to style. This approach can be kept consistent across widgets and files.
Mix focuses on and is optimized for custom styling and the creation of reusable components and design systems. Our goal is not to replace existing Flutter theming for Material and Cupertino, but to provide a more flexible, composable, and intuitive way to design bespoke widgets.
Mix is already being used in production by apps with millions of users, proving its effectiveness and reliability. Large teams working on custom design systems or multi-brand apps have found Mix particularly beneficial in maintaining consistent styling and reducing code complexity.
We're continuously improving Mix and have exciting plans for the future. Some of the upcoming features include code generation and integration with other libraries, and the release of our headless widget library which are calling Remix.
We're excited to see what you'll create with Mix. Let's build beautiful apps together!
Visit our documentation site for more information https://www.fluttermix.com
update doc by @tilucasoli in https://github.com/conceptadev/mix/pull/268
Full Changelog: https://github.com/conceptadev/mix/compare/v1.0.0-beta.14...v1.0.0-beta.15
Remove deprecated code by @tilucasoli in https://github.com/conceptadev/mix/pull/259
Full Changelog: https://github.com/conceptadev/mix/compare/v1.0.0-beta.13...v1.0.0-beta.14
Fix/multiconditions contextvariant by @tilucasoli in https://github.com/conceptadev/mix/pull/241
Full Changelog: https://github.com/conceptadev/mix/compare/v1.0.0-beta.12...v1.0.0-beta.13
Chore/consolidated spec widgets by @leoafarias in https://github.com/conceptadev/mix/pull/240
Full Changelog: https://github.com/conceptadev/mix/compare/v1.0.0-beta.11...v1.0.0-beta.12
document animations by @tilucasoli in https://github.com/conceptadev/mix/pull/234
Full Changelog: https://github.com/conceptadev/mix/compare/v1.0.0-beta.10...v1.0.0-beta.11
Fix/pressable delay by @leoafarias in https://github.com/conceptadev/mix/pull/235
Full Changelog: https://github.com/conceptadev/mix/compare/v1.0.0-beta.9...v1.0.0-beta.10
Add test "StyledWidgets should apply decorators only once" by @tilucasoli in https://github.com/conceptadev/mix/pull/216
Full Changelog: https://github.com/conceptadev/mix/compare/v1.0.0-beta.8...v1.0.0-beta.9
Feat/add deprecated apis by @tilucasoli in https://github.com/conceptadev/mix/pull/214
Full Changelog: https://github.com/conceptadev/mix/compare/v1.0.0-beta.7...v1.0.0-beta.8
Update og on docs image by @leoafarias in https://github.com/conceptadev/mix/pull/197
Full Changelog: https://github.com/conceptadev/mix/compare/v1.0.0-beta.6...v1.0.0-beta.7
Add new job to pipeline by @tilucasoli in https://github.com/conceptadev/mix/pull/189
Style.icon by @tilucasoli in https://github.com/conceptadev/mix/pull/194Full Changelog: https://github.com/conceptadev/mix/compare/v1.0.0-beta.5...v1.0.0-beta.6
Better support for ShapeBorder by @leoafarias in https://github.com/conceptadev/mix/pull/181
Full Changelog: https://github.com/conceptadev/mix/compare/v1.0.0-beta.4...v1.0.0-beta.5
Deprecate elevation helpers by @leoafarias in https://github.com/conceptadev/mix/pull/178
Full Changelog: https://github.com/conceptadev/mix/compare/v1.0.0-beta.1...v1.0.0-beta.4
Nothing published for this version
One column per quarter.