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

# Build, Run & Test

> Core commands for building, running, testing, logs, clean, stop, and uninstall

Interactive mode is a persistent session that keeps your project context in memory and turns everyday tasks into single-key actions. The core loop is simple: build, run, inspect logs, run tests, and iterate without retyping flags. For scheme, target, and configuration choices, see [Build Settings](/cli/interactive/build-settings).

## Core Actions

```text theme={null}
Build, Run & Test
+-------------------------------------------+
| R Run         T Test       L Logs         |
| X Stop        C Clean      Z Uninstall    |
+-------------------------------------------+
? Help

⇧R Run without building
B  Build without running
```

### Build

Press `B` to build using the currently selected scheme, target, and configuration. Build output streams into the main content area while the status bar reflects the live state (Building, Error, Ready).

### Run

Press `R` to build and launch the app on the selected target. Use `Shift+R` to run without rebuilding when you already have a valid build on that target.

### Test

Press `T` to open test selection. You can run the entire suite, recent tests from the current session, or specific test classes/methods. Results stream live as they run.

### Clean

Press `C` (or `K`) to open the Clean menu for project clean, Xcode cache clean, and Derived Data removal. The menu provides:

* **Clean Project** – removes build artifacts for the current scheme before running a full rebuild.
* **Clean Xcode Cache** – clears Xcode's internal caches that can cache corrupted indexes.
* **Clear FlowDeck's Derived Data** – removes FlowDeck’s DerivedData directory; this may force a full rebuild for all schemes.
* **Clear Xcode Derived Data** – removes Xcode’s DerivedData directory.
* **Clean All** – clears scheme artifacts, FlowDeck/Xcode Derived Data, and Xcode cache in one pass.

### Logs

Press `L` to open the log/test viewer:

* Streams test output while tests are running; otherwise shows app logs while the app is running.
* Type to filter the buffer and use Backspace to edit the filter.
* Scroll with ↑/↓, Page Up/Page Down, Home, and End; auto-scroll resumes when you reach the bottom.
* Press `Esc` to exit back to the main view.

**Watch the video:**

<iframe src="https://www.youtube.com/embed/VDozo-oQ4_Y" title="YouTube video player" frameborder="0" className="w-full aspect-video rounded-xl" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen />

### Stop, Uninstall, and Cancel

Press `X` to stop a running app.

Press `Z` to uninstall the last launched app from the selected target. For non-interactive usage and arguments, see [Uninstall command](/cli/commands/uninstall).

Use `ESC` during a build or test to cancel the current operation.

See [Project Tools](/cli/interactive/tools-settings/project-commands) and [Manage Devices and Simulators](/cli/interactive/tools-settings/devices-simulators) for helper menus, persistence, and session tools.
