Create your app in App Store Connect

App Store Connect is where Apple manages your app's listing, TestFlight builds, and App Store submissions. Before Ruby Native can upload a build, your app needs to exist there.

Ruby Native registers your bundle ID automatically, but Apple doesn't allow creating app records through their API. This is a one-time manual step that takes about two minutes.

#Before you start

Make sure you have:

#Create the app

  1. Go to appstoreconnect.apple.com/apps and sign in.
  2. Click the + button in the top left and select New App.
  3. Fill in the form:
Field What to enter
Platforms Check iOS
Name Your app's display name (e.g., "My App"). This is what users see on the App Store. You can change it later.
Primary language Your preferred language (e.g., English (U.S.))
Bundle ID Select your bundle ID from the dropdown. Ruby Native registered it when you entered your credentials.
SKU Any unique string. Your bundle ID works fine here.
User Access Full Access (unless you have specific team access needs)
  1. Click Create.

You'll land on your app's page in App Store Connect. That's it. Head back to Ruby Native and click Verify app to continue.

#Common issues

#Bundle ID not showing in the dropdown

The dropdown only shows registered bundle IDs. If yours isn't listed:

  • Wait a moment. It can take a minute after Ruby Native registers the bundle ID for it to appear in App Store Connect.
  • Check your credentials. Make sure the API key you entered in Ruby Native belongs to the same Apple Developer account you're signed into in App Store Connect.
  • Reload the page. Close the "New App" dialog, refresh, and try again.

#App name is taken

Apple requires unique app names across the entire App Store. If someone else is already using your preferred name, you'll need to pick a different one. This only affects the display name. Your bundle ID stays the same.

Try adding a descriptor (e.g., "Acme Tasks" instead of "Tasks") or use your company name as a prefix.

#"You don't have required role"

You need the Account Holder or Admin role in App Store Connect to create apps. If you're on a team, ask someone with the right role to either create the app or upgrade your access in Users and Access.