hawierdev/flutter-android-box repository overview

⁠Flutter Android Box 🚀📱

Complete Flutter development environment in Docker. Use your physical Android device for testing. No local Flutter/Android SDK installation needed!

⁠✨ Features

• 🐳 Complete Flutter Environment - Flutter SDK + Android SDK + Java 21
• 📱 Physical Device Support - Connect via USB debugging or wireless ADB
• ⚡ One Command Setup - Start coding in seconds
• 🔧 Configurable Ports - Customize all ports to avoid conflicts
• 🚀 Lightweight - No emulator overhead, faster builds

⁠🚀 Quick Start

⁠Install

curl -fsSL https://raw.githubusercontent.com/hawier-dev/flutter-android-box/main/install.sh | bash

⁠Use

cd your-flutter-project
flutter-box                    # Starts container + enters shell

# Connect your Android device via USB debugging
adb-devices                    # Check connected devices
flutter run                    # Run your app on device

Connect your physical Android device via USB debugging and enable developer options.

Exit the shell to automatically stop the container.

⁠🔧 Available Commands

Inside container:

• adb-devices - Show connected devices
• adb-connect - Help for USB debugging
• adb-wifi - Help for wireless debugging
• frun - flutter run
• fdoctor - flutter doctor
• fpub - flutter pub get

Outside container:

• flutter-box - Start development environment
• flutter-box clean - Remove everything
• flutter-box logs - View container logs
• flutter-box status - Show container status

⁠⚙️ Port Configuration

Customize ports to avoid conflicts:

⁠Individual Ports

flutter-box --adb-port 5037           # ADB server (default: 5037)
flutter-box --flutter-port 3000       # Flutter dev server (default: 3000)
flutter-box --devtools-port 42000     # Flutter DevTools (default: 42000)

⁠All Ports at Once

# Format: adb,flutter,devtools
flutter-box --ports 5037,3000,42000

⁠📋 Requirements

• Docker
• Git
• Linux/macOS/WSL2

That's it! 🎉