Skip to content
CAI
Software that uses CAICheck a score

macosui/macos_ui

59.8

Adequate · 13 November 2026

24.5k

lines of production code

Dart

primary language

8

measurements over time

CAI band scale
CAI trend line
CAI lens gauges

What this system is

This system is a Flutter library that provides a comprehensive suite of macOS-style UI components, enabling developers to build applications with native Apple aesthetics and behavior. It implements core interface elements such as buttons, text fields, dialogs, and complex layout structures like sidebars and toolbars, while also offering specialized controls for date, time, and color selection. The library integrates deeply with the macOS platform by exposing native window management utilities, system accent color listeners, and wallpaper tinting capabilities to ensure visual consistency with the operating system.

How it got here

2021 — macOS UI component library expansion

27 changes.

The project focused on building a comprehensive macOS-native UI component library, introducing new widgets for buttons, fields, indicators, and layout scaffolding. This period also involved integrating native macOS window management utilities, refining the theming system, and establishing a robust test infrastructure to verify the new components.

2022–2025 — macOS-style widget library expansion

12 changes.

This period focused on expanding the library with comprehensive macOS-style UI components, including date, time, and color selectors, toolbar and sidebar navigation layouts, and tab views. It also introduced native system integrations for accent colors and window state, alongside corresponding test coverage and utility listeners to support these new features.

Features

Add MacosSheet component with customizable background color

Introduces the new MacosSheet widget and showMacosSheet helper function, providing a modal dialog attached to the window that prevents interaction until dismissed. Users can now customize the sheet's appearance via an optional backgroundColor parameter, which defaults to a brightness-aware system color, and control the animation behavior for keyboard intrusions using insetAnimationDuration and insetAnimationCurve.

lib/src/sheets · high confidence

Add macOS-style Label and Tooltip widgets

Introduces new \Label\ and \MacosTooltip\ components in the \lib/src/labels\ directory. The \Label\ widget displays static text with optional leading icons and trailing children, styled using the current macOS theme typography and dynamic colors. The \MacosTooltip\ widget provides contextual help messages that appear on mouse hover or long press, featuring fade-in/out animations, configurable display durations, and support for mouse position tracking.

lib/src/labels · high confidence

Add macOS-style indicators and slider

This change introduces a new set of UI components in the \lib/src/indicators\ directory, including \MacosSlider\, \CapacityIndicator\, \ProgressCircle\, \ProgressBar\, \RatingIndicator\, and the deprecated \RelevanceIndicator\. These widgets provide macOS-style visual feedback for progress, capacity, ratings, and value selection, with support for discrete and continuous modes, custom theming, and semantic accessibility labels.

lib/src/indicators · high confidence

Add macOS-style tab view and tab components

This change introduces a new set of macOS-style UI components for managing multi-page interfaces: \MacosTabView\, \MacosTab\, and \MacosTabController\. \MacosTabView\ provides a container that displays one page at a time, supporting configurable tab positions (top, bottom, left, right) and customizable padding. It relies on \MacosTabController\ to coordinate selection state between the navigational tabs (\MacosTab\) and the content views. The tabs themselves are styled as macOS-style navigational buttons with specific border radii and active/inactive color states derived from the current theme brightness.

_lib/src/layout/tab\view · high confidence

Added AccentColor and ControlSize enums

New enums \AccentColor\ and \ControlSize\ have been added to the library. \AccentColor\ exposes the macOS system accent colors (blue, purple, pink, red, orange, yellow, green, graphite) that users can select in System Settings. \ControlSize\ defines standard sizes (mini, small, regular, large) for controls, noting that not all controls support every size and will fall back to the nearest supported one.

lib/src/enums · high confidence

Added macOS-style text title widgets

The example gallery now includes two new reusable widgets, WidgetTextTitle1 and WidgetTextTitle2, which render text with macOS system styling. These widgets apply a semi-transparent gray background with rounded corners and use the JetBrains Mono font family for their respective title styles, providing consistent visual components for displaying widget names in the gallery.

example/lib/widgets · high confidence

Introduce macOS-style layout primitives and window scaffolding

