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

🌟 Available on VS Code Marketplace

✨ What's New in v1.0.3

🚀 Major Improvements

Real Device Detection - No more fake devices! Shows actual connected devices from ADB
Smart ADB Integration - Automatic detection and helpful guidance when ADB is not available
Enhanced Error Handling - Intelligent fallbacks and step-by-step troubleshooting
Complete UI Restoration - Social links and developer branding restored with beautiful styling

🔧 Technical Fixes

Command Registration Conflicts - Resolved all initialization errors
Controller Lifecycle - Fixed startup and activation issues
Type Safety - Improved TypeScript definitions and error handling
Performance - Optimized device detection and connection logic

🌟 Features

📱 Wireless Device Management

Real-time Device Detection - Shows actual connected devices from adb devices
Smart Connection Logic - Intelligent device connection with proper validation
Device Status Monitoring - Real-time online/offline/unauthorized status
ADB Integration - Complete ADB path detection and availability checking

🏗️ Flutter Development Workflow

Flutter Doctor - Check Flutter installation and dependencies
Package Management - Get and update Flutter packages
Build Tools - Build APK, AAB with multiple build modes
Project Management - Clean, analyze, and manage Flutter projects

🎨 Beautiful Interface

Modern Webview Panel - Attractive, responsive design with Bootstrap 5
Social Integration - GitHub, LinkedIn, and Portfolio links
Developer Branding - "Built with ❤️ by Jam Ali Hassan"
Responsive Design - Works perfectly on all screen sizes

🆘 Smart Help System

ADB Installation Guide - Step-by-step installation instructions
Documentation Links - Direct access to official Android docs
PATH Configuration - Guidance on system configuration
Troubleshooting - Helpful error messages and recovery suggestions

🚀 Quick Start

1. Install the Extension

# From VSCode Extensions Marketplace
# Search for "Flutter Fly: Wireless Debug & Run"
# Or use the direct link above

2. Open Flutter Fly Panel

Press Ctrl+Shift+P (or Cmd+Shift+P on macOS)
Type "Flutter Fly: Open Flutter Fly Panel"
Click to open the beautiful interface

3. Connect Your Device

Enter your device's IP address and port
Click "Connect Device"
See real-time connection status

4. Run Flutter Commands

Use the quick action buttons in the sidebar
Execute commands directly from the panel
Monitor output in the integrated terminal

📱 Device Connection

Wireless ADB Setup

Enable Developer Options on your Android device
Enable USB Debugging and Wireless Debugging
Note the IP address and port (usually 5555)
Use Flutter Fly to connect wirelessly

ADB Installation Help

If you see "adb not recognized":

Install Android Studio (recommended)
Or download Platform Tools separately
Add to system PATH
Restart VSCode

🎯 Available Commands

Panel Commands

flutterFly.openFlutterPanel - 🚀 Open main Flutter Fly panel
flutterFly.connectWirelessDevice - 📱 Connect wireless device
flutterFly.showConnectedDevices - 🔍 Show connected devices

Flutter Commands

flutterFly.runFlutterDoctor - ⚡ Run Flutter doctor
flutterFly.getPackages - 📦 Get Flutter packages
flutterFly.buildAPK - 🏗️ Build Android APK
flutterFly.buildAppBundle - 📱 Build Android App Bundle
flutterFly.cleanProject - 🧹 Clean Flutter project

ADB Commands

flutterFly.killserver - ⚠️ Kill ADB server

Firebase Commands

flutterFly.enableFirebaseDebug - 🔥 Enable Firebase debug
flutterFly.disableFirebaseDebug - 🔥 Disable Firebase debug

🛠️ Development

Prerequisites

Node.js 16+
TypeScript 5.0+
VSCode Extension Development Host

Setup

git clone https://github.com/jamalihassan0307/flutter-fly.git
cd flutter-fly
npm install
npm run compile

Testing

# Press F5 in VSCode to launch extension development host
# Test all commands and panel functionality

Building

npm run build        # Clean, compile, and package
npm run package      # Create .vsix file

📁 Project Structure

src/
├── config/           # Command registry and configuration
├── controllers/      # Command implementations
│   ├── flutter-controller/      # Flutter commands
│   ├── adb-controller/          # ADB device commands
│   ├── firebase-controller/     # Firebase commands
│   └── flutter-panel-controller/ # Panel interface
├── domain/          # Business logic and ADB integration
└── infra/           # Extension infrastructure

🔧 Configuration

Custom ADB Path

{
  "flutterFly.adbPath": "C:\\Android\\platform-tools"
}

Custom Flutter Path

{
  "flutterFly.flutterPath": "C:\\flutter\\bin"
}

Default Build Mode

{
  "flutterFly.defaultBuildMode": "debug"
}

🆘 Troubleshooting

Common Issues

Extension Won't Start

Check console for error messages
Ensure all dependencies are installed
Verify TypeScript compilation

ADB Not Found

Install Android SDK Platform Tools
Add to system PATH
Restart VSCode

Device Won't Connect

Verify device IP and port
Check wireless debugging is enabled
Ensure device and computer are on same network

Commands Not Working

Check command registration in console
Verify package.json configuration
Test in clean VSCode window

Getting Help

📖 Command Guide - How to add/edit commands
🐛 Report Issues
💬 Ask Questions

🤝 Contributing

We welcome contributions! See our Contributing Guide for details.

Quick Contribution

Fork the repository
Create a feature branch
Make your changes
Test thoroughly
Submit a pull request

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgments

Original Creator: Vinicios de Lima Clarindo (Wireless ADB)
Transformation: Jam Ali Hassan (Flutter Fly)
Community: All contributors and users

🌟 Star History

Made with ❤️ by Jam Ali Hassan

Transform your Flutter development experience with Flutter Fly! 🚀

📦 Installation

From VS Code Marketplace

Open VS Code
Go to Extensions (Ctrl+Shift+X)
Search for "Flutter Fly: Wireless Debug & Run"
Click Install

From VSIX Package

Download flutter-fly-1.0.3.vsix from releases
In VS Code: Extensions → Install from VSIX
Select the downloaded file
Restart VS Code

Flutter Fly: Wireless Debug & Run

Jam Ali Hassan