> ## 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](/publishing/app-stores/app-store/apple-developer-account).
* A [registered Bundle ID](/publishing/app-stores/app-store/register-bundle-id) for this app.
* A unique **app name** (up to 30 characters) that isn't already taken on the App Store.

## Register the app

<Steps>
  <Step title="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.
  </Step>

  <Step title="Open My Apps">
    From the dashboard, click **My Apps**.
  </Step>

  <Step title="Create a new app">
    Click the **+** button in the top left and select **New App**.
  </Step>

  <Step title="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.
  </Step>

  <Step title="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.
  </Step>
</Steps>

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

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

## Connect the app record to Rey

<Steps>
  <Step title="Open Publish settings in Rey">
    In the Rey editor, click **Publish** in the toolbar and select **App Store** as the target.
  </Step>

  <Step title="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.
  </Step>

  <Step title="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.
  </Step>

  <Step title="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.
  </Step>
</Steps>

## Next steps

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