This change adds a new set of layout widgets to \lib/src/layout\ that provide a native macOS windowing experience. It introduces \MacosWindow\ as the root container, supporting optional left and right sidebars, a \TitleBar\, and wallpaper tinting via \WallpaperTintedArea\. Inside the window, \MacosScaffold\ manages the main content area and allows for resizable panes (\ResizablePane\) with configurable minimum/maximum sizes and scrollbars (\MacosScrollbar\). The package also includes \MacosListTile\ for list items and \ContentArea\ to fill the remaining space in the scaffold.

lib/src/layout · high confidence

Introduce wallpaper tinting settings and macOS window configuration utilities

This change adds a new \wallpaper\_tinting\_settings\ subsystem to manage global wallpaper tinting behavior, including a \GlobalWallpaperTintingSettings\ singleton, a \WallpaperTintingSettingsBuilder\ widget for reactive updates, and a \WallpaperTintingOverride\ widget to temporarily disable tinting (e.g., for overlays). It also introduces \MacosWindowUtilsConfig\ to configure macOS window properties such as toolbar style, title bar transparency, and full-screen behavior via \WindowManipulator\. Additionally, \lib/src/library.dart\ is added to re-export specific Flutter classes, and the placeholder \lib/src/macos\_ui.dart\ is removed.

lib/src · high confidence

Introduction of macOS-style Search and Text Field widgets

The \lib/src/fields\ directory now includes \MacosSearchField\ and \MacosTextField\, providing macOS-native input components. \MacosSearchField\ allows users to enter search queries and select from a dropdown overlay of \SearchResultItem\s, supporting customization of result counts, heights, and empty states. \MacosTextField\ offers a standard text input with macOS styling, including rounded borders, focus decorations, placeholder support, and overlay visibility modes for actions like clearing text.

lib/src/fields · high confidence

Introduction of macOS-style Sidebar navigation components

This change introduces a new set of widgets for macOS-style sidebar navigation within the application. The \Sidebar\ widget provides a resizable, scrollable side panel that integrates with the \MacosScaffold\, featuring configurable width constraints, drag-to-close behavior, and optional top/bottom content slots. The \SidebarItems\ widget renders a list of \SidebarItem\ components, supporting selection states, section headers, and disclosure (expandable) items. A key behavioral addition is the dynamic color adaptation: selected item colors now automatically adjust based on the user's system accent color and whether the window is the main active window, ensuring visual consistency with the macOS theme.

lib/src/layout/sidebar · high confidence

Native macOS color picker integration

The macOS plugin now exposes a native color picker via the \dev.groovinchip.macos\_ui/color\_panel\ event channel. Users can invoke the system \NSColorPanel\ through the \color\_panel\ method call, specifying a picker mode (such as RGB, HSB, CMYK, or wheel), and receive real-time color updates as events. A privacy manifest has also been added to declare that no data is tracked or collected.

macos · high confidence

New MacosIcon and MacosImageIcon widgets for macOS-style icons

This change introduces two new widgets in the icon library: MacosIcon for displaying font-based glyphs and MacosImageIcon for displaying image-based icons. Both widgets respect the ambient MacosIconTheme for sizing, coloring, and opacity, and include support for semantic labels for accessibility. MacosIcon also handles text direction for icons that should flip in RTL environments.

lib/src/icon · high confidence

The example application now includes dedicated demo pages for Buttons, Colors, Dialogs, Fields, Indicators, Resizable Panes, Selectors, Sliver Toolbars, Tab Views, and Toolbars. These pages showcase the visual appearance and interactive behavior of the corresponding macOS UI widgets, such as PushButton sizes, system color swatches, alert dialog configurations, text and search fields, progress indicators, and various toolbar layouts.

example/lib/pages · high confidence

New macOS-specific utility listeners for accent color and window state

The \lib/src/utils\ directory now includes dedicated listeners for macOS system behaviors: \AccentColorListener\ exposes a stream that notifies when the user changes their system accent color, allowing apps to update UI colors in real-time; \WindowMainStateListener\ provides a stream indicating whether the application's window is currently the main (focused) window, enabling features like muting UI elements when the app loses focus; and \MacOSBrightnessOverrideHandler\ ensures the macOS window's brightness setting matches the app's current theme. These utilities are exported via \utils.dart\ for easy access.

