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

# Cursor Extension

> The iOS/macOS development extension for Cursor, VS Code, and Windsurf

The **FlowDeck Cursor Extension** brings iOS/macOS development to Cursor, VS Code, and Windsurf. Build, run, debug, and test your apps without leaving your editor.

<Tip>
  Looking for the CLI? The [FlowDeck CLI](/introduction) is the primary tool for terminal-first development and AI agent workflows.
</Tip>

## Essentials

<CardGroup cols={2}>
  <Card title="Install and Setup" icon="download" href="/extension/install-and-setup">
    FlowDeck works in Cursor, VS Code, Windsurf, and other compatible editors. Here's how to set it up.
  </Card>

  <Card title="Core Features" icon="play" href="/extension/basics-overview">
    Get code completion working and learn how to build and run your iOS and macOS apps, or create a new one from scratch.
  </Card>
</CardGroup>

### Requirements

<Warning>
  FlowDeck requires macOS with Xcode installed. It does not support Windows or Linux.
</Warning>

* **macOS** 13.0 or later
* **Xcode** 15.0 or later (with command line tools)
* **Cursor, VS Code, or Windsurf**
* **Apple Silicon Mac**: M1 or later recommended for best performance

## Core Features

<CardGroup cols={2}>
  <Card title="Working with Xcode Projects" icon="hammer" href="/extension/xcode-projects">
    Creating or using existing XCode projects
  </Card>

  <Card title="Code Intelligence" icon="code" href="/extension/code-intelligence">
    Real-time autocomplete, suggestions, and symbol navigation via SourceKit LSP
  </Card>

  <Card title="Device & Simulator Support" icon="mobile-screen-button" href="/extension/devices">
    Deploy and test your apps on simulators and physical Apple devices
  </Card>

  <Card title="Build, Run and Deploy" icon="hammer" href="/extension/building">
    Build and run existing Xcode projects from Cursor
  </Card>
</CardGroup>

## Advanced Features

<CardGroup cols={2}>
  <Card title="Debugging" icon="bug" href="/extension/debugging">
    Debug with breakpoints and variable inspection
  </Card>

  <Card title="Running Tests" icon="flask" href="/extension/testing">
    Run and manage your unit and UI tests from Cursor
  </Card>

  <Card title="Logging with OSLog" icon="terminal" href="/extension/logging">
    Stream, search, and filter simulator logs directly from Cursor
  </Card>

  <Card title="Swift Package Management" icon="box" href="/extension/swift-package-manager">
    View, update, resolve and reset your Swift Packages in a single location
  </Card>

  <Card title="Asset Catalogs" icon="images" href="/extension/asset-catalog">
    Browse and manage your app's images, colors, and other assets
  </Card>
</CardGroup>

## Getting Help

<CardGroup cols={2}>
  <Card title="Command Reference" icon="terminal" href="/extension/commands">
    Complete list of available commands
  </Card>

  <Card title="Community" icon="users" href="https://flowdeck.studio/#join">
    Join the Discord community
  </Card>

  <Card title="Submit an issue" icon="paper-plane" iconType="regular" href="https://github.com/flowdeck-studio/flowdeck-feedback">
    Got feedback or found a bug?  Submit a GitHub Issue
  </Card>
</CardGroup>