Skip to main content
Save project settings (workspace, scheme, target, configuration) so you can run build/run/test/clean without repeating flags.
flowdeck init requires --workspace. If --scheme is omitted and only one scheme exists, it will be selected automatically. If no target is specified, FlowDeck defaults to “My Mac”.
# iOS Simulator
flowdeck init -w App.xcworkspace -s MyApp -S "iPhone 16"

# macOS target
flowdeck init -w App.xcworkspace -s MyApp -D "My Mac"

# Physical device
flowdeck init -w App.xcworkspace -s MyApp -D "John's iPhone"

# With build configuration
flowdeck init -w App.xcworkspace -s MyApp -S "iPhone 16" -C Debug

# Re-initialize (overwrite existing config)
flowdeck init -w App.xcworkspace -s MyApp -S "iPhone 16" --force

# JSON output for automation
flowdeck init -w App.xcworkspace -s MyApp -S "iPhone 16" --json

# Show usage examples
flowdeck init --examples

​
Options

OptionShortDescription
--examples-eShow usage examples
--project <path>-pProject directory (defaults to current)
--workspace <path>-wPath to .xcworkspace or .xcodeproj (required)
--scheme <name>-sScheme name
--configuration <name>-CBuild configuration (Debug/Release)
--simulator <name>-SSimulator name or UDID
--device <name>-DDevice name or UDID (use “My Mac” for macOS)
--json-jOutput as JSON
--force-fRe-initialize even if already configured

​
JSON Output

{
  "success": true,
  "message": "Project initialized",
  "workspace": "App.xcworkspace",
  "scheme": "MyApp",
  "target": "iPhone 16",
  "targetType": "simulator",
  "configuration": "Debug"
}