lib/src/utils · high confidence

New macOS-style alert dialog component

Introduces \MacosAlertDialog\, a new widget that displays a macOS-styled alert dialog featuring an app icon, centered title and message, and primary/secondary action buttons. The component supports horizontal or vertical button layouts and includes an optional 'suppress' widget for implementing 'Don't ask again' functionality, along with theme-aware border colors and typography.

lib/src/dialogs · high confidence

New macOS-style button and selection widgets

This change introduces a new set of macOS-style UI components in the \lib/src/buttons\ directory, including \MacosBackButton\, \MacosCheckbox\, \MacosDisclosureButton\, \HelpButton\, \MacosIconButton\, \MacosPopupButton\, \MacosPulldownButton\, \PushButton\, \MacosRadioButton\, and \MacosSegmentedControl\. These widgets provide native-looking controls for navigation, selection, and actions, featuring specific styling, hover effects, and animations consistent with the macOS design language.

lib/src/buttons · high confidence

New macOS-style date, time, and color selection controls

This change introduces a suite of new selector widgets in the \lib/src/selectors\ directory, bringing macOS-native selection experiences to Flutter apps. The \MacosDatePicker\ allows users to choose dates via textual inputs with customizable formats and abbreviations, or through a graphical calendar view, supporting both Monday and Sunday week starts. The \MacosTimePicker\ offers similar textual and graphical (clock-face) modes for selecting time, including AM/PM handling. Additionally, the \MacosColorWell\ widget enables users to pick colors by opening the native macOS \NSColorPanel\. These components are supported by new internal utilities, including \CaretPainter\ for textual picker controls, \KeyboardShortcutRunner\ for arrow-key navigation, and \GraphicalTimePickerPainter\ for rendering the clock interface.

lib/src/selectors · high confidence

New themeable components and refined macOS styling

The theme library now includes dedicated theme widgets and data classes for several new or updated components, allowing you to customize their appearance globally or locally: \MacosDatePickerTheme\ for date pickers, \HelpButtonTheme\ for help buttons, \MacosIconButtonTheme\ for icon buttons, \MacosPopupButtonTheme\ for popup menus, and \MacosPulldownButtonTheme\ for pulldown menus. Additionally, \MacosIconTheme\ provides centralized control over icon color, opacity, and size, while \MacosColors\ and \MacosDynamicColor\ offer a comprehensive set of macOS system colors with dynamic resolution support. The \MacosOverlayFilter\ widget introduces a frosted-glass blur effect for overlays, and \PushButtonTheme\ is deprecated as push buttons no longer use singular themeable colors.

lib/src/theme · high confidence

New toolbar button components with overflow handling and tooltips

This change introduces three new widget classes for the macOS-style toolbar: \ToolBarIconButton\, \ToolBarPullDownButton\, and \ToolbarOverflowButton\. \ToolBarIconButton\ allows users to add icon buttons that can display labels and support tooltips, adapting to toolbar width by becoming overflow menu items when space is limited. \ToolBarPullDownButton\ provides a pull-down menu interface within the toolbar, also handling overflow by creating submenus. \ToolbarOverflowButton\ adds a dedicated button to the toolbar's right side to open a menu of all overflowed actions. These components wrap existing Macos UI elements with specific toolbar styling and integrate with \MacosToolbarPassthrough\ for proper macOS window integration.

lib/src/buttons/toolbar · high confidence

New toolbar layout components and overflow handling

The toolbar layout module now includes a suite of new widgets to enhance macOS-style toolbars: \CustomToolbarItem\ allows embedding arbitrary widgets (like search fields) with optional overflow menu entries and tooltips; \SliverToolBar\ provides a sliver-compatible toolbar variant with pinned, floating, and opacity controls for use in scroll views; \ToolBarDivider\ and \ToolBarSpacer\ offer standard spacing and separation utilities; and \OverflowHandler\ along with \ToolbarOverflowMenu\, \ToolbarOverflowMenuItem\, and \ToolbarPopup\ implement the logic for hiding excess items and displaying them in a styled overflow menu with submenu support.

lib/src/layout/toolbar · high confidence

API

Restructured public API exports and added macOS window utilities

