Settings
You can access all Settings from the left menu bar.
Basic Settings
Update the basic details of your project.
| Property | Description |
|---|---|
| Name | Set the name for your app. This name will also be the name of the folder that is downloaded when you export your project. |
| Description | Add more information about your application and state its purpose. |
| App Icon | Upload a .png image to use as your app's icon that will be displayed on a phone's home screen. Additionally, the icon will be displayed in Draftbit on the Dashboard. |
| Splash Screen | Upload a .png image that will be displayed while the application is loading. |
| Background Color | The colour will appear on the loading screen if a Splash Screen is not uploaded. |
| Background Resize Mode | Cover: The image is resized to fill the container while retaining its proportions, even if the container is larger than the dimensions of the image. Contain: The image is resized so that the picture fits within the container and is fully visible, even if that means the image will not fill the entire container. |
Advanced Settings
Configure the advanced settings for your app. Learn more about these settings in the docs.
→ General
| Property | Description |
|---|---|
| Scheme | Allows you to define a URL scheme to link into your app. To use Deep Linking in your app, you will need to define a Scheme. From other apps or links, the value of the Scheme property is used to open the app. For example, if you set the scheme myapp://, then any myapp://URL will open your app when tapped on that link. |
| Slug | If you are planning on publishing your application on Expo, the slug refers to the application's URL ending. Since this will be used in a URL, make sure to separate words with '-' instead of spaces. An example: https://expo.io/@community/my-draftbit-app where the slug is my-draftbit-app. |
| Platform Specific App | Define if your application supports Android, iOS, Web or All platforms. Defaults to All. |
→ STYLING
| Property | Description |
|---|---|
| Force Orientation | Select how your application is oriented on the screen. Defaults to 'Default' means the application will not be constrained to just one mode, either portrait or landscape. |
| User Interface Style | Configuration to force the app always to use the light or dark user-interface appearance, such as "dark mode", or make it automatically adapt to the system preferences. Defaults to Light. |
→ SETTINGS
| Property | Description |
|---|---|
| Offline Mode | Used to display a message to the app user when the application goes offline or there is no internet availability. Provides three options to select from: None (default), Banner, and Full. |
Android
These settings are used to configure Android versions of your project.
→ STYLING
| Property | Description |
|---|---|
| Background Color | To set the Background color of the app. Defaults to white (#ffffff) |
| User Interface Style | Configuration to force the app always to use the light or dark user-interface appearance, such as "dark mode", or make it automatically adapt to the system preferences. Defaults to Light. |
→ STATUS BAR
| Property | Description |
|---|---|
| Bar Style | Select bar style: Light Content or Dark Content. |
| Background Color | Update the android app status bar colour from here. |
| Hidden | The status bar can be made hidden using this setting. |
| Translucent? | Whether the Status bar needs to be translucent or not. |
→ NAVIGATION BAR
| Property | Description |
|---|---|
| Bar Style | Select bar style whether needed to be Light Content or Dark Content. |
| Visible? | The navigation bar Visibility setting can be updated from here. |
| Background Color | The background colour of the Navigation bar can be updated from here. |
iOS
These settings are used to configure iOS versions of your project.
→ STYLING
| Property | Description |
|---|---|
| Background Color | To set the Background color of the app. Defaults to white (#ffffff) |
| User Interface Style | Configuration to force the app always to use the light or dark user-interface appearance, such as "dark mode", or make it automatically adapt to the system preferences. Defaults to Light. |
→ DEVICE SUPPORT
| Property | Description |
|---|---|
| Supports Tablet | Define if your application supports tablets. Defaults to No. |
| Tablet Only? | If your application supports tablets only. Defaults to No. |
| Require Fullscreen | Defaults to No. |
→ PERMISSIONS
| Property | Description |
|---|---|
| Permissions | Define what permissions the app will ask for when installed. All permissions are disabled by default. You will have to set permissions manually for each device functionality. Note: If your application uses a device/hardware feature (an example: Camera), it is required to enable that permission under this section before publishing the app to the Google Play Store. You can enter a custom message for each notification. |
Web (PWA)
These settings are used to configure Web (PWA) versions of your project.
→ PWA PUBLISHING
| Property | Description |
|---|---|
| Show PWA Wrapper | Defaults to Yes. |
→ SETTINGS
| Property | Description |
|---|---|
| Force Orientation | Select the preferred orientation of the app from the available options: 1. Any 2. Natural 3. Landscape 4. Landscape Primary 5. Landscape Secondary 6. Portrait 7. Portrait Primary 8. Portrait Secondary |
| Display Mode | Select the prefferd display mode of PWA from the below options: 1. Fullscreen 2. Standalone 3. Minimal UI 4. Browser |
| Prefer Related App? | Defaults to No. |
→ STYLING
| Property | Description |
|---|---|
| PWA Theme Color | The default theme colour of the PWA. |
| Background Color | We can update the background colour from here. |
| Bar Style | Select the Bar Style: Default, Black or Black Translucent. |
Push Notifications
Configure the push notification settings for your app.
→ GENERAL
| Property | Description |
|---|---|
| Color | The colour of the Notification bar can be updated from here. |
| Should Show Alert | Shows the notification alert whenever a notification is delivered. By default, it is enabled. |
| Should Play Sound | Plays the device's notification sound when the notification is delivered. By default, it is disabled. |
| Should Set Badge | Display a badge depending on the number of notifications. By default, it is disabled. |
| Always Clear Badge? | Clears the badge of notification. By default, it is disabled. |
→ iOS
| Property | Description |
|---|---|
| iOS Display in Foreground | You can enable the iOS notification Display while the app is in Foreground. Defaults to NO. |
| Allow Background Push? | Allows the app to deliver notifications in the background. By default, it is disabled. |
→ Android
| Property | Description |
|---|---|
| Android Notification Mode | Set a notification appearance mode for Android devices. Defaults to Default that displays an expanded notification.The Collapse mode displays a notification in non-expanded mode. |
Integrations
Integration Keys
These keys are used to enable external integrations in your project.
→ SEGMENT ANALYTICS
| Property | Description |
|---|---|
| Segment Key | Add a Segment key to enable it in the app. |
→ GOOGLE MAPS
| Property | Description |
|---|---|
| Android Maps Key | Add Android Maps Key here to enable the maps. |
| iOS Maps Key | Add iOS Maps Key here to enable the maps. |
GitHub
→ Commit to Github
Connect your GitHub repo to Draftbit and commit code directly to a branch.
| Property | Description |
|---|---|
| Repository URL | The repository can live under a user or organization account. |
| Branch Name | Add the Branch Name here. Make sure the branch exists in your repository. |
| GitHub Token | Add GitHub token here. Create a personal access token with "repo" scopes here. |
Apple App Store
Apple App Store Publishing Settings
This information is required for us to publish to the Apple App Store on your behalf.
→ BUILD CONFIGURATION
Please choose a unique package name for your app, preferably using the reverse-DNS name structure. For example, if the domain you will use for this app is example.com, set your package name to com.example.appname
| Property | Description |
|---|---|
| Bundle Identifier | The app bundle identifier is to be updated here. |
| App Store App ID | add App Store App ID here. |
| iOS Build Type | Select build type from: Build, Publish or Custom. |
→ APP STORE CREDENTIALS
These credentials from your Apple Developer Account and Apple App Store Account are required for us to complete the iOS build and submission process on your behalf. Having trouble finding them? Follow our guide.
| Property | Description |
|---|---|
| Connect Private Key | Generating an API key allows you to configure, authenticate, and use one or more Apple services for that key. Keys don’t expire, but can’t be modified to access more services once created. You can have a maximum of 50 active keys at a time. |
| Connect Key Id | Connect key ID is the ID of Connect private key. |
| Connect Issuer Key | Identifies the issuer who created the authentication token. |
→ APP STORE-RELATED SETTINGS
| Property | Description |
|---|---|
| App Store URL | Need to add the app store URL of the app here. |
| Uses Apple Auth | A boolean indicating if the app uses Apple Sign-In. Defaults to NO. |
| Uses iCloud Storage | A boolean indicating if the app uses iCloud Storage. Defaults to NO. |
| Associated Domains | An array that contains Associated Domains for the standalone app. |
| UI Background Modes | Allows configuring a notification in background mode. |
| Deep Links To Other Apps | Allows Deep Linking to another application. |
Google Play Store
Google Play Store Publishing Settings
This information is required for us to publish to the Google Play Store on your behalf.
→ EXPO EAS ACCOUNT
We use Expo EAS to complete the Android build and submission process on your behalf. You will need to create a free Expo account to get started. Once your account has been created, please invite [email protected] to your Expo account.
| Property | Description |
|---|---|
| Expo Account Name | Need to add the expo account name here. |
| What kind of build? | Select the build option: 1. Build 2. Build & Submit 3. Disabled |
→ BUILD CONFIGURATION
Please choose a unique package name for your app, preferably using the reverse-dns name structure. For example, if the domain you will use for this app is example.com, set your package name to com.example.appname.
| Property | Description |
|---|---|
| Package Name | Need to add the package name here. |
| Release Status | To select the release status of the app: 1. In Progress 2. Draft 3. Halted 4. Completed Defaults to Draft. |
→ GOOGLE SERVICE ACCOUNT
We require this to upload builds to your Google Play Console. Note: Google requires you manually upload a binary to any new app you create. We'll handle uploading all future binaries using this key. Having trouble? Follow our guide.
| Property | Description |
|---|---|
| Service Account File | Need to upload the Service account file here. |
→ PLAY STORE RELATED SETTINGS
| Property | Description |
|---|---|
| Play Store URL | To add the play store URL. |
| Allow Backup | Allows users' app data to be automatically backed up to their Google Drive. Defaults to NO. |
Expo
Expo Version
We use Expo and Expo EAS to build, preview and publish your application. Expo is regularly updated with new features, performance improvements and bug fixes. We strongly recommend to use the latest expo version.
→ UPDATE EXPO VERSION
Select the version of Expo you want to use in previews, publishing, and code export.
| Property | Description |
|---|---|
| Expo version | Select the Expo version of the app: Expo 46 or Expo 47. Defaults to Expo 46. |
For application publishing settings
- For iOS: see the detailed information on settings at Publishing Your App to the Apple App Store
- For Android: see the detailed information on settings at Publishing Your App to the Google Play Store
Updated about 2 months ago