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

# Register Your First App in App Store Connect

> Create your app record in App Store Connect — the App Store listing that Rey will submit builds to. Set your app name, primary language, Bundle ID, and SKU.

Before Rey can submit a build to the App Store, you need an **app record** in App Store Connect. This record is your app's listing — name, subtitle, screenshots, description, and pricing all live here. You only need to create it **once**, then Rey pushes new builds to it for every update.

## Prerequisites

* An active [Apple Developer Program membership](https://docs.reyapp.io/publishing/app-stores/app-store/apple-developer-account.md).
* A [registered Bundle ID](https://docs.reyapp.io/publishing/app-stores/app-store/register-bundle-id.md) for this app.
* A unique **app name** (up to 30 characters) that isn't already taken on the App Store.

## Register the app

**1. Sign in to App Store Connect**

Go to [appstoreconnect.apple.com](https://appstoreconnect.apple.com) and sign in with the Apple ID that owns your developer account.

**2. Open My Apps**

From the dashboard, click **My Apps**.

**3. Create a new app**

Click the **+** button in the top left and select **New App**.

**4. Fill in the app details**

A dialog appears. Enter the following:

* **Platforms**: Select **iOS** (and **iPadOS** if you support iPad).
* **Name**: Your public App Store app name, up to 30 characters. Must be unique across the App Store.
* **Primary language**: The default language for your listing.
* **Bundle ID**: Choose the Bundle ID you registered earlier (e.g. `com.reylabs.taskflow`).
* **SKU**: A private identifier for your reference — for example, `taskflow-ios-2026`. Users never see this. It only has to be unique within your account.
* **User Access**: Choose **Full Access** unless you have a reason to restrict it.

**5. Create the app record**

Click **Create**. App Store Connect creates the app and takes you to its dashboard, where you can fill in listing details.

> [!TIP]
>
> If the **Bundle ID** dropdown is empty, you haven't [registered a Bundle ID](https://docs.reyapp.io/publishing/app-stores/app-store/register-bundle-id.md) yet, or the identifier is scoped to a different team. Register one first, then reload App Store Connect.

## Fill in required listing details

Before submitting a build from Rey, App Store Connect requires these fields to be filled out. You can add them now or come back after uploading assets:

* **App icon** — 1024×1024 px PNG with no transparency.
* **Screenshots** — at least one screenshot per supported iPhone size (and iPad if applicable).
* **Description, keywords, promotional text, and support URL.**
* **Category** — primary and (optional) secondary category.
* **Age rating** — answer Apple's content questionnaire.
* **Pricing and Availability** — free, paid, or subscription; choose which countries to launch in.
* **App Privacy** — declare what data your app collects and how it's used.

> [!TIP]
>
> Rey validates all of the assets it manages (icon, screenshots, build) before submission. Anything you provide in App Store Connect — like descriptions and pricing — is your responsibility to review.

## Connect the app record to Rey

**1. Open Publish settings in Rey**

In the Rey editor, click **Publish** in the toolbar and select **App Store** as the target.

**2. Enter your Bundle ID**

Paste the same Bundle ID you used when creating the app record. Rey uses this to link builds to the correct App Store Connect listing.

**3. Connect your Apple Developer account**

Follow the prompt to authenticate with App Store Connect API credentials. This authorizes Rey to upload builds on your behalf. You only do this once per developer account.

**4. Ship your first build**

Click **Publish to App Store**. Rey builds and signs your app, then uploads it to the App Store Connect app record you just created. From here, submit it for review inside App Store Connect.

## Next steps

* Return to the [Publish to App Store overview](https://docs.reyapp.io/publishing/app-stores/app-store/overview.md) to complete your first submission.
* Preview your app on a real iPhone with [Device Preview](https://docs.reyapp.io/publishing/preview.md) before shipping.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.