How to publish your Thunkable Project to the Apple App Store
Publishing your app to the App Store can be a rewarding process.
Apple requires a lot information for apps that are available in their App Store. As a result, the publishing process can feel long and will require at least 20 minutes to complete the necessary steps on the Thunkable website, which currently requires information from 4 different Apple websites. We recommend completing the Prepare for Submission steps before starting the publishing process in Thunkable.
Thunkable is continually looking for ways to streamline the publishing process and has made it possible for creators to publish from a non-Mac computer, which is normally required by the standard publishing process.
In this document, the version of your app that you submit to the App Store is referred to as a build.
Apple holds a high standard for apps that are approved for distribution in the App Store so please review Apple's policies and guidelines to make sure your app is in compliance before you sign up for the Apple Developer Program
You will need to set a version number in your project. You can set your version number in the Project Settings panel under iOS > Version Number.
If this is your first time sending this app to App Store Connect, you can set the version number to 1. You will need to increment your version number, or increase it by 1, every time you submit a build to App Store Connect.
Review your App Permissions
Apple requires that you explain to users why you may need access to sensitive services like a camera, photo library and microphone. You can add these explanations in the App Settings panel under iOS Permissions.
Create an Apple Developer Account
You will need an Apple Developer Account to publish an app to the App Store. To obtain a developer account you must enroll in the Apple Developer Program. An Apple Developer Account costs $99/year.
Certain educational institutions qualify for free Apple developer accounts. To check if your school or university if eligible, please visit this Apple site.
Create an App-specific password
If a developer uses a third-party platform like Thunkable to send an app build to App Store Connect, the developer needs to create an app-specific password.
You only need one app-specific password for Thunkable to send any build to App Store Connect on your behalf.
You do not need separate app-specific passwords for separate Thunkable projects.
You will need this password to send a new build to your App Store listing in the future, so make sure to record it securely.
Go to the App-Specific Passwords section and click View History
Click the ⓧ next to an individual password to revoke it, or click 'Revoke All' to revoke all of your app-specific passwords
Register an App ID on App Store Connect
Every app published on the App Store must have a unique name. For example, there can only ever be one app called Thunkable Sample App. You can Register your App ID to reserve the name you want!
Go to the Apple Developer websitetoregister a new App ID. Click through the tabs below to see each screen in the ID creation process.
Step 6 in the tabs below shows you where to find your App Name, Team ID, and Bundle ID.
App Name: The app Name must be unique to the App Store and is what appears next to the app icon when it is downloaded on a user's phone.
Team ID: A unique account identifier that is linked to your Apple Developer Program membership. Apple will automatically create this for you, and it can be used for every app you publish.
Bundle ID: Also unique to your app, but not visible to your app users. Otherwise, a single Explicit App ID should work. Apple recommends reversing your domain name to create your bundle ID i.e. com.yourDomainName.yourAppName to avoid conflicts with other apps.
Note: Starting June 16, 2020, uploading apps to the App Store requires an explicit bundle ID. Wildcard bundle IDs are no longer available when creating app records.
Open your Apple Developer account page and choose the Certificates, IDs & Profiles option from the menu on the left hand side of the screen.
From the menu on the left, click on the Identifiers menu item
Click on the blue + icon to add a new ID to your account.
Choose App IDs from the list of options and then click on the blue Continue button to go to the next screen.
For the app Description enter the name you want to give your app and for the Bundle ID enter the bundle ID from your Thunkable project settings. Click Continue to review these details.
Once you are happy with these detail, click Register to confirm your app ID.
This new app ID is added to your list of app IDs.
Create an App Listing on App Store Connect
Once you have registered an App ID, you can create an app listing on App Store Connect. This is where you will manage your submission to the App Store.
Go to the App Store Connect website and follow the steps below to create your App Store listing with the App Name and Bundle ID you registered earlier.
You will need to use the same App Name and Bundle ID you registered earlier. If you registered an 'Explicit App ID', you will enter it into the Bundle ID field above.
Thunkable enables you to send your build directly to the App Store without the need for any specialized software or hardware. To begin the process, click on the Download/Publish icon and choose Publish iOS from the drop-down menu.
A publishing dialog will pop up to guide you through the publication process. Please take a moment to read all the instructions.
Click the Get Started button to proceed.
Enter your Apple Developer Account details
Enter the Apple ID and password that are associated with your Apple Developer account. Since Two Factor Authentication (2FA) is now the default for Apple accounts, it is assumed that you have this enabled. The rest of this guide shows the steps for publishing with 2FA enabled. Click the Next button to proceed.
Register Your App ID
If you did not register an App ID before getting started, now is the time to do so.
Two-factor authentication helps to keep your account secure and Apple has made it mandatory for new developers to turn two-factor authentication on. If you do have 2FA turned on, you'll need to complete the following steps to confirm your identity with Apple.
In the publishing dialog, click the link that says Click to Download CSR. This is your Certificate Signing Request file and you will need it to generate an iOS Distribution Certificate.
Go to the Certificates page in your Apple Developer account to generate an iOS Distribution Certificate.
You may already have an account certificate in your account. You can only have two certificates per account so you may need to revoke a certificate before you can create a new one.
Click on the blue + icon to create a new iOS distribution certificate.
Choose iOS Distribution (App Store and Ad Hoc) from the next list and click Continue.
Upload an Icon and enter your Build Number and Version Number
You're almost there! Review your app icon and your Build Number and Version Number.
App icon: This app icon appears when a user downloads your app from the App Store. Our recommended size is 192 x 192 px. This icon must not have any transparent pixels.
Build and Version Numbers: The version number is visible to your users when they download a new version of your app. The build number needs to increase with each version and is only visible to you. You can opt to let Thunkable automatically increment your build and version numbers.
You should shortly receive an email from Thunkable to let you know that your build is being sent to the App Store. There are still a number of steps that you need to complete on App Store Connect before your app can be published, but that's everything completed from the Thunkable side of things - congrats!
Next Steps - App Store Connect
You will need to provide some information to Apple about your app before it can be reviewed and published.
You should receive an email from Apple that says your app is ready in the App Store Connect website. This may take up to an hour.
To view your build:
Go to your App Store Connect dashboard
Select the app listing of the build you have just uploaded
You will see the app listing homepage. This page contains the tabs App Store,Features and TestFlight.
If your build is submitted successfully, it should appear under the TestFlight tab in this app listing homepage. TestFlight is a tool from Apple that allows you to test your app before it is submitted for release in the App Store.
(If there are any issues, you’ll get an email from us telling you what you’ll need to fix.)
Back in the App Store tab, scroll down to the section titled Build and click the button that says Select a build before you submit your app.
You will see a dialog that allows you to select a build to attach to this app listing. Select your chosen build and click Done.
Now you can review the App Information included in your App Store tab. You can review Apple's advice on filling in your app information on this webpage.
Pricing and availability
Set a price point for your app. Apps can also be distributed for free.
The final section requires screenshots for both iPhone and iPad and a high resolution icon.
The high resolution icon will be featured in the App Store listing and must be 1024 x 1024 px with no transparency. To generate this icon, we recommend a tool like this.
App Store Connect. Make sure to follow this step on creating a new app on iTunes Connect
Certificates. If you have an existing Apple Developer Program account with 2 iOS certificates, you'll have to revoke one. Apple only allows developers to have 2 iOS certificates at a time and Thunkable creates one when it publishes to your account
Provisioning profile. After you revoke your certificate, it is possible that one or more of your provisioning profiles will become inactive. To publish successfully, you'll also need to delete any inactive provisioning profiles
Login. Apple ID or password were entered incorrectly. Since we don't store either one, there's no easy way for us to check so enter it slowly
Apple ID and privacy terms. You must accept Apple's new Apple ID and privacy terms.
You see a message saying "ITMS-90809: Deprecated API Usage - Apple will stop accepting submissions of apps that use UIWebView APIs". This is a warning, but you can still publish your app. See the Web Viewer documentation for more details.
Adding Push Notifications
To publish an app to the App Store that contains Push Notifications, you need to:
send an app that does not contain Push Notifications to App Store Connect