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

# Publish Your Rey App to the Apple App Store

> Submit your Rey app to the Apple App Store so real users can discover and download it — no Xcode or coding required.

Publishing to the Apple App Store puts your app in front of over a billion iPhone and iPad users. Rey handles the build, code signing, and submission — you focus on filling out the **Configure iOS deployment** dialog.

## Before you start

You'll need each of these set up on Apple's side before Rey can build and submit your app.

<CardGroup cols={2}>
  <Card title="Apple Developer account" icon="user" href="/publishing/app-stores/app-store/apple-developer-account">
    Enroll in the Apple Developer Program (\$99 USD/year).
  </Card>

  <Card title="Bundle ID" icon="fingerprint" href="/publishing/app-stores/app-store/register-bundle-id">
    Register a unique identifier for your app.
  </Card>

  <Card title="App record in App Store Connect" icon="app-window" href="/publishing/app-stores/app-store/register-first-app">
    Create the App Store listing your builds will be uploaded to.
  </Card>

  <Card title="App Store Connect API key" icon="key" href="/publishing/app-stores/app-store/credentials">
    Team ID, Issuer ID, Key ID, and the `.p8` private key.
  </Card>
</CardGroup>

## Configure iOS deployment

Open your app in Rey, click **Publish** in the top toolbar, and choose **iOS**. The **Configure iOS deployment** dialog has three tabs — **App**, **Credentials**, and **Assets**. You can save partially and come back later.

<Tabs>
  <Tab title="App">
    <Frame>
      <img src="https://mintcdn.com/rey-62fd4809/1S3nMA6YX09xuXSk/images/ios-deployment/app.png?fit=max&auto=format&n=1S3nMA6YX09xuXSk&q=85&s=f8d5dd42f55312795c5875ae0c958501" alt="Configure iOS deployment — App tab" width="2084" height="1214" data-path="images/ios-deployment/app.png" />
    </Frame>

    | Field                   | What to enter                                                                                                                                                                             |
    | ----------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
    | **App name**            | The name people see under the app icon on their home screen. Keep it short so it fits — it doesn't have to match your App Store listing name.                                             |
    | **Package / bundle ID** | The Bundle ID you registered earlier (e.g. `com.yourcompany.yourapp`). Find it in App Store Connect under **Apps → (your app) → Distribution → App Information**, labelled **Bundle ID**. |

    See [Register a Bundle ID](/publishing/app-stores/app-store/register-bundle-id) if you haven't created one yet.
  </Tab>

  <Tab title="Credentials">
    <Frame>
      <img src="https://mintcdn.com/rey-62fd4809/1S3nMA6YX09xuXSk/images/ios-deployment/credentials.png?fit=max&auto=format&n=1S3nMA6YX09xuXSk&q=85&s=4b1461996bdcd7263658d785dc45b71c" alt="Configure iOS deployment — Credentials tab" width="1926" height="1616" data-path="images/ios-deployment/credentials.png" />
    </Frame>

    Four values connect Rey to your Apple account so it can upload builds on your behalf:

    * **Apple Developer Team ID**
    * **App Store Connect Issuer ID**
    * **App Store Connect Key ID**
    * **App Store Connect private key** (`.p8` file contents)

    Full walkthrough with links to where each value lives: [Get your App Store Connect credentials](/publishing/app-stores/app-store/credentials).
  </Tab>

  <Tab title="Assets">
    <Frame>
      <img src="https://mintcdn.com/rey-62fd4809/1S3nMA6YX09xuXSk/images/ios-deployment/assets.png?fit=max&auto=format&n=1S3nMA6YX09xuXSk&q=85&s=160543914cd0bb61292a2882d6cf1c38" alt="Configure iOS deployment — Assets tab" width="1890" height="1612" data-path="images/ios-deployment/assets.png" />
    </Frame>

    | Asset                | Requirement                                                                                     |
    | -------------------- | ----------------------------------------------------------------------------------------------- |
    | **Icon**             | 1024×1024 PNG. Used as the app icon and, if no splash image is provided, as the splash screen.  |
    | **Splash Image**     | 2732×2732 PNG. Shown on launch on both iOS and Android. Falls back to the icon if not uploaded. |
    | **Background Color** | Hex color used behind the icon and splash on both platforms.                                    |

    <Tip>
      Use a PNG with no transparency for your icon — Apple rejects icons with alpha channels.
    </Tip>
  </Tab>
</Tabs>

## Submit your app

<Steps>
  <Step title="Fill out all three tabs">
    Complete **App**, **Credentials**, and **Assets** in the Configure iOS deployment dialog, then click **Save**.
  </Step>

  <Step title="Click Publish to App Store">
    Rey builds your app, signs it with your credentials, and uploads it to App Store Connect.
  </Step>

  <Step title="Finish the listing in App Store Connect">
    Log in to [App Store Connect](https://appstoreconnect.apple.com) to add screenshots, description, keywords, category, and age rating, then submit for review.
  </Step>

  <Step title="Monitor your review status">
    Apple's review process typically takes **1–3 business days**.
  </Step>
</Steps>

<Warning>
  Make sure your app complies with [Apple's App Store Review Guidelines](https://developer.apple.com/app-store/review/guidelines/) before submitting. Common rejection reasons include misleading descriptions, broken functionality, and missing privacy disclosures.
</Warning>

## Publishing app updates

When you're ready to release a new version, make your changes in the Rey editor and click **Publish** again. Rey increments the version number, rebuilds, and resubmits to App Store Connect. You don't need to touch Xcode or any build tooling.

## Plan requirements

Publishing to the App Store is included on all paid plans — **Starter**, **Grow**, and **Scale**.