Adabraka GPUI

A GPU-accelerated UI framework for Rust, forked from Zed's GPUI. Adabraka GPUI extends the original framework with daemon-mode capabilities, system tray integration, global hotkeys, native notifications, and more — making it suitable for background apps, menu bar utilities, and overlay tools.

Getting Started

adabraka-gpui = "0.4"

Platform Support

Features

Core UI Framework

• Hybrid immediate/retained mode rendering
• GPU-accelerated with Metal, Vulkan, OpenGL, and DirectX backends
• Tailwind-style layout and styling API
• Entity-based state management
• Declarative views with the Render trait
• Low-level Element API for custom rendering
• Async executor integrated with the platform event loop
• Action system for keyboard shortcuts
• Test framework with #[gpui::test]

Daemon & Background App Support

• System tray — icon, tooltip, and nested menus with action callbacks
• Global hotkeys — register system-wide keyboard shortcuts
• Native notifications — OS-level notifications on all platforms
• Overlay windows — always-on-top transparent windows
• Click-through windows — mouse events pass through to windows below
• Window show/hide — programmatic visibility control
• Auto-launch — register your app to start at login
• Single instance — prevent multiple copies with activation signaling
• Keep alive without windows — app runs with no visible windows
• Focused window info — query which window the user is focused on
• Permission status — check accessibility and microphone permissions
• In-app toast notifications — stackable, auto-dismissing toast component

Quick Example

use gpui::{App, Application, TrayMenuItem};

fn main() {
    Application::new().run(|cx: &mut App| {
        cx.set_keep_alive_without_windows(true);
        cx.set_tray_tooltip("My App");

        cx.set_tray_menu(vec![
            TrayMenuItem::Action {
                label: "Settings".into(),
                id: "settings".into(),
            },
            TrayMenuItem::Separator,
            TrayMenuItem::Action {
                label: "Quit".into(),
                id: "quit".into(),
            },
        ]);

        cx.on_tray_menu_action(|id, cx| match id.as_ref() {
            "quit" => cx.quit(),
            _ => {}
        });
    });
}

See crates/gpui/examples/daemon_app.rs for a full example with overlay windows, settings window, global hotkeys, and notifications.

Dependencies

macOS

• Xcode with macOS components
• Xcode command line tools: xcode-select --install

Linux

• For X11: libxcb, libxkbcommon
• For Wayland: libwayland-client, libxkbcommon
• D-Bus (for system tray via StatusNotifierItem)

Windows

• Visual Studio Build Tools with C++ workload
• Windows SDK

License

Apache-2.0