App Store Deployment with Codemagic
You can now integrate FlutterFlow with Codemagic, making app store deployment as simple as a click of a button.
Before deploying your app, we recommend testing your application on a real device. Here are instructions on how to do this.
- Purchase an Apple Developer membership. Please see this link for more details on the Apple Developer program and how to sign up.
- Set an App Launcher Icon for your app (under Settings & Integrations --> General). The App Launcher icon can't be transparent or contain an alpha channel.
A Bundle Identifier (ID) is a unique number that identifies your app inside of the Apple ecosystem.
Please follow these steps to create a Bundle ID:
- Open your FlutterFlow project and navigate to Settings & Integrations. Select your Package Name and copy it (Cmd/Ctrl + C).
- Open the Apple Developer homepage and select Certificates, IDs & Profiles and then select Identifiers (far left menu).
- 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.
- Bundle ID: paste the Package Name that you copied from FlutterFlow. Double-check that the Package Name in FlutterFlow is the same as the Bundle ID. If these are different, errors will occur.
- Description: Provide a short description of your app (this will appear in the app store).
- Capabilities, scroll down and select the capabilities that are required for your app. For example, if your app uses Apple Sign In - make sure to check the box for Sign In with Apple. If you aren't sure what something is, hover over the information icon to the right of the capability.
- When you are done, select Register.

Please follow these steps to add a new app to App Store Connect:
- Click on the Add button (+) and then select New App.
- 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. You can also add your Bundle ID here, as long as it is unique.
- User Access: Set the user access. If you select Limited Access, you will need to select the users that you would like to be able to access this app. This will only appear if you have other users included in your App Store Connect account.
- When you are done, select Create.
You will then be navigated to the main dashboard for your app.
.gif?alt=media&token=dc25bdc6-6940-43f0-9cc1-32c50d1ba1ba)
An App ID is used by Apple to identify your app and associate it with your development team.
Please follow these steps to add your App ID to FlutterFlow:
- Select App Information (under General in the left Sidebar).
- Scroll down to General Information and find your Apple ID.
- Select the Apple ID and copy it.
- Paste the Apple ID into the box labeled App ID.
.gif?alt=media&token=9a0be428-b6e5-4357-a20e-bf7b2596975f)
Please follow these steps to generate your API Key:
- Return to the App Store Connect page. If you have closed this window, navigate to App Store Connect and select Users and Access, and then select Keys (blue text).
- If you see the Request Access button, click on it.
- If you haven't added any key before, click on the Generate API Key. Otherwise, select the Add button (+).
- A popup will appear. Enter your API Key Information:
- Name: Enter a name for the key. This is a reference and is not part of the key itself.
- When you are done, select Generate.
- Find the row for the API Key you just generated and select Download API Key. A popup will appear, select Download.
- Under Private Key, select Upload Private Key. Select the API Key File and then select Open.
If you don't see the Download API Key link immediately, refresh your page.
.gif?alt=media&token=217e80b8-2670-4de3-a9d0-c3c5c96aeea8)
- Locate the Issuer ID and select Copy.
- Paste the Issuer ID into the box labeled Issuer ID.
.gif?alt=media&token=35374f14-1808-48dc-aa98-bb44e7d3b1ab)
- Return to the App Store Connect page. If you have closed this window, navigate to App Store Connect and select Users and Access, and then select Keys (blue text).
- Find the row for the API Key you just generated and select Copy Key ID.
- Paste the Key ID into the box labeled Key ID.
.gif?alt=media&token=eb826d8a-a135-4686-88dd-f1c0c68f0b68)
You can deploy directly from FlutterFlow or from your GitHub repository.
Deploy From FlutterFlow
Deploy From GitHub
Please follow these steps to deploy from FlutterFlow:
- From FlutterFlow, navigate to Settings & Integrations --> Deployment.
- Scroll down to find the App Store section and click on the arrow icon on the right to open it.
- Click on the Deploy To App Store.
- A popup will appear. Select Deploy. If another deployment is in progress, selecting Deploy will cancel the previous deployment.
- A request will be sent to Codemagic to deploy your app to the App Store. Please note: It can take a few minutes for this request to process. Once this step is complete, your Latest Message will change to Submitted.
- It can take 30 minutes to several hours for your app to be deployed to the App Store. You can check the status of your deployment by selecting Check Build Status.
- Once complete, you will receive an email from App Store Connect that a new build has been added to your app.
.gif?alt=media&token=300e042a-c101-4508-95e4-099ddcaa6eed)
Associating the Github repo allows you to introduce the custom code into your FlutterFlow project. You may want to deploy the modified code directly from your Github repo to App Store.
To deploy from Github repo:
- From FlutterFlow, navigate to Settings & Integrations --> Deployment.
- Find the Deployment Settings section and click on the arrow icon on the right to open it.
- Under the Deployment Source, checkmark the Use Github repo: 'your repo URL'.
- Enter the Branch Name of your repo, from which you want to deploy the code. Make sure to enter the correct branch name.
.gif?alt=media&token=d9388dab-0643-463d-a505-0627da6f52fe)
- From App Store Connect, select My Apps, and then select your app.
- Enter your Version Information. This page contains additional information on what is required, localized and, editable.
- When you are done, select Submit For Review.
Your app will now be reviewed by Apple. For additional information on Apple's review guidelines, please see this link.
.gif?alt=media&token=5ac5542c-46f9-46dd-8193-955ce4a489a0)
You need to update your App Launcher Icon (under Settings & Integrations --> General) with an image that isn't transparent and/or doesn't contain an alpha channel.