The main \macos\_ui.dart\ entry point has been refactored to replace the single re-export of \src/macos\_ui.dart\ with explicit, granular exports for all individual components, themes, and utilities. This change improves import clarity and allows consumers to reference specific widgets and themes directly. Additionally, the library now re-exports \macos\_window\_utils\, integrating native macOS window management capabilities (such as \NSWindowDelegate\) directly into the public API surface.

lib · high confidence

Behavioural changes

The example application has been rebranded from 'example' to 'macOS UI Gallery'. This change updates the macOS bundle identifier to 'dev.macosui.gallery' and the copyright notice to 'Copyright © 2022 dev.macosui'. Additionally, a 'Help' menu item has been added to the macOS application menu, and the project's analysis options now include specific linting rules for super parameters and single quotes.

example · high confidence

Example app restructured with macOS-specific window and menu integration

The example application has been refactored to better demonstrate macOS platform features. It now integrates \macos\_window\_utils\ to properly style and configure the native window on macOS, and implements a native \PlatformMenuBar\ with standard system items (About, Quit, Full Screen, Window controls) that is only active on macOS and disabled on web. The app's root widget has been updated to use \MacosApp\ and \MacosWindow\, and a new \AppTheme\ provider manages the theme mode. The main gallery interface now includes a \MacosSearchField\ in the sidebar for navigation between widget demos.

example/lib · high confidence

Updated base href for macOS UI deployment

The base href in the web application's index.html has been changed from the root path (/) to /macos\_ui/. This adjustment ensures that relative resource paths resolve correctly when the application is served from a subdirectory, which is necessary for the macOS UI deployment context.

example/web · high confidence

Updated iOS build configuration to support CocoaPods

The iOS example project's build configuration files (Debug.xcconfig and Release.xcconfig) have been updated to include the CocoaPods support files. This change enables the use of CocoaPods for dependency management in the iOS example app, alongside the existing Flutter build system. Additionally, the .gitignore file has been updated to exclude Flutter ephemeral directories.

example/ios · high confidence

Updated macOS example to use CocoaPods and register new plugins

The macOS example project now integrates CocoaPods for dependency management, adding the Pods workspace reference and including the generated Pods xcconfig files in the build configuration. Additionally, the generated plugin registrant has been updated to register five new plugins: appkit\_ui\_element\_colors, macos\_ui, macos\_window\_utils, path\_provider\_foundation, and url\_launcher\_macos.

example/macos/Flutter · high confidence

macOS Runner app modernization and configuration updates

The macOS example application has been updated to use the modern @main entry point syntax in AppDelegate.swift and now supports secure restorable state, ensuring better compatibility with macOS session management. Additionally, the app bundle name has been explicitly set to 'Widget Gallery' in Info.plist, and the DebugProfile entitlements have been extended to include network client access, allowing the app to initiate outbound network connections during debugging.

example/macos/Runner · high confidence

macOS example app integrates CocoaPods and updates build configuration

The macOS example project now includes CocoaPods support, adding build phases to check and embed Pods frameworks, linking the Pods\_Runner framework, and referencing the FlutterGeneratedPluginSwiftPackage. The project file version was upgraded to 54, the macOS deployment target was raised from 10.11 to 10.14.6, and the Xcode upgrade check was updated to version 15.1. Additionally, the run scheme now includes a pre-action to prepare the Flutter framework and enables GPU validation mode during debugging.

example/macos/Runner.xcodeproj · high confidence

Test coverage

Added macOS Runner test scaffold; Added test infrastructure for canvas painting verification; Added tests for MacosDatePicker component; Added tests for MacosThemeData and Typography equality; Added theme data tests for multiple macOS UI components; Added widget tests for MacosSearchField and MacosTextField; Added widget tests for MacosTooltip positioning; Added widget tests for buttons and toolbar components; Added widget tests for indicators, scrollbar, and slider; Added widget tests for layout components.

Dependencies

macos\_ui 2.2.3: Dart 3.9+ support, new platform dependencies, and Swift Package Manager integration

