> ## Documentation Index
> Fetch the complete documentation index at: https://docs.flowdeck.studio/llms.txt
> Use this file to discover all available pages before exploring further.

# Install FlowDeck

> Download FlowDeck and open your first project

## Prerequisites

Before installing, make sure you have:

<Steps>
  <Step title="macOS on Apple Silicon">
    <Warning>
      Windows and Linux are not supported.
    </Warning>

    * Apple Silicon Mac (M1 or later)
    * macOS 26 (Tahoe) or later

    <Note>
      Support for macOS 15 (Sequoia) is temporarily suspended. We are working to
      restore it in an upcoming release.
    </Note>
  </Step>

  <Step title="Xcode">
    * Download from the [Mac App Store](https://apps.apple.com/us/app/xcode/id497799835?mt=12) (26 or later)
    * Launch Xcode at least once to install components and accept the license agreement
  </Step>

  <Step title="Xcode Command Line Tools">
    ```bash theme={null}
    xcode-select --install
    ```
  </Step>
</Steps>

## Download FlowDeck

[Download FlowDeck from flowdeck.studio](https://flowdeck.studio)

Move the app to your Applications folder and launch it.

## Activate FlowDeck

FlowDeck needs a license to open. On first launch it offers a **14-day trial**; if you already
have a key, choose **Already have a license?** and paste it.

The app accepts a **FlowDeck Studio** or **FlowDeck for Teams** license. A FlowDeck CLI license
is a different product and does not unlock the app — paste one and FlowDeck names the product
your key is for rather than calling it invalid.

Your license lives in one place on the machine and is **shared with the FlowDeck CLI**:
activating in the app licenses the CLI too, and vice versa. One machine uses one seat.

Manage it in **Settings ▸ License**, which shows the plan, status, renewal date, and how many
seats are in use. **Manage License** opens the license portal; **Remove License** releases the
seat on this machine — including for the CLI.

## Open a Project

Choose **File → Add Project…** (**⌘O**). The sheet offers three sources:

* **New App** — scaffold a new application from scratch
* **Local folder** — open an existing `.xcodeproj` or `.xcworkspace` from your Mac
* **GitHub** — clone one of your repositories

FlowDeck discovers the available schemes and simulators automatically. Pick a scheme and
destination from the toolbar, then hit **Build** — or just open a conversation with the agent.

<Tip>
  Nothing to open yet? The same sheet has a **sample project** link at the bottom, and the last
  step of first-run setup offers it too. It is [a complete iOS app](/macos/sample-project),
  already configured, to learn FlowDeck on before you point it at your own code.
</Tip>

## Next Steps

<CardGroup cols={2}>
  <Card title="The AI Agent" icon="robot" href="/macos/ai-agent">
    Learn what the built-in agent can do and how to talk to it effectively.
  </Card>

  <Card title="Build & Run" icon="hammer" href="/macos/building">
    Build and run your first app from FlowDeck.
  </Card>
</CardGroup>