# iPhone test build

> This page is about FlutterFlow (the app builder you use by describing your app), not FlutterFlow Studio.

URL: https://docs.flutterflow.io/ffx/iphone-test-build

Prepare an iPhone test build of your app in Releases, upload it to TestFlight, and install it on your iPhone.

Prepare an iPhone [test build](https://docs.flutterflow.io/ffx/glossary#test-build) of your app, upload it to TestFlight, and install it on your own iPhone.

You need an [App ID](https://docs.flutterflow.io/ffx/app-details#app-id) and a connected Apple Developer account (see [Connect App Store Connect](https://docs.flutterflow.io/ffx/connect-app-store)). FlutterFlow builds from your app, not a thread, so [push](https://docs.flutterflow.io/ffx/push) your changes first.

## Prepare the iPhone app {#prepare-the-iphone-app}

Use the **iPhone app** row in **On your phone** to build your app and upload it to TestFlight:

1. Open **Releases** and select **On your phone**.
2. In the **iPhone app** row, select **Prepare for TestFlight**.
3. Wait while the row shows **Preparing app…** and then **Uploading to TestFlight…**.
4. If the row shows **Waiting for the app in App Store Connect**, select **Create app in App Store Connect** to open the **Releases** step with the required details, and create the app in App Store Connect. See [Add to App Store Connect](https://docs.flutterflow.io/ffx/add-to-app-store).

## Install the app {#install-the-app}

After the upload finishes, **On your phone** shows how to install the build through TestFlight:

1. In App Store Connect, add yourself to a TestFlight testing group and assign this build. To open your app's TestFlight page directly, select **Manage TestFlight testers**. See [Add testers](https://docs.flutterflow.io/ffx/testers).
2. On your iPhone, install TestFlight from the App Store (select **Get TestFlight for iPhone** for the link).
3. On your iPhone, accept your testing invitation and install the app in TestFlight.

FlutterFlow builds your app for iPhone only, so the App Store requires no iPad screenshots.

<Mock name="on-your-phone-iphone-testflight" alt="The On your phone panel with the iPhone app row saying Uploaded to TestFlight. Add yourself as a tester to install it, the TestFlight install steps, and the Manage TestFlight testers and Get TestFlight for iPhone links." />

## Only an iPhone {#only-an-iphone}

Building an iPhone test build requires an Apple Developer account. Until you connect one, the **iPhone app** row says **Connect your Apple Developer account to continue.** Select **iPhone app** to connect your account.

Without an Apple Developer account, you can still open your app on your iPhone using a [share link](https://docs.flutterflow.io/ffx/glossary#share-link). On a computer, select **Open Share** in **On your phone** to copy your app's link, and open it in Safari on your iPhone. See [Open on a phone](https://docs.flutterflow.io/ffx/open-on-a-phone).

If you don't use an Android phone, select **I only have an iPhone** so the **On your phone** step in **Releases** waits for your Apple Developer account instead of offering the Android build.

## Ask the agent for the iPhone app {#ask-the-agent}

You can also ask [the agent](https://docs.flutterflow.io/ffx/glossary#the-agent) in a thread to build the iPhone app:

> Example request: "Build the iPhone app so I can test it on my phone."

The agent builds your app's pushed state rather than the thread's copy, so push the changes that you want in the build first. An **iPhone app** **Version** card tracks the build; select **Open in Releases** to view it in **Releases**, and then follow [Install the app](#install-the-app).

<Mock name="version-card-iphone" alt="A Version card titled iPhone app saying Ready for testing on TestFlight. Check tester access in App Store Connect, with 0.1 · Budget alerts and Open in Releases." />

## Troubleshooting {#if-something-goes-wrong}

For problems preparing or uploading the iPhone app, see [Troubleshoot phone builds and store releases](https://docs.flutterflow.io/ffx/troubleshoot-releases).