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

# Testing

> Run and manage unit and UI tests

FlowDeck provides comprehensive support for running and managing tests for your Apple projects directly within Cursor, with full integration into the Test Explorer.

## Features

* **Test Explorer Integration** - Browse and run tests from the Test Explorer sidebar
* **Test Discovery** - Automatic discovery and hierarchical display of test targets, classes, and methods
* **Click-to-Navigate** - Click on test results to jump directly to test source code
* **Real-time Results** - Live test execution status and detailed output
* **Flexible Test Execution** - Run individual tests, test classes, or entire test suites
* **Scheme Selection** - Select specific test schemes
* **Configuration Selection** - Configure testing environment

## Getting Started

<Steps>
  <Step title="Open your project">
    Open your iOS/macOS project in Cursor
  </Step>

  <Step title="Open Test Explorer">
    Click the Testing icon in the Activity Bar to open the Test Explorer sidebar
  </Step>

  <Step title="View discovered tests">
    FlowDeck automatically discovers your tests and displays them hierarchically
  </Step>

  <Step title="Run tests">
    Click on any test to run it, or use FlowDeck commands for batch operations
  </Step>
</Steps>

## Test Explorer Integration

FlowDeck integrates seamlessly with the built-in Test Explorer, providing:

### Test Discovery

* **Automatic Discovery** - Tests are discovered automatically when you open a project
* **Background Refresh** - Test structure updates in the background when schemes change
* **Hierarchical Display** - Tests are organized by target → class → method

### Test Execution

* **Individual Tests** - Click the play button next to any test method
* **Test Classes** - Run all tests in a class by clicking the class play button
* **Test Targets** - Run entire test suites by clicking the target play button
* **Real-time Updates** - Test status updates live during execution

### Navigation

* **Click to Source** - Click on any test name to navigate directly to the source code
* **Result Navigation** - Click on test results to jump to the test implementation
* **Error Navigation** - Failed tests show detailed error information with source links

## Building for Testing

To build your application for testing without running tests:

Use the command: `FlowDeck: Build for Testing`

This compiles your application with test targets but doesn't execute the tests.

## Configuration

FlowDeck supports different test configurations through the command:

`FlowDeck: Select configuration for testing`

This allows you to choose between Debug and Release configurations for your tests.