Skip to main content
FlowDeck provides comprehensive support for working with physical iOS devices directly from Cursor.

​
Getting Started

1

Connect your device

Connect your iOS device to your Mac via USB or USB-C
2

Trust and unlock

Ensure your device is trusted and unlocked
3

Open your project

Open your project in Cursor with FlowDeck
4

Select as destination

Select your device as the build destination

​
Device Requirements

Before deploying to a physical device, ensure:
  • Apple Developer account has the correct provisioning profiles
  • Device is registered in your Apple Developer account
  • App’s bundle identifier matches your provisioning profile
  • Deployment target is compatible with your device’s iOS version
  • Device is accessible via Xcode (any iOS version supported)

​
Supported Devices

FlowDeck can detect and work with:
  • iPhone devices
  • iPad devices
  • Apple Watch devices
  • Apple TV devices
  • Apple Vision Pro devices

​
Device Selection

Select a connected device as your build destination:
  1. Use the FlowDeck: Select Destination command
  2. Choose your connected device from the list
  3. Build and run your app on the selected device
You can also right-click the device in FlowDeck’s devices panel and select Select destination

​
Debugging Method

FlowDeck automatically selects the best debugging method based on your device:
  • iOS 17+ - Uses modern devicectl for faster and more reliable debugging
  • iOS 16 and below - Falls back to ios-deploy for compatibility
  • Auto mode - FlowDeck automatically detects and uses the appropriate method
You can configure the debugging method in settings if needed, but auto mode works best for most users.