Skip to main content
FlowDeck CLI supports deploying and running your apps on your Mac (native or Catalyst) and physical Apple devices.

​
Managing Devices

​
List All Devices

Example output:
Legend:
  • 💻 = Mac target (virtual)
  • 🔌 = USB connection
  • 📡 = Network connection
  • [✓] = Available

​
Filter by Platform

​
Show Only Available Devices

​
JSON Output

​
Mac Targets

​
My Mac (Native macOS)

Build and run as a native macOS app:

​
My Mac Catalyst

Build and run an iOS app on Mac via Mac Catalyst:
Mac Catalyst requires your iOS app to have SUPPORTS_MACCATALYST = YES in its build settings.
In interactive mode, “My Mac Catalyst” only appears in the target list when your app’s scheme supports Mac Catalyst. FlowDeck detects this automatically by checking the build settings.

​
Physical Devices

Physical devices (iPhones, iPads, Apple Watches) require a USB connection and proper provisioning.

​
Install an App

​
Uninstall an App

​
Launch an App

​
Requirements

Before deploying to a physical device, ensure:
  • Device is connected via USB or USB-C
  • Device is trusted and unlocked
  • Apple Developer account has correct provisioning profiles
  • Device is registered in your Apple Developer account
  • App’s bundle identifier matches your provisioning profile
  • Deployment target is compatible with device’s iOS version

​
Connection Types

FlowDeck automatically detects:
  • USB - Direct wired connection (most reliable)
  • Network - WiFi network debugging (iOS 14+)
Network debugging requires the device to be on the same WiFi network and previously paired via USB.

​
Debugging Method

FlowDeck automatically selects the best debugging method:
  • iOS 17+ - Uses devicectl for faster, more reliable debugging
  • iOS 16 and below - Uses ios-deploy for compatibility

​
Troubleshooting

​
Device Not Appearing

  1. Ensure the device is unlocked and trusted
  2. Try unplugging and reconnecting the USB cable
  3. Refresh the device list:

​
Code Signing Issues

Check your provisioning profiles and certificates in Xcode’s Preferences > Accounts.

​
Connection Problems

  • Try a different USB cable
  • Check that the device trusts your Mac
  • For network debugging, ensure both are on the same WiFi network