Skip to content
pubscout

macos_ui

2.2.2, released a year ago by macosui.dev

Flutter widgets and themes implementing Apple's modern macOS design language.

Flutter FavoriteQuiet but busy
$ flutter pub add macos_ui
Source repository

What it does

macos_ui provides a comprehensive suite of native-styled macOS widgets, layouts, and controls for Flutter applications. It includes components like MacosWindow, Sidebar, ToolBar, MacosScaffold, and native input elements that adhere to Apple's Human Interface Guidelines. It also integrates native window styling via macos_window_utils to emulate the modern macOS Big Sur and newer appearance.

AI-written summary of version 2.2.2, based on the package's README and metadata. Report an inaccuracy

Use it when

  • Building a desktop Flutter application specifically targeting macOS with a native look and feel.
  • You need native macOS layouts including unified toolbars, sidebars, sheets, and dialogs.
  • You want system-aligned styling like user accent colors and window main state detection.

Skip it when

  • Targeting platforms other than macOS, as native features and colors will not work reliably.
  • Building an app designed around Material or a non-platform-specific design language.

Strengths

  • Extensive collection of macOS-specific widgets ranging from windows and toolbars to pickers and indicators.
  • Supports modern macOS design paradigms (macOS 11+) including unified and expanded toolbar styles.
  • Integrates native system attributes such as user accent colors and window focus states.

Weaknesses

  • Requires a minimum macOS deployment target of 10.14.6 and Xcode project configuration.
  • Not intended for non-macOS platforms, where features like MacosColorWell and accent colors fail.

Setup

Kind
Plugin (native code)
Effort
Medium
Code generation
No
Direct dependencies
5

Requires setting the macOS deployment target to 10.14.6 or higher in Xcode/Podfile, initializing MacosWindowUtilsConfig in main(), and running on Flutter 3.35.0+.

MacosWindow(
  sidebar: Sidebar(
    minWidth: 200,
    builder: (context, scrollController) {
      return SidebarItems(
        currentIndex: 0,
        scrollController: scrollController,
        itemSize: SidebarItemSize.large,
        onChanged: (i) {},
        items: const [
          SidebarItem(label: Text('Page One')),
          SidebarItem(label: Text('Page Two')),
        ],
      );
    },
  ),
  child: const MacosScaffold(
    children: [
      ContentArea(
        builder: (context, scrollController) => Center(
          child: Text('Hello macOS'),
        ),
      ),
    ],
  ),
)

Alternatives

Packages that do the same job and could replace macos_ui.

  • cupertino_ui

    Official Flutter Cupertino design library implementing Apple HIG iOS and macOS user interfaces.

  • material_ui

    Official Flutter Material UI library implementing Google’s Material Design system.

  • flutter_carbon

    A comprehensive Flutter implementation of IBM's Carbon Design System V11. Features 48 components, 4 theme variants, and seamless Material Design integration.

  • bottom_navy_bar

    A beautiful, animated bottom navigation bar widget for Flutter.

Works with

Packages commonly used together with macos_ui: ones it builds on, ones built on it, and its own family.