App Settings
Overview
App settings is where you configure and customize various aspects of your app. It is organized into the following sections:
To view or change your app settings:
On your project's Design tab, click the gear icon in the left sidebar.
1. Project Settings
App Description
This describes your app and how you intend it to be used. While it is unnecessary to fill this out in Thunkable, if you publish your app, you must enter this information on Thunkable, the Apple App Store or the Google Play Store.
App Name
The app name is the public name you choose for your app. It is what is displayed on the Google Play Store or Apple App Store and that users see when they install your app on their device. This name is also used to set the page title when you publish as a web app.
The best practice is to select a short one or two-word app name. The maximum length of an app name is 30 characters.
The app name is different from the project name, which is displayed at the top of your project. While the project name is Thunkable-specific and may include details specific to your team, the app name is user-facing.
Default App Layout
This feature may only be available for Creators on certain Thunkable plans. Please refer to our pricing page for more information.
The best practice is to set your project's default app layout before you add components to your app screens. If you add components to your app screens and then change your project's default app layout, your designs will not automatically respond to the new size and layout, meaning that neither the size of your existing components nor the distance between components will change.
Use the dropdown menu to select your app's default layout. The options are:
Phone + Portrait
Phone + Landscape
Tablet + Portrait
Tablet + Landscape
Icon
Your app icon is the image that represents your app on your users' mobile devices. This icon will also appear on your listing in the Google Play Store or Apple App Store and as your project icon on Thunkable.
Ensure the file you upload does not have the same name as another asset used in your app. This will result in an error.
Users accessing apps built under our personal plans will see the default "Made with Thunkable" icon appear when their apps load. If you're interested in custom branding, this is available with our business plans. Learn more about our Thunkable plans here: Thunkable pricing page.
Icon Best Practices
| Property | Setting |
|---|---|
Size | 192 x 192 px (minimum) |
Shape | Square (equal height and width) |
File Type | Preferably .png (vs. jpg or other file types) |
For publishing to the iOS App Store, you will also need an app icon that does not have any transparency, or it may cause an error.
For publishing your app to the Google Play and Apple App Stores, you will need to create a separate icon with a higher resolution. For Google Play, the current requirement is 500 x 500 px. For the App Store, it's 1024 x 1024 px.
Splash Screen Image
To access your app's splash screen image settings:
Navigate to the project’s Design tab.
Click the Settings icon in the left sidebar.
Click the ellipsis icon at the bottom of the Project Settings section to access the advanced settings.
Picture
To customize your app’s splash screen picture:
Click in the Picture field.
Click Upload files and select an image from your computer, or select an image from your app’s current assets.
Splash Screen Picture Requirements:
The picture must be square. Rectangle pictures will not render correctly.
The ideal dimensions for your splash screen picture are 1152x1152 pixels.
If you want a transparent background, a PNG file is recommended.
Note: If you do not select a custom splash screen picture, your app icon image will be used by default.
Background Color
To customize the background color of your app’s splash screen:
Click in the Background Color field.
Use the color picker or input the HEX or RBGA codes to select your preferred color.
Note: If you do not select a custom splash screen background color, white will be used by default.
Sample Splash Screens
2. Publishing Settings
App (Bundle) ID
This is a unique identifier for your app on the App Store or Play Store. This field is auto-populated upon project creation, but if you choose to modify it, please ensure you follow the requirements below.
App (Bundle) ID Requirements:
The maximum length is 155 characters.
It must have at least two segments (one or more dots) - ex.
com.domain.creatorname.appnameEach segment must start with a letter (i.e. none of the segments can begin with a number).
All characters must be alphanumeric or an underscore.
A character cannot have an accent (e vs ë).
For auto-populated App (Bundle) IDs, if there are characters in the project name that are not alphanumeric (or an underscore), they will be omitted in the App (Bundle) ID.
Public App
Creators on certain Thunkable plans can set their app to private. A private app will not be displayed in the Thunkable Public Gallery. Learn more about public and private apps here: Public vs. Private Projects and more about our Thunkable plans here: Thunkable pricing page.
Auto-increment Version
When you publish to the App Store or the Play Store, you must increment (increase) your version number each time. If this switch is set to true, Thunkable will automatically increment your project's version number each time you publish your app (iOS) or download your app (Android).
Ignore Notch Area
In app development, the "notch area" refers to the space on the screen of a mobile device where the front-facing camera, sensors, and sometimes the speaker are located. By default, Thunkable adds the notched-out safe area at the top of the screen, resulting in a non-rectangular display shape.
If you set the Ignore Notch Area property to true, the screen background color will extend to fill the screen. However, if you do this, to avoid your app elements being blocked by the notch, you must manually address this in your app design.
Notch Area Background Color
By default, the notch area background color is white. You can change this color here if you wish, however. This is an app-level setting, and you won’t be able to customize the color at the screen level.
Android Publishing Details
Version Name
Set a version name for this version of your Android app.
Version Code
Set a version code for this version of your Android app.
iOS
Version Number
Set a version number for this version of your iOS app.
Tracking Usage Description (iOS only)
If your app or any external service your app interacts with is gathering any type of identifiable information, this must be explicitly disclosed to the end user of your app using an in-app prompt. If you do not include this and your app engages in tracking, Apple will reject your submission and ask you to resubmit while including an appropriate tracking string. To learn more about when to include a tracking string, click here.
iOS Permissions
When you add components that require permissions to your app, like the camera or map, you must add purpose strings for any relevant component in your app if you want to publish it to the App Store.
3. Integrations
If your app uses translation, image recognition, media upload to the cloud, or requires users to sign in, you can enter your personal API keys for these integrations in the app settings.
Firebase Settings
To learn more about the Firebase integration, please see here: Firebase Sign-in.
Google OAuth Settings
To learn more about the Google OAuth integration, please see here: Google Sign-In.
Google Map Settings
To learn more about the Google Map integration, please see here: Map.
AdMob Settings
iOS and Android App ID
Enter the AdMob app ID for your iOS and/or Android app. To learn more, see here: Find your app IDs & ad unit IDs.
Keystore
Import and export an Android Keystore to/from your app. Learn more about the Android Keystore here: Publish to Android > Keystore.
Cloudinary Settings
To learn more about the Cloudinary integration, please see here: Cloudinary.
Last updated