The macos\_ui package has been updated to version 2.2.3, raising the minimum SDK requirement to Dart 3.9.2 and Flutter 3.35.0. This release introduces several new direct dependencies: macos\_window\_utils (1.9.0) for window management, gradient\_borders (1.0.2) and appkit\_ui\_element\_colors (1.0.1) for native macOS styling, and equatable (2.0.7) for value equality. It also adds flutter\_lints (6.0.0) and mocktail (1.0.4) to dev dependencies. To support modern macOS development workflows, the package now includes a Package.swift manifest for Swift Package Manager support and a macos\_ui.podspec for CocoaPods integration, alongside updated iOS and macOS Podfiles in the example app.

(dependencies) · high confidence

Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.

How this codebase got here

Score

  • CAI 61 → 60 (-1.5)
  • Rubric changed (rubric-2026.10.5 → rubric-2026.11.3) — scores are not directly comparable.

Lenses

  • Code Health 90 → 90 (+0.0)
  • Architecture 91 → 91 (+0.0)
  • Maturity 49 → 51 (+2.1)
  • Readiness 60 → 58 (-2.1)
  • Security 73 → 59 (-13.5)
  • Performance 100 → 100 (+0.0)

Resolved (3)

  • Duplicated block (13–14 lines × 4) (lib/src/layout/sidebar/sidebar_items.dart)
  • Duplicated block (15 lines × 2) (lib/src/layout/sidebar/sidebar_items.dart)
  • Duplicated block (19 lines × 2) (lib/src/layout/sidebar/sidebar_items.dart)

New (31)

  • Duplicated block (13–14 lines × 4) (lib/src/layout/sidebar/sidebar_items.dart)
  • Duplicated block (15 lines × 2) (lib/src/layout/sidebar/sidebar_items.dart)
  • Duplicated block (19 lines × 2) (lib/src/layout/sidebar/sidebar_items.dart)
  • Edited copies of one member (3 members, 14+ corresponding lines) (lib/src/buttons/checkbox.dart)
  • Edited copies of one member (3 members, 14+ corresponding lines) (lib/src/buttons/push_button.dart)
  • Edited copies of one member (3 members, 25+ corresponding lines) (lib/src/buttons/pulldown_button.dart)
  • Edited copy of a member (10 corresponding lines) (lib/src/buttons/popup_button.dart)
  • Edited copy of a member (11 corresponding lines) (lib/src/buttons/icon_button.dart)
  • Edited copy of a member (11 corresponding lines) (lib/src/buttons/popup_button.dart)
  • Edited copy of a member (12 corresponding lines) (lib/src/buttons/popup_button.dart)
  • Edited copy of a member (12 corresponding lines) (lib/src/indicators/capacity_indicators.dart)
  • Edited copy of a member (16 corresponding lines) (lib/src/theme/date_picker_theme.dart)
  • Edited copy of a member (18 corresponding lines) (example/lib/widgets/widget_text_title1.dart)
  • Edited copy of a member (19 corresponding lines) (lib/src/buttons/popup_button.dart)
  • Edited copy of a member (19 corresponding lines) (lib/src/theme/date_picker_theme.dart)
  • Edited copy of a member (21 corresponding lines) (lib/src/buttons/popup_button.dart)
  • Edited copy of a member (21 corresponding lines) (lib/src/indicators/slider.dart)
  • Edited copy of a member (21 corresponding lines) (lib/src/selectors/date_picker.dart)
  • Edited copy of a member (25 corresponding lines) (lib/src/layout/toolbar/sliver_toolbar.dart)
  • Edited copy of a member (25 corresponding lines) (lib/src/selectors/date_picker.dart)
  • …and 11 more

Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.

Survey your own repository

macosui/macos_ui was measured the same way every project in this corpus was: the same rubric, at a pinned commit, with the result published in full. Point a surveyor at a repository you know and see whether you agree with it.

About this page

  • The score is its most recent published measurement, taken on 13 November 2026 at a pinned commit. It is not a live figure and does not change until the project is measured again.
  • Measured at commit dec19cf6960721f80165ead6c9c19594030b292f — the exact code this score is about.
  • Scored under rubric-2026.11.3 — the same rubric and the same method as every other entry in this index.
  • Measured by Canine Code Analyzer (cca.canine.dev) using cca measure-2026.11.57+preprod-8ebfb01cf4c0.