NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
pub.dev
pub.dev, #1714 most downloaded on pub.dev
Flutter widgets and themes implementing the current macOS design language.
Latest stable
2.2.2
Last release 1 years ago
19 Oct 2025
Release timing varies
gaps range from 8 days to 4 months
Nearly every release is documented
notes for 60 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
6 years old
92 releases · first in 2021
Drag across the ruler to compare, or tap a release to open it.
Latest from dev by @GroovinChip in #517
MacosPulldownMenuItem.onTap doesn't open alert dialog by @TahaTesser in #520Full Changelog: 2.1.0...2.2.2
Your coding agent can read these notes before it upgrades. Set up the MCP server →
MacosPulldownMenuItem.onTap doesn't open alert dialog by @TahaTesser in https://github.com/macosui/macos_ui/pull/520Full Changelog: https://github.com/macosui/macos_ui/compare/2.1.0...2.2.2
Add support for Swift package manager.
Make text field cursor color follow the user’s accent color if not explicitly set (thanks, @driftwoodstudio).
AccentColorListener class to macos_ui users.Fix incorrect highlighting and focusing behavior of _MacosPopupMenuItemButton.
_MacosPopupMenuItemButton.Fixed shownByDefault not being respected for the left sidebar of the MacosWindow (thanks, @ShayperCool).
shownByDefault not being respected for the left sidebar of the MacosWindow (thanks, @ShayperCool).Expose WindowMainStateListener and implement overrideIsMainWindow method to allow for the window’s main state to be overridden.
WindowMainStateListener and implement overrideIsMainWindow method to allow for the window’s main state to be overridden.add section parameter to SidebarItem to display an unclickable widget in the sidebar as a section header (thanks, @whirlun).
section parameter to SidebarItem to display an unclickable widget in the sidebar as a section header (thanks, @whirlun).showMacosSheet when dark mode is enabled.Migrate to Flutter’s new Color API.
Fix incorrect barrier color when calling showMacosAlertDialog when dark mode is enabled.
showMacosAlertDialog when dark mode is enabled.Fix ToolbarOverflowButton only reacting to every second click.
ToolbarOverflowButton only reacting to every second click.Add “Older macOS versions” section to README
Package validation found the following error:
* pubspec.yaml allows Flutter SDK version 1.9.x, which does not support the flutter.plugin.platforms key.
Please consider increasing the Flutter SDK requirement to ^1.10.0 (environment.sdk.flutter)
Add expandDisclosureItems flag to SidebarItem to optionally (default not changed) expand disclosure items initially
expandDisclosureItems flag to SidebarItem to optionally (default not changed) expand disclosure items initiallyFixed SidebarItem text overflowing.
SidebarItem text overflowing.Made most widgets aware of the user’s accent color and window state by adding respective fields to MacosThemeData.
MacosThemeData.MacosCheckbox has received a facelift to mimic the look and feel of native macOS checkboxes better.Implemented value equality for MacosThemeData.
MacosThemeData.Fixed MacosRadioButton check null value issue.
MacosRadioButton check null value issue.Version 12.2.2 by @GroovinChip in #382
2.0.0 by @GroovinChip in #463Full Changelog: 2.0.0...2.0.2
2.0.0 by @GroovinChip in https://github.com/macosui/macos_ui/pull/463Full Changelog: https://github.com/macosui/macos_ui/compare/2.0.0...2.0.2
RelevanceIndicator has been deprecated
macos_ui has been migrated to utilize macos_window_utils under the hood, which provides the following benefits:
Support for Flutter 3.10 and Dart 3
PushButton has been updated to support the ControlSize enum.
buttonSize property has been changed to controlSize.PushButton.isSecondary is now PushButton.secondary.
MacosAlertDialog: primaryButton and secondaryButton are now declared to be of type PushButton.
RelevanceIndicator has been deprecated
MacosTypography white and black are now factory constructors called darkOpaque() and lightOpaque() to reflect
Apple's naming conventions.
MacosSwitch has been completely rewritten and now matches the native macOS switch in appearance and behavior.ControlSize enum has been introduced, which will allow widgets to more closely match their native counterparts.MacosTypography
MacosTypography.of(context) as a shorthand for retrieving the typography used in your MacosTheme.MacosFontWeight allows using Apple-specific font weights like w510, w590, and w860.weekdayAbbreviations and monthAbbreviations to MacosDatePicker.dateFormat to MacosDatePicker.startWeekOnMonday to MacosDatePicker.MacosColor has been updated with some previously missing elements.PushButton
body text style instead of the incorrect headlinePushButton's secondary and disabled colors more closely match their native counterparts.MacosCheckbox appearance more closely matches its native counterpart.MacosAlertDialog
primaryButton and secondaryButton are now required to have controlSizes of ControlSize.large.appIcon should be of size 64x64.Toolbar now uses the correct title3 text style instead of the incorrect headlineMacosTheme sets the global typography more efficientlyHelpButton now sizes itself according to specificationResizablePane can now disallow the usage of its internal scrollbar via the ReziablePane.noScrollBar constructor.MacosDatePicker has better UXToolBars in use where a SideBar is not present will now have their title's avoid the traffic lights (native window controls).MacosTypography.darkOpaque() and MacosTypography.lightOpaque() now conform to specification by using MacosColors.labelColormacos_window_utils codeFull Changelog: 1.12.2...2.0.0
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
Version 1.12.1 by @GroovinChip in #375
Full Changelog: 1.12.1...1.12.2
Full Changelog: https://github.com/macosui/macos_ui/compare/1.12.1...1.12.2
fix(docs): Remove "+" character from example by @cbenhagen in #363
Full Changelog: 1.12.1...1.12.1+1
Full Changelog: https://github.com/macosui/macos_ui/compare/1.12.1...1.12.1+1
MacosDatePicker.release: Version 1.11.1 by @GroovinChip in #367
1.11.1 by @GroovinChip in #367Full Changelog: 1.12.0...1.12.1
1.11.1 by @GroovinChip in https://github.com/macosui/macos_ui/pull/367Full Changelog: https://github.com/macosui/macos_ui/compare/1.12.0...1.12.1
feat: Sliver toolbar by @GroovinChip in #368
Full Changelog: https://github.com/macosui/macos_ui/compare/1.11.1...1.12.0
feat: update flutter_analysis workflow by @GroovinChip in #356
flutter_analysis workflow by @GroovinChip in #356Full Changelog: 1.10.0...1.11.1
flutter_analysis workflow by @GroovinChip in https://github.com/macosui/macos_ui/pull/356Full Changelog: https://github.com/macosui/macos_ui/compare/1.10.0...1.11.1
MacosSearchField would not perform an action when an item was selected.feat: implement MacosDisclosureButton by @Umar1312 in #326
MacosDisclosureButton by @Umar1312 in #326Full Changelog: 1.9.1...1.10.0
MacosDisclosureButton by @Umar1312 in https://github.com/GroovinChip/macos_ui/pull/326Full Changelog: https://github.com/GroovinChip/macos_ui/compare/1.9.1...1.10.0
🚨 Breaking Changes 🚨
MacosScrollbar has been completely overhauled and now resembles the native macOS scrollbar in appearance and
behavior. Previously, it wrapped the material scrollbar, and now creates a custom scrollbar that extends
RawScrollbar. This resulted in the removal of several material-based properties for the scrollbar, and
ContentArea.builder is once again a ScrollableWidgetBuilder! 🎉MacosScrollbarThemeDataOther changes:
MacosDisclosureButtonCapacityIndicator only worked correctly for splits = 10Adds intialDate to MacosDatePicker by @Luckey-Elijah in https://github.com/GroovinChip/macos_ui/pull/329
intialDate to MacosDatePicker by @Luckey-Elijah in https://github.com/GroovinChip/macos_ui/pull/329Full Changelog: https://github.com/GroovinChip/macos_ui/compare/1.9.0...1.9.1
Various bug fixes & minor updates by @GroovinChip in https://github.com/GroovinChip/macos_ui/pull/338
MacosSlider by @Norbert515 in https://github.com/GroovinChip/macos_ui/pull/337Full Changelog: https://github.com/GroovinChip/macos_ui/compare/1.7.6...1.9.0
fix: address ScrollController bug in MacosPopupButton by @GroovinChip in https://github.com/GroovinChip/macos_ui/pull/300
Full Changelog: https://github.com/GroovinChip/macos_ui/compare/1.7.5...1.7.6
MacosPopupButton would report that a ScrollController was not attached to any viewsFull Changelog: https://github.com/GroovinChip/macos_ui/compare/1.7.3...1.7.5
Full Changelog: https://github.com/GroovinChip/macos_ui/compare/1.7.3...1.7.5
Tab view padding by @stMerlHin in https://github.com/GroovinChip/macos_ui/pull/285
backgroundColor to MacosSheet by @GroovinChip in https://github.com/GroovinChip/macos_ui/pull/291Full Changelog: https://github.com/GroovinChip/macos_ui/compare/1.7.1...1.7.4
Tab view padding by @stMerlHin in https://github.com/GroovinChip/macos_ui/pull/285
backgroundColor to MacosSheet by @GroovinChip in https://github.com/GroovinChip/macos_ui/pull/291Full Changelog: https://github.com/GroovinChip/macos_ui/compare/1.7.1...1.7.3
title property of TitleBar did not apply a fitting DefaultTextStyleFixed an issue where end sidebar window breakpoints were not respected
Version 1.7.0: MacosImageIcon & sidebar updates by @GroovinChip in https://github.com/GroovinChip/macos_ui/pull/274
MacosImageIcon & sidebar updates by @GroovinChip in https://github.com/GroovinChip/macos_ui/pull/274Full Changelog: https://github.com/GroovinChip/macos_ui/compare/1.4.1...1.7.0
MacosImageIcon widget. Identical to the ImageIcon from flutter/widgets.dart except it will obey a
MacosIconThemeData instead of an IconThemeDataSidebarItemSize enum, which determines the height of sidebar items and the maximum size their leading widgets.SidebarItem now accepts an optional trailing widget.SidebarItems now supports SidebarItemSize via the itemSize property, which defaults to
SidebarItemSize.medium. The widget has been updated to manage the item's height, the maximum size of the item's
leading widget, and the font size of the item's label widget according to the given SidebarItemSize.MacosImageIcon widget.Fixup by @GroovinChip in https://github.com/GroovinChip/macos_ui/pull/256
Full Changelog: https://github.com/GroovinChip/macos_ui/compare/1.4.1...1.5.1
* Adds endSidebar to MacosWindow
endSidebar to MacosWindowUpdate pubspec.yaml with repository and new homepage field.
pubspec.yaml with repository and new homepage field.Fixes an issue where if the app was displayed in full screen mode, an opaque empty toolbar would appear at the top #249
Minimum dart sdk version is now 2.17.0
flutter_lints: ^2.0.1 with subsequent fixesMacosScrollbar API more closely matches its material counterpartMacosColor to more closely match the Color class
MacosColor.fromARGB constructorMacosColor.fromRGBO constructoralphaBlend functiongetAlphaFromOpacity functionTweak the default primaryColor value in MacosThemeData.
top property to SidebarprimaryColor value in MacosThemeData.Fixes issue with error thrown when toolbar actions are modified programmatically #239
### Included in this release: * #234
MacosTooltip:
ToolBarDivider that can be used as a divider (vertical/horizontal line) in the ToolBar #231.tooltipMessage property to display a MacosTooltip when user hovers over them #232.Minor updates to the readme & sample app
New functionality for MacosSearchField
MacosSearchField
MacosOverlayFilter widget can now be used to apply the blurry "frosted glass" effect on surfaces.CustomToolbarItem that enables any widget to be used in the Toolbar.Minor documentation fix for [MacosColorWell]
* First stable release 🎉
version 0.15.0 - Adds MacosColorWell by @GroovinChip in https://github.com/GroovinChip/macos_ui/pull/211
0.15.0 - Adds MacosColorWell by @GroovinChip in https://github.com/GroovinChip/macos_ui/pull/2110.16.0 - MacosTimePicker by @GroovinChip in https://github.com/GroovinChip/macos_ui/pull/214* New widget: MacosColorWell
MacosColorWellBreaking change: the title bar (TitleBar) should now be set via the titlebar property of MacosWindow (was previously a property of MacosScaffold). If…
ToolBar, which can be used to create a toolbar at the top of the MacosScaffold. Toolbar items include ToolBarIconButton, ToolBarPulldownButton, and ToolBarSpacer widgets.MacosSearchField, which creates a macOS-style search field.TitleBar) should now be set via the titlebar property of MacosWindow (was previously a property of MacosScaffold). If you are using a title bar in your app, please note a small change you would need to make in your macos/Runner/MainFlutterWindow.swift file, described in the "Modern window look" section of the README file.MacosDatePicker having an incorrect current day text color in light themeMinor style fixes for MacosTextField
MacosTextField* Switch over to flutter_lints
flutter_lintsMove theme classes to their own files in the /theme directory
/theme directoryImprove visual design of MacosPopupButton and MacosPulldownButton, to better match the styling and translucency effect of Apple design.
MacosPopupButton and MacosPulldownButton, to better match the styling and translucency effect of Apple design.MacosPopupButtonAdds missing merge methods to MacosThemeData and widget ThemeData classes, making it possible to use them properly with any number of user-provided cu
merge methods to MacosThemeData and widget ThemeData classes, making it possible to use them properly with any number of user-provided custom properties.One column per quarter.