Skip to main content
Interactive mode starts by letting you either scaffold a brand new app or open an existing workspace/project.

​
Creating a Project

When FlowDeck can’t detect an existing project or you select Create Project from the setup assistant, it walks you through:
  1. Create a SwiftUI-based project (FlowDeck uses its built-in SwiftUI template).
  2. Name the app and confirm the bundle identifier.
  3. Select platforms (iOS, macOS, visionOS) for the new project.
  4. FlowDeck scaffolds the project, opens it, and immediately moves into scheme/target selection so you can start building.
You can run the same flow later via flowdeck project create. Multi-platform targets are only usable when the corresponding Xcode SDKs are installed.

​
Opening a Project

Choose Open Existing (or launch interactive mode inside a folder containing an Xcode project) and let FlowDeck’s assistant guide you through each step:
  1. Select Project - choose the .xcworkspace or .xcodeproj.
  2. Detect Schemes - FlowDeck scans the project, then you select a scheme.
  3. Detect Targets - pick a simulator, device, or Mac destination.
  4. Detect Configurations - select Debug, Release, or any custom config.
  5. Setup Complete - press any key to enter interactive mode.
Every selection persists across sessions so reopening interactive mode restores the same context. When multiple workspaces exist, FlowDeck prompts you to choose which one to open before schemes appear.

​
Saved Context

Interactive mode automatically saves your selections so you can resume without reconfiguring:
  • Workspace path
  • Selected scheme
  • Selected simulator/device
  • Build configuration
  • Log streaming preference
  • Recent tests

​
Export Project Config

Use Export Project Config from Project Tools to save the current workspace/scheme/target/config to JSON for reuse with CLI commands.