icefelix_window_manager 0.2.0

Window management for Flutter desktop apps. Size, position, state, multi-monitor, frameless, events. macOS today; Windows + Linux next.

icefelix_window_manager

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

⚠️ Pre-release: v0.1.0-dev.3. Native implementations land in W2 (macOS ✅), W3 (Windows), W4 (Linux). v0.1.0 stable ships ~26 June 2026. The Dart API in this dev release is the final shape.

Platform support

macOS	Windows	Linux (X11)	Linux (Wayland)
✅ v0.1.0-dev.3	⏳ W3	⏳ W4	⏳ W4

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:

[10 polygon-shaped counter windows running side by side]

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)),
]);

Status

This is W2 (macOS native impl complete). See project tracker for Windows + Linux progress.

License

BSD-3-Clause © 2026 icefelix.com — Alex Bordei [e-mail]