flutter_web_runner 1.0.0

Run Flutter Web with your favorite browser + automatic hot reload. Supports Safari, Firefox, Arc, Brave, Edge, and Chrome.

🚀 Flutter Web Runner

Run Flutter Web with your favorite browser + automatic hot reload

Installation • Usage • Features • Contributing

---

🎯 The Problem

Flutter web defaults to Chrome. But what if you prefer Safari, Firefox, Arc, or Brave?

✨ Features

• 🌐 Custom Browser - Safari, Firefox, Arc, Edge, Brave, Chrome
• 🔥 Auto Hot Reload - Save a file → Flutter hot reloads automatically
• 💾 State Preservation - Hot reload keeps your app state intact
• ⌨️ Manual Controls - Press r, R, or q in terminal

📦 Installation

# Global activation (recommended)
dart pub global activate flutter_web_runner

# Or add as dev dependency
dart pub add --dev flutter_web_runner

🚀 Usage

# Navigate to your Flutter project
cd my_flutter_app

# Run with default browser (Chrome)
flutter_web_runner

# Use a specific browser
flutter_web_runner -b safari
flutter_web_runner -b firefox
flutter_web_runner -b arc
flutter_web_runner -b brave

# Custom port
flutter_web_runner -b safari -p 3000

# Disable auto hot reload
flutter_web_runner --no-hot-reload

Output

╔══════════════════════════════════════════════════════════════╗
║  🚀 Flutter Web Runner - Safari                              ║
╚══════════════════════════════════════════════════════════════╝

 ✓ Browser: Safari
 ✓ URL: http://localhost:8080
 ✓ Hot Reload: Enabled

╔══════════════════════════════════════════════════════════════╗
║  HOT RELOAD ACTIVE                                           ║
║                                                              ║
║  Save any .dart file → Auto hot reload (preserves state)    ║
║                                                              ║
║  Manual controls:                                            ║
║    r - Hot reload                                           ║
║    R - Hot restart                                          ║
║    q - Quit                                                  ║
╚══════════════════════════════════════════════════════════════╝

 🔥 Hot reloading... (home_screen.dart)

🌐 Supported Browsers

Browser	Flag	macOS
Safari	-b safari	✅
Firefox	-b firefox	✅
Arc	-b arc	✅
Brave	-b brave	✅
Edge	-b edge	✅
Chrome	-b chrome	✅

⚙️ Options

Option	Short	Description
--browser	-b	Browser to use (default: chrome)
--port	-p	Port for web server (default: 8080)
--no-hot-reload		Disable auto hot reload
--help	-h	Show help
--version	-v	Show version

🔧 Requirements

• Dart SDK >= 3.0.0
• Flutter SDK in PATH
• macOS (for browser control features)

🤝 Contributing

Contributions welcome! Ideas:

• Linux support
• Windows support
• VS Code extension

📄 License

MIT License