Publish to Apple App Store

Kozmik supports publishing your app to the Apple App Store. To do this, you'll need to complete a few setup steps and provide us with some information. This guide details those steps.

To publish to the Apple App Store, you should complete the steps below

You should have an Apple account and a Developer membership.
Create a Bundle Identifier
Add A New App To App Store Connect
Generate Your App Store Connect API Key and add it to Kozmik
Update Apple Credentials on Kozmik Publish Screen

Apple Developer Account

Create an Apple Account if you don’t already have one
Enroll in the Apple Developer Program and purchase a membership ($99/year). Refer to this guide for more information on how to sign up.

Create a Bundle Identifier

Bundle Identifier (ID) of an IOS app is unique to your app which identifies it inside of Apple’s ecosystem.

First, you'll need to create a Bundle Identifier for your app in Kozmik.

In the Kozmik builder, click Publish button
Choose IOS App from Publish menu and choose "Apple Credentials" tab in Publish modal
Find where it says Bundle Identifier and enter your Bundle Identifier there.

Your Bundle Identifier should use the reverse-DNS name structure. For example, if the domain you will use for this app is example.com, set your Bundle Identifier to com.example.appname.

Next, log in to your Apple Developer account.

Go to your Apple Developer account and select Certificates, IDs & Profiles (far left menu) and then select Identifiers.
Click on the Add button (+).
The Register a new identifier page will open. Select App IDs and then select Continue.
Select App and then click Continue.
Enter the Apple Bundle information
- Bundle ID: Copy the Bundle Identifier from your Kozmik settings into this field. Be sure it matches the Bundle Identifier you entered in Project Settings. If they are different, you will encounter errors.
- Description: Enter a short description for your Bundle
- Capabilities: Scroll down and select the capabilities that are required for your app.
  - Kozmik requires Push Notifications, so check the box next to that capability.
  - Check the boxes next to any other capabilities your app requires.
When you are finished, select Register.

Add A New App To App Store Connect

Next, you need to add your app to App Store Connect which is where you will manage and submit your app to the App Store.

Go to App Store Connect and then select My Apps.
Click on the Add button (+) and then select New App.
Enter your app information in the modal that appears:
- Platform: for mobile apps, this will be iOS.
- Name: Enter a Name for your app (this is the name that will show in the App Store).
- Primary Language for your app.
- Bundle ID: Select the Bundle ID you created in the previous step.
- SKU: Enter a unique identifier. We recommend using your Bundle ID here, as long as it's unique.
- User Access: You should leave this set to Full Access unless you intend to only use this app privately. If you select Limited Access, you'll need to add the users that you would like to grant access to this app. This will only appear if you have other users included in your App Store Connect account.
When you are done, select Create.

Generate Your App Store Connect API Key

Next, you need to generate an API Key and add it to your Apple App Store settings in Kozmik. This step must be performed by an Admin User.

From the App Store Connect page, select Users and Access and then select Keys.
If you see the Request Access button, click on it.
If you haven't added a key before, click on the Generate API Key. Otherwise, select the Add button (+).
Enter your API Key Information in the modal that appears:
- Name: Enter a name for the key. This is a reference and is not part of the key itself. We recommend naming it ‘Kozmik Publishing’ so it will be easier to identify in the future.
- Access: Select App Manager as the access type. For additional information on Roles, see the docs here.
When you are done, select Generate.

Add Your API Key To Kozmik

Next you’ll need to get your API Private Key and add that to your Apple App Store settings in Kozmik.

From the App Store Connect page, select Users and Access, and then select Keys.
Find the row for the API Key you just generated and select Download API Key. A modal will appear, select Download. Refresh the page if the link doesn’t appear immediately.

Return to Kozmik and then: