Skip to content
pubscout

macos_window_utils

1.9.1, released 11 months ago by macosui.dev

Provides Dart APIs to control macOS NSWindow properties and behavior.

$ flutter pub add macos_window_utils
Source repository

What it does

The plugin lets Flutter apps modify the macOS window—size, title bar, transparency, toolbar, and button visibility. It also offers delegate callbacks for window events.

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

Use it when

  • You need fine‑grained control over a macOS app window
  • You want to hide the title bar or make the window transparent
  • You need to react to window events like resize or fullscreen

Skip it when

  • Your app targets platforms other than macOS
  • You only need cross‑platform window handling

Strengths

  • Comprehensive macOS window API coverage
  • Simple Dart‑only calls for native features
  • Includes example project and widgets for safe area handling

Weaknesses

  • macOS‑only, no iOS/Android support
  • Requires native Xcode configuration and deployment‑target changes

Setup

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

Add the plugin, then open macOS Runner.xcworkspace, set Deployment Target ≥10.14.6, and adjust Podfile platform line. Call WindowManipulator.initialize() before runApp().

Future<void> main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await WindowManipulator.initialize();
  runApp(MyApp());
}

// later in UI
WindowManipulator.makeTitlebarTransparent();
WindowManipulator.enableFullSizeContentView();

Alternatives

Packages that do the same job and could replace macos_window_utils.

Works with

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