Skip to content

edTheGuy00/fdemon

Repository files navigation



Flutter Demon
A blazingly fast TUI for Flutter development

GitHub Release CI License

Website · Documentation · Keybindings · Configuration


Flutter Demon (fdemon) is a high-performance terminal UI for Flutter development. Run apps, view logs in real-time, hot reload on file changes, and manage multiple device sessions — all from your terminal.

Log view with real-time logs, hot reload, and file watcher

Installation

curl -fsSL https://raw.githubusercontent.com/edTheGuy00/fdemon/main/install.sh | bash

This downloads the latest release binary for your platform and installs it to $HOME/.local/bin.

See the installation guide for version-specific installs, custom directories, Windows, and building from source.

Features

  • Real-time log viewing with level/source filtering, regex search, and error navigation
  • Auto hot reload on file save with smart debouncing
  • Multi-device sessions — run on up to 9 devices simultaneously
  • Built-in DevTools — widget inspector, performance monitor, network monitor
  • New Session Dialog — device selection, launch configs, dart defines
  • Link Highlight Mode — open files from log traces directly in your editor
  • Smart project discovery — auto-detects Flutter apps, plugins, and workspaces

Quick Start

cd /path/to/my_flutter_app
fdemon

Select a device, configure launch settings, and press Enter to launch.

New Session dialog with device selection and launch configuration

DevTools

Press d to enter DevTools mode. Three panels are available:

Key Panel Description
i Widget Inspector Browse the widget tree, view layout details and source locations
p Performance Real-time FPS, memory usage, jank detection, allocation table
n Network HTTP request capture, detail tabs, filtering, recording controls

Widget Inspector with tree view and Layout Explorer    Performance Monitor with FPS, memory, and allocations

Debug overlays (Ctrl+r repaint rainbow, Ctrl+p performance, Ctrl+d debug paint) and browser DevTools (b) are also available.

Key Bindings

Key Action
r / R Hot reload / Hot restart
d Enter DevTools
+ New session
1-9 / Tab Switch session
f / F Cycle level/source filter
/ Search logs
e / E Next/previous error
L Link highlight mode
q q Quit

Full reference: fdemon.dev/docs/keybindings

Configuration

Flutter Demon works out-of-the-box with sensible defaults. Optionally configure via:

  • .fdemon/config.toml — Behavior, watcher, UI, editor settings
  • .fdemon/launch.toml — Launch configurations (device, mode, flavor, dart defines)
  • .vscode/launch.json — Auto-imported (read-only)

Full reference: fdemon.dev/docs/configuration

Requirements

  • Flutter SDK in your PATH
  • A terminal with Unicode support

Contributing

Contributions are welcome! See CONTRIBUTING.md for guidelines.

cargo build && cargo test && cargo clippy

License

Business Source License 1.1 — free for all use except providing a commercial hosted Flutter development service. Converts to AGPL-3.0 after four years.


Made with 🔥 for Flutter developers