🚀 Flutter Runner

Run Flutter on any platform with automatic hot reload

Installation • Usage • Platforms • Contributing

---

✨ Features

Feature	Web	iOS	Android
🔥 Auto Hot Reload	✅	✅	✅
💾 State Preservation	✅	✅	✅
🎯 Device Selection	✅	✅	✅
⌨️ Keyboard Controls	✅	✅	✅
📋 Full Logs Output	✅	✅	✅
🛠️ DevTools	-	✅	✅

📦 Installation

dart pub global activate flutter_runner

🚀 Usage

# Navigate to your Flutter project
cd my_flutter_app

# Web (default - uses Chrome)
flutter_runner

# Web with custom browser
flutter_runner -p web -b safari
flutter_runner -p web -b firefox
flutter_runner -p web -b arc

# iOS Simulator or Device
flutter_runner -p ios

# Android Emulator or Device
flutter_runner -p android

# Auto-detect mobile device
flutter_runner -p auto

# List all devices
flutter_runner devices

# Run on specific device
flutter_runner -d <device_id>

# Verbose mode (extra debug info)
flutter_runner -v

📋 Full Logs Support

Flutter Runner now displays all output from your Flutter app:

• ✅ print() and debugPrint() statements
• ✅ Build/compilation progress
• ✅ Hot reload confirmations
• ✅ Errors and warnings with styling
• ✅ Framework messages

All logs are automatically categorized with color-coded styling for easy reading.

⚠️ Terminal Logs Browser Support

Terminal logging is currently supported for:

• ✅ Chrome - Full support
• ✅ Edge - Full support
• ✅ Brave - Full support (v1.4.1+)

Other browsers (Safari, Firefox, Arc) run in web-server mode. Logs appear in the browser's DevTools console. Terminal logging support for these browsers is under development.

🎮 Keyboard Controls

Key	Action
r	Hot reload
R	Hot restart
o	Open DevTools (mobile)
p	Performance overlay (mobile)
q	Quit

📱 Platforms

Web

flutter_runner -p web -b safari    # Safari
flutter_runner -p web -b firefox   # Firefox
flutter_runner -p web -b arc       # Arc
flutter_runner -p web -b brave     # Brave
flutter_runner -p web -b edge      # Edge
flutter_runner -p web -b chrome    # Chrome (default)

iOS

flutter_runner -p ios              # Auto-select iOS device
flutter_runner -d "iPhone 15 Pro"  # Specific simulator

Android

flutter_runner -p android          # Auto-select Android device
flutter_runner -d emulator-5554    # Specific emulator

⚙️ Options

Option	Short	Description
--platform	-p	Platform: web, ios, android, auto
--browser	-b	Browser for web
--device	-d	Specific device ID
--port		Web server port
--no-hot-reload		Disable auto hot reload
--verbose	-v	Show verbose output with extra debugging
--help	-h	Show help
--version		Show version

🔧 Requirements

• Dart SDK >= 3.0.0
• Flutter SDK in PATH
• Xcode (for iOS)
• Android Studio (for Android)

📄 License

MIT License