> ## Documentation Index
> Fetch the complete documentation index at: https://flowdeck.studio/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Physical Devices

> Deploy and test on real iOS devices

FlowDeck provides comprehensive support for working with physical iOS devices directly from Cursor.

## Getting Started

<Steps>
  <Step title="Connect your device">
    Connect your iOS device to your Mac via USB or USB-C
  </Step>

  <Step title="Trust and unlock">
    Ensure your device is trusted and unlocked
  </Step>

  <Step title="Open your project">
    Open your project in Cursor with FlowDeck
  </Step>

  <Step title="Select as destination">
    Select your device as the build destination
  </Step>
</Steps>

## 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

<Tip>
  You can also right-click the device in FlowDeck's devices panel and select **Select destination**
</Tip>

## 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

<Note>
  You can configure the debugging method in settings if needed, but auto mode works best for most users.
</Note>