Skip to content
pubscout

flutter_omarchy

0.3.0, released 3 months ago by aloisdeniel.com

UI toolkit and theming system designed for the Omarchy Arch Linux desktop environment.

$ flutter pub add flutter_omarchy
Source repository

What it does

Provides a comprehensive set of terminal-styled widgets and overlays matching the Omarchy aesthetic. Automatically reads system color palettes and Alacritty configs from local files to synchronize theme changes in real time. Also supports running on other platforms by falling back to a default Tokyonight theme.

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

Use it when

  • Building Flutter desktop applications specifically targeting the Omarchy Arch Linux setup
  • Creating applications with a minimalist, terminal-inspired keyboard-friendly desktop aesthetic
  • Needing real-time integration with local Linux system theme files without app restarts

Skip it when

  • Building mainstream consumer mobile apps that require standard Material or Cupertino design
  • Needing an enterprise-tested, highly stable production UI framework (package is in early development with unstable APIs)

Strengths

  • Rich collection of specialized desktop widgets (split panels, command panels, context menus, status bars)
  • Automatic hot-reloading of themes from system TOML files and signals
  • Cross-platform fallback to Tokyonight theme for testing outside Linux

Weaknesses

  • Under active early development with self-admitted unstable APIs
  • Requires manual adjustments to Linux GTK runner code to eliminate title bars or black startup windows

Setup

Kind
Flutter widgets
Effort
Medium
Code generation
No
Direct dependencies
1

Requires `await Omarchy.initialize()` in main. Linux deployment may require manual modifications in linux/runner/my_application.cc to hide titlebars and prevent black startup windows.

import 'package:flutter_omarchy/flutter_omarchy.dart';

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

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return OmarchyApp(
      home: OmarchyScaffold(
        child: Center(
          child: OmarchyButton(
            onPressed: () {},
            child: Text('Hello Omarchy!'),
          ),
        ),
      ),
    );
  }
}

Alternatives

Packages that do the same job and could replace flutter_omarchy.

Works with

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