🚀 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 #

⚙️ Options #

🔧 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