mobile-flutter-run-on-device

Run Flutter apps on physical Android and iOS devices for testing and debugging.

2|Updated Apr 3, 2026
One-click install
npx skills add https://github.com/TMHSDigital/Mobile-App-Developer-Tools --skill mobile-flutter-run-on-device
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: mobile-flutter-run-on-device
Source: https://github.com/TMHSDigital/Mobile-App-Developer-Tools/tree/main/skills/mobile-flutter-run-on-device
Command: npx skills add https://github.com/TMHSDigital/Mobile-App-Developer-Tools --skill mobile-flutter-run-on-device

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps developers move from emulators to physical phones and tablets so they can test real-device behavior, resolve connection and signing issues, and verify performance across build modes.

Core Features & Use Cases

  • Device discovery and connection: Walks through running device detection, verifying adb output, and choosing the correct device ID.
  • Platform-specific setup: Covers Android USB and wireless pairing, enabling developer options, and iOS signing and network device pairing with Xcode.
  • Debugging and build workflows: Explains debug, profile, and release modes, and clarifies hot reload versus hot restart for iterative development.
  • Use case: A developer who cannot see their Android phone in flutter devices can follow the steps to enable USB debugging, authorize the machine, or pair the device wirelessly and then launch the app with hot reload.

Quick Start

Run a Flutter app on my Android phone via USB, confirm adb lists the device and then start the app in debug mode to use hot reload.

Frequently Asked Questions about mobile-flutter-run-on-device

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I run a Flutter app on a physical Android device using USB?

To run a Flutter app on a physical Android device, enable USB debugging in developer options, authorize the machine, verify the device appears in adb output, and launch the app in debug mode to use hot reload.

Why does my Android phone not show up when running flutter devices?

If your Android phone does not show up in flutter devices, you need to enable USB debugging, authorize the computer, or pair the device wirelessly using adb pairing and connect commands to resolve device recognition issues.

How do I configure wireless device pairing for iOS testing in Xcode?

Wireless iOS device pairing requires configuring network device pairing within Xcode and completing the iOS signing workflows, enabling you to deploy Flutter apps without a physical USB connection.

What is the difference between hot reload and hot restart in Flutter?

Hot reload injects updated code into the running Dart virtual machine while preserving app state, whereas hot restart resets the app state entirely, both facilitating iterative development during device testing.

When should I use debug, profile, or release builds for Flutter on-device testing?

Use debug builds for development with hot reload, profile builds to analyze performance, and release builds for final deployment, ensuring accurate on-device behavior verification across build modes.