Skip to main content

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.

Read or change the physical orientation of an iOS simulator.

​
flowdeck simulator orientation

flowdeck simulator orientation defaults to get. 
# Read the current orientation from the current booted simulator
flowdeck simulator orientation

# Explicit get subcommand
flowdeck simulator orientation get

# Target a specific simulator
flowdeck simulator orientation get --simulator "iPhone 16"

# JSON output
flowdeck simulator orientation get --json

# Usage examples
flowdeck simulator orientation --examples
flowdeck simulator orientation get --examples

​
Get Options

OptionShortDescription
--simulator <name-or-udid>-STarget simulator name or UDID
--json-jOutput as JSON
--examples-eShow usage examples

​
Get JSON Output

{
  "schema": "flowdeck.simulator",
  "schemaVersion": "1.0.0",
  "success": true,
  "type": "orientation_get",
  "orientation": "landscape-left",
  "udid": "12345678-1234-1234-1234-123456789ABC"
}
If you omit --simulator, FlowDeck targets the current booted simulator. If no simulator is booted, the command fails.

​
flowdeck simulator orientation set

Set the simulator orientation and wait until the physical state matches the confirmed result. 
flowdeck simulator orientation set portrait --simulator "iPhone 16"
flowdeck simulator orientation set landscape-left --simulator "iPhone 16"
flowdeck simulator orientation set landscape-right --simulator "iPhone 16"
flowdeck simulator orientation set portrait-upside-down --simulator "FlowDeck-Diag-iPad"

# JSON output
flowdeck simulator orientation set landscape-left --simulator "iPhone 16" --json

# Usage examples
flowdeck simulator orientation set portrait --examples

​
Set Options

OptionShortDescription
--simulator <name-or-udid>-STarget simulator name or UDID
--json-jOutput as JSON
--examples-eShow usage examples

​
Supported Values

  • portrait
  • landscape-left
  • landscape-right
  • portrait-upside-down

​
Set JSON Output

{
  "schema": "flowdeck.simulator",
  "schemaVersion": "1.0.0",
  "success": true,
  "type": "orientation_set",
  "orientation": "landscape-left",
  "udid": "12345678-1234-1234-1234-123456789ABC"
}
FlowDeck returns the confirmed orientation, not just the requested value. If the front-most app does not support the requested orientation, the result reflects what the simulator actually applied.
portrait-upside-down is not supported on iPhone simulators. Use an iPad simulator if you need to validate upside-down orientation behavior.