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

# Download & install

> Get the Roveflow Mac app and your phone ready, no terminal required.

The desktop app is the fastest way to use Roveflow: download it, plug in your phone, and map any app from a window. No terminal, nothing to configure.

<Note>Prefer the command line? See the [CLI installation](/cli/installation) guide instead, it does the same thing from your terminal.</Note>

## What you need

* A **Mac** with **Apple Silicon** (M1 or newer).
* An **iPhone or Android phone** and a **USB cable** (keep the phone unlocked while it's plugged in).
* **iPhone only:** an Apple **developer identity**, a free Apple ID is enough. The app walks you through it on first run.
* **Android only:** **USB debugging** turned on, see [Connect your phone](#connect-your-phone).

## Install

<Steps>
  <Step title="Download">
    Grab the latest build from [roveflow.dev/download](https://roveflow.dev/download).
  </Step>

  <Step title="Open it">
    Open the `.dmg` and drag **Roveflow** into **Applications**, then launch it.
  </Step>

  <Step title="Allow it to run">
    The first launch is a fresh build, so macOS may ask you to confirm. If Gatekeeper blocks it,
    **right-click the app → Open**, then **Open** again.
  </Step>
</Steps>

## First run

When the app opens it walks you through three things, once:

<Steps>
  <Step title="Connect to Claude">
    Roveflow's AI runs on Claude. Click **Connect to Claude** and finish the sign-in in your
    browser, the app stores the credential encrypted in your Mac's keychain. You can also paste an
    Anthropic API key instead.
  </Step>

  <Step title="Connect your phone">
    Plug the phone in over USB and click **Connect device**. Roveflow gets it ready in one tap:

    * **iPhone:** approve the on-screen prompt, then type your **passcode** when the phone asks.
    * **Android:** tap **Allow USB debugging** on the phone.
  </Step>

  <Step title="You're ready">
    Once the device shows green, you're set. Next: [map your first app](/app/mapping).
  </Step>
</Steps>

## First-time signing (iPhone)

If you've never built an app to this iPhone before, the app needs your Apple ID once to sign the
on-device helper it installs:

1. When prompted, enter your **Apple ID** and password in the app. A free Apple ID works.
2. If your account has two-factor auth, enter the **6-digit code** when the app asks.
3. Roveflow signs and installs the helper for you. Your signing key never leaves your Mac.

## Android setup

On Android there's no signing, just turn on USB debugging once:

1. **Settings → About phone** → tap **Build number** seven times to unlock Developer options.
2. **Settings → System → Developer options** → turn on **USB debugging**.
3. Plug in via USB and click **Connect device**; tap **Allow USB debugging** when the phone asks.