mix 2.0.1

An expressive way to effortlessly build design systems in Flutter.

2.0.1

This patch release improves day-to-day styling ergonomics and makes looping animations more reliable in edge cases.

New features

• Dot shorthand coverage expanded: Static factory constructors are now available for all Styler instance methods, making Dart 3.11 shorthand syntax available across the full styling surface (#884).

Fixes

• Looping animations: Loop driver updates now use the latest configured duration so repeated animations stay in sync with configuration changes (#885).
• Matrix interpolation stability: Matrix lerp now safely handles null endpoints to prevent snapping artifacts during transitions (#882).

2.0.0

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.

Breaking changes

• Styler APIs replace legacy $ 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).
• Widget modifiers now use WidgetModifierConfig construction instead of older patterns (#775).
• Internal resolver usage: resolveProp is @internal; use MixOps.resolve where you relied on the previous surface (#833).
• Minimum SDK: Dart >=3.11.0, Flutter >=3.41.0.
• Styled widget naming: Legacy Styled* widget names deprecated in favor of new naming conventions (#619).
• NestedStyleAttribute removed: Migrate to direct Style usage (#644).
• SpecConfiguration/SpecStyle removed from environment (#656).
• MixWidgetState renamed to MixWidgetStateModel (#698); MixWidgetStateController deprecated (#586).

New features

• Fluent Styler API: Build styles with chained method calls — BoxStyler().color(Colors.blue).size(100, 100).paddingAll(16).
• Styler dot shorthands: Static factory constructors on stylers for Dart 3.11 dot-notation syntax (#857).
• Named variants: applyVariants() for applying NamedVariant sets in one place (#801).
• Style lookup: Style.of() and Style.maybeOf() for reading resolved styles from the widget tree (#784).
• Layout widgets: Callable Stack / FlexBox (and related) for concise composition; Stack / StackBox restructured for the 2.0 model (#779).
• Widget builder pattern: Ergonomic Mix API through widget builders (#754).
• Default widget styles: Mix widgets ship with sensible defaults out of the box (#759).
• Numeric styling: Number directives and extensions for numeric transforms in styles (#785).
• Defaults: DefaultStyledText and DefaultStyledIcon typedefs for consistent defaults (#767).
• Codegen: MixableSpec / MixableStyler generation, MixableField.setterType, and Style-class extension support in mix_generator (#835, #846, #845).
• Animation loops: Loop support for Phase and Keyframe animations (#824).
• Unified attributes: SpecUtility, Style, and Attributes unified as compatible values (#643).
• Style-focused modifiers and specs: Generated modifiers and specs for streamlined styling (#652).
• Builder optimization: Improved style builder performance (#629).

Improvements

• Widget state variant mixins split into focused files; unsupported widget state variants removed (#768, #769).
• StyleSpecBuilder build path simplified (#825).
• Specs standardized with @immutable; clearer equality behavior (#821).
• BaseStyle utility class introduced for improved styling architecture (#659).
• Widget state handling moved from MixBuilder to SpecBuilder (#651).
• Docs, examples, and codebase updated to dot-shorthand / Styler syntax throughout.

Fixes

• Variants: More reliable VariantStyle merge and widget state handling in StyleBuilder (#774, #765).
• copyWith / lerp: Nullable copyWith parameters; lerp respects nullability (including generator fixes) (#848, #849).
• Stylers: chain getter on StackStyler; AnimationStyleMixin on FlexBoxStyler and StackBoxStyler (#818, #819).
• Animations: Visibility stays correct through the end of exit animations (#771). Animation drivers no longer reset when animation configuration is unchanged (#859).
• Equality: Mixable now extends EqualityMixin instead of StyleElement (#648).
• CopyWith: Overriding bug fixed (#622).
• Breakpoints: Breakpoint utility merge exception resolved (#758).

1.7.0

• REFACTOR: Implement BaseStyle utility class and improve styling architecture #659
• REFACTOR: Remove SpecConfiguration and SpecStyle from environment (#656)
• REFACTOR: Move widget state handling from MixBuilder to SpecBuilder (#651).
• REFACTOR: Rename WidgetModifiersData to WidgetModifiersConfig (#649).
• REFACTOR: Fix deprecations and modernize codebase (#647).
• REFACTOR: Remove NestedStyleAttribute and migrate to direct Style usage (#644).
• REFACTOR: Deprecate MixWidgetStateController (#586).
• REFACTOR: Use WidgetState instead of MixWidgetState (#582).
• FIX: Change Mixable to extend EqualityMixin instead of StyleElement (#648).
• FIX: CopyWith overriding bug (#622).
• FEAT: builder optimization (#629).
• FEAT: deprecate styled widgets in favor of new naming conventions (#619).
• FEAT: Implementing duration extension for int (#634).
• FEAT: Create MixBuilder (#581).
• FEAT: Add generated style-focused modifiers and specs (#652).
• FEAT: Unify SpecUtility, Style, and Attributes as compatible values (#643).
• FEAT: Add utilities for animatedData (#660).
• FEAT: Add focused style classes for spec utilities (#677)

1.6.0

• REFACTOR: Rename MixableProperty to MixableType (#574)
• REFACTOR: mix generator clean up and mix semantic changes (#569)
• CHORE: Update min version compatibility (#572)

1.5.4

• FEAT: Accordion interaction based on open variable (#546).

1.5.3

• REFACTOR: Solve dcm lint issues (#519).
• FIX: Order of modifiers implementation on Box, Image and Text (#529).
• FIX: reset modifiers and modifiers when using fluentAPI (#482).
• FEAT: Add spring curve (#503).
• FEAT: Create StrokeAlignUtility (#496).
• FEAT: Utilities for text height behavior (#495).
• FEAT: Rewrite FlexBox as a Mix's primitive component (#517).
• FEAT: Add SpecConfiguration (#483).
• DOCS: Add section for TokenResolver (#537).

mix - v1.5.2

• REFACTOR: ShapeBorder merge (#490).
• FEAT: Improve error messages (#491).
• FEAT: add error state to MixWidgetState (#489).

mix - v1.5.1

• FEAT: Add MixOutlinedBorder (#487).

1.5.0

• FIX: Update OnBrightnessVariant to use MediaQuery instead of Theme (#471).
• FIX: Style when merged with an AnimatedStyle should generate an AnimatedStyle (#472).
• FEAT: Create a specific utility to Transform.translate (#484).
• FEAT: Add more modifiers to Colors (#477).
• FEAT: implement a way to clear inline modifiers (#478).
• FEAT: Fluent API (#475).

1.4.6

• FIX(docs): fix fn level docs for Style::applyVariants (#460).
• FIX: Shadow list animation (#445).
• FIX: SpecModifiers were taking a long time to animate. (#457).
• FEAT: Create mouse cursor Decorator (#263).
• FEAT: Add parameter onEnd for AnimatedStyle (#458).
• FEAT: SingleChildScrollView widget modifier (#427).
• FEAT: Remix improvements and further improvements (#410).

1.4.5

• FIX: HitTestBehavior when there is an Interectable in the tree (#437).
• FEAT: Create a specific utility to Transform.rotate (#434).
• FEAT: TargetPlatform and web variants (#431).

1.4.4

• FIX: Pressable disposes controller only if it creates it (#424).

1.4.3

• FIX: Breakpoint utility merge exception (#421).

1.4.2

• FIX: FlexSpecWidget prioritizes the direction in spec (#414).

1.4.1

• FIX: Added missing widget state utilities (#411).
• FIX: Correct handling of individual border sides (#408).
• DOCS: improve mix theme data features explanations (#404).

1.4.0

• FEAT: Code generation for Widget Modifiers (#396).
• FEAT: Ability to pass MixWidgetStateController to SpecBuilder (#391).
• FEAT: Interactive widget state by default (#384).
• FEAT: MixThemeData can alter default order of modifiers (#380).
• FEAT: Dto utility generation now adds constructor and static methods (#377).
• FEAT: ColorSwatchToken and other token improvements (#378).
• REFACTOR: Code gen more lint friendly dart code (#399).
• FIX: Gestures propagation for GestureMixStateWidget (#394).
• FIX: Normalization of order of modifier when applied to a Styled Widget (#389).
• FIX: Animations of Stack and Flex (#388).
• FIX: Review the order of modifiers adding FlexibleModifier, PaddingModifier, and RotatedModifier (#379).

1.3.0

• REFACTOR: unpressDelay uses timer instead of future
• REFACTOR: bump min flutter version to 3.19.0 (#365).
• FEAT: added modifiers per spec (#333).
• FEAT: add attribute to fontVariantion (#371).

1.2.0

• FIX: Exception when there is no children on flex (#345).
• FIX: Added remaining params to callable specs and modifiers (#332).
• FIX: Gap resolve SpaceToken in flex attribute (#327).
• FIX: mix - Improved merge behavior between ShapeDecoration and BoxDecoration (#316).
• FEAT: pressable supports keyboard events (#346).

1.1.3

• Improved merge behavior between ShapeDecoration and BoxDecoration
• Fixed space token resolve on gap in flex attribute
• Added remaining params to callable specs and modifiers

1.1.2

• Chore: Changed the class modifier of the Spec class for code generation.

1.1.1

• Fixed some specs not respecting nested animated.
• Added call build method to specs.

1.1.0

• Mix now uses mix_generator for Spec and Dto generation.
• Added missing utilities for IconSpec and ImageSpec.
• Added missing ShapeBorders.
• Improved ShapeBorderDto merge behavior.
• Bumped minimum Dart SDK to 3.0.6.
• Added animated utility to Spec.

1.0.0

• Revamped Mix API for improved functionality and developer experience.
• Enhanced performance and system responsiveness.
• Broadened test coverage for greater reliability.
• Extensive bug fixes for increased stability.
• Too many things to list; view our docs for more info.

Visit our documentation site for more information https://fluttermix.com

0.0.7

• Performance improvements.
• Bug fixes #59 by @bdlukaa.
• InheritedAttribute - Custom Mix attributes #94 by @pbissonho.

0.0.6

• Refactored MixTheme & Context Tokens.
• ZBox Widget by @.
• Headless Widgets (Experimental).
• Lots of bug fixes and performance improvements.

0.0.5

• Adjustments on Mix helper for applying variants and attributes.

0.0.4

• Optimization improvements.
• Added clip decorator.
• Fixed some bugs.

0.0.3

• Global Mix for reusability of design tokens and mixes across DS.
• withMix utility to add nested mixes and combine them.
• Attribute modifiers, create attributes that modify a widget value.

0.0.2

• Added screen size dynamic attribute.
• Added device orientation dynamic attribute.

0.0.1

• Initial release.