🚀 Flutter Fly 🚀

The ultimate Flutter development companion for VSCode

Flutter Fly: Wireless Debug & Run

The ultimate Flutter development companion for VSCode. Connect devices wirelessly, build APKs/AABs, run Flutter apps, and manage your entire Flutter workflow from one beautiful interface.

🎥 Demo

✨ Feature Demonstrations ✨

Wireless Device Connection

APK Installation

Flutter Run & Hot Reload

Build App Bundle (AAB)

🎯 What is Flutter Fly?

Flutter Fly is a powerful VSCode extension that transforms your Flutter development experience. It provides a beautiful, intuitive interface for:

🔌 Wireless Device Connection - Connect to Android devices over WiFi without USB cables
📱 APK & AAB Building - Build APK files and App Bundles with one click
🚀 Flutter Development - Run, debug, and manage Flutter apps seamlessly
🔥 Firebase Integration - Enable/disable Firebase analytics debugging
🛠️ Device Management - Full ADB server control and device management
🎨 Beautiful UI - Modern, attractive interface designed for developers

✨ Key Features

🚀 Flutter Development Workflow

Flutter Doctor - Check your Flutter environment health
SDK Management - Upgrade Flutter SDK with one click
Package Management - Get Flutter packages instantly
Code Quality - Format and analyze your Flutter code

📱 Building & Compiling

APK Building - Build APK files in debug, profile, or release mode
App Bundle (AAB) - Create Google Play Store ready AAB files
iOS Building - Build iOS apps (when iOS folder exists)
Web Building - Build web apps (when web folder exists)

🚀 Running & Debugging

Device Detection - Automatically detect connected devices
Multiple Modes - Run in debug, profile, or release mode
Hot Reload - Instant code updates during development
Hot Restart - Complete app restart when needed

🔌 Wireless Connectivity

WiFi Debugging - Connect to Android devices over WiFi
Device Discovery - Find devices on your local network
ADB Management - Full ADB server control
Firebase Debugging - Toggle Firebase analytics debugging

🚀 Quick Start Guide

Prerequisites

Flutter SDK installed and in your PATH
Android device with WiFi debugging enabled (for wireless features)
VSCode with the Flutter Fly extension

Step 1: Install Flutter Fly

Open VSCode
Go to Extensions (Ctrl+Shift+X)
Search for "Flutter Fly"
Click Install

Step 2: Connect Your Device Wirelessly

Enable WiFi Debugging on your Android device
Open Command Palette (Ctrl+Shift+P)
Type "Flutter Fly: Connect Android Device"
Enter your device's IP address
Start developing!

Step 3: Run Your Flutter App

Open Command Palette (Ctrl+Shift+P)
Type "Flutter Fly: Run on Connected Device"
Watch your app launch wirelessly!

🎮 Available Commands

Project Setup & Health

Command	Description	Use Case
`Flutter Fly:🚀 Run Flutter Doctor`	Check Flutter environment health	Environment setup
`Flutter Fly:🚀 Upgrade Flutter SDK`	Upgrade Flutter to latest version	SDK maintenance
`Flutter Fly:🚀 Get Packages`	Install/update Flutter dependencies	Dependency management

Building and Compiling

Command	Description	Use Case
`Flutter Fly:🚀 Build APK`	Build APK with mode selection	App distribution
`Flutter Fly:🚀 Build App Bundle (AAB)`	Build Google Play Store AAB	Store deployment
`Flutter Fly:🚀 Build iOS`	Build iOS app (if supported)	iOS development
`Flutter Fly:🚀 Build Web`	Build web app (if supported)	Web development

Running and Debugging

Command	Description	Use Case
`Flutter Fly:🚀 Run on Connected Device`	Launch app on device	Development
`Flutter Fly:🚀 Run in Debug Mode`	Run with debugging enabled	Debugging
`Flutter Fly:🚀 Run in Profile Mode`	Run for performance testing	Performance
`Flutter Fly:🚀 Run in Release Mode`	Run production build	Testing

Hot Reload / Restart

Command	Description	Use Case
`Flutter Fly:🚀 Hot Reload`	Update code without restart	Quick development
`Flutter Fly:🚀 Hot Restart`	Complete app restart	Major changes

Device & Emulator Management

Command	Description	Use Case
`Flutter Fly:🚀 Connect Android Device`	Connect device wirelessly	Device setup
`Flutter Fly:🚀 Open Android Emulator`	Launch Android emulator	Emulator testing
`Flutter Fly:🚀 Open iOS Simulator`	Launch iOS simulator (Mac only)	iOS testing

Utility & Cleanup

Command	Description	Use Case
`Flutter Fly:🚀 Clean Project`	Clean build artifacts	Troubleshooting
`Flutter Fly:🚀 Inject Resources`	Run build_runner	Code generation
`Flutter Fly:🚀 Format Code`	Format Dart/Flutter code	Code quality
`Flutter Fly:🚀 Analyze Project`	Analyze code for issues	Code review

🎯 Flutter Developer Workflow

Development Setup

Connect your device using Flutter Fly
Run Flutter app with one command
Hot reload works seamlessly over WiFi
Build APKs/AABs directly from VSCode

Testing & Debugging

Build APK: Use Flutter Fly build commands
Install via extension - no need to copy files
Test on device with real-time feedback
Debug with Firebase analytics

Production Deployment

Build release AAB: Use Flutter Fly build commands
Install via extension for testing
Verify functionality on device
Deploy to store when ready

🔧 Configuration

Custom Paths

Configure custom paths for Flutter and ADB:

Open Command Palette: Ctrl+Shift+P
Search for: Flutter Fly: Setup custom ADB location
Select your executable
Verify connection works

Default Locations

The extension automatically detects:

Flutter: System PATH or Flutter SDK location
ADB: Android SDK platform-tools directory
Platform-specific paths for Windows, macOS, and Linux

🧪 Testing

Run the test suite to ensure everything works:

# Run all tests
npm test

# Run tests in watch mode
npm run test:watch

# Run tests with coverage
npm run test -- --coverage

🚀 Development

Prerequisites

Node.js 14+
npm or yarn
VSCode

Setup

# Clone the repository
git clone https://github.com/jamalihassan0307/flutter-fly.git

# Install dependencies
npm install

# Compile TypeScript
npm run compile

# Watch for changes
npm run watch