Quick Start

Quick Start

Get from zero to a live multi-device TUI in under two minutes.

---

1. Check connected devices

flutter devices

You should see at least one emulator or physical device. flutter-cli works with any device Flutter supports.

2. Run on a single device

flutter-cli run

flutter-cli picks the only connected device automatically and opens the TUI dashboard.

3. Run on multiple devices at once

flutter-cli run -d all

Or pick specific devices by ID:

flutter-cli run -d emulator-5554 -d 00008110-001234

Each device gets its own panel in the TUI. Panels are stacked vertically and resize automatically.

---

What you'll see

┌─ emulator-5554 (Android) ──────────────────────── [R] reload  [q] quit ─┐
│  flutter: Launching lib/main.dart on Android SDK built for x86_64…       │
│  Syncing files to device…                                                 │
│  Flutter run key commands.                                                │
│  r Hot reload. 🔥🔥🔥                                                     │
│  ...                                                                      │
└──────────────────────────────────────────────────────────────────────────┘
┌─ iPhone 15 Pro (iOS) ──────────────────────────────────────────────────────┐
│  Launching lib/main.dart on iPhone 15 Pro in debug mode...                │
│  ...                                                                      │
└──────────────────────────────────────────────────────────────────────────┘

---

Key things to try

Action	Key
Hot reload all devices	r
Hot restart all devices	R
Switch focus to next device panel	Tab
Open network inspector	n
Take screenshot on focused device	s
Quit everything	q

Full keybinding reference → Keybindings

---

Make flutter run itself open the TUI

Install the shell shim so the plain flutter run command launches the dashboard automatically:

→ Shell Shim