icefelix_window_manager

Cross-platform window management for Flutter desktop apps. Control your app's own window — size, position, state, multi-monitor, frameless mode, custom shapes, and events — with a type-safe Pigeon-backed API and reactive ValueListenable<WindowSnapshot> as the single source of truth.

v0.3.0 — single package, macOS + Windows native. This release collapses the four federated packages from 0.2.x into one. macOS (Swift + AppKit) and Windows (C++ + Win32) ship inside this package. No more _macos, _windows, or _platform_interface packages to depend on.

Platform support

Installation

flutter pub add icefelix_window_manager

Quick start

import 'package:flutter/material.dart';
import 'package:icefelix_window_manager/icefelix_window_manager.dart';

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await WindowManager.instance.ensureInitialized();
  runApp(const MyApp());
}

API overview

// Reactive UI — single source of truth
ValueListenableBuilder<WindowSnapshot>(
  valueListenable: WindowManager.instance.snapshot,
  builder: (context, snap, _) => Text('${snap.bounds.size}'),
);

// Imperative ops
await WindowManager.instance.setSize(const Size(1024, 768));
await WindowManager.instance.center();
await WindowManager.instance.setAlwaysOnTop(true);

// Multi-monitor
final displays = await WindowManager.instance.displays.list();
await WindowManager.instance.moveToDisplay(displays.last.id);

// Events with exhaustive pattern matching (Dart 3 sealed)
WindowManager.instance.events.listen((event) {
  switch (event) {
    case WindowResizeEvent(:final newSize): print('Resized to $newSize');
    case WindowCloseRequestEvent(:final preventDefault):
      preventDefault();
      // Show dialog, then if confirmed: WindowManager.instance.destroy();
    default: // exhaustive
  }
});

Showcase: polygon-shaped windows

setShape lets the OS window itself be non-rectangular — pixels outside the polygon don't paint AND clicks pass through to the desktop. A small runnable example lives at example/polygon_demo:

await WindowManager.instance.setFrameless(true);
await WindowManager.instance.setShape([
  for (var i = 0; i < 6; i++)
    Offset(180 + 180 * cos(-pi / 2 + i * pi / 3),
           180 + 180 * sin(-pi / 2 + i * pi / 3)),
]);

Migrating from 0.2.x

dependencies: icefelix_window_manager: ^0.3.0 — that's it. If you ever called IcefelixWindowManagerMacos.registerWith() or IcefelixWindowManagerWindows.registerWith() directly, remove those calls. Flutter now auto-registers the plugin via the pubspec pluginClass declarations. Nothing else changes.

Linux roadmap

Linux (X11 + Wayland via libdecor) is planned for v0.4. Track progress on GitHub.

License

BSD-3-Clause © 2026 icefelix.com — Alex Bordei alex.bordei@icefelix.com