Skip to content

Mobile Configuration

Overview

The Mobile tab of the application configuration lets you configure settings specific to mobile app exports. This includes the app's identity, author information, visual resources, screen preferences, splash screen behaviour, and platform-specific settings for Android and iOS.

For documentation on building and exporting your app to mobile platforms, see Mobile Applications.

What You Will Learn

🔒 Heads up: This feature is limited to paid plans only.

  • What mobile configuration options are available for a Bellini application
  • How to configure the app's identity, author information, and visual resources
  • How to set screen and splash screen preferences
  • How to configure Android and iOS code signing and platform-specific preferences

When To Use This

Use this tab when:

  • You are preparing your application for export as a native iOS or Android app.
  • You need to configure code signing credentials for Android or iOS distribution.
  • You want to customise the app icon, splash screen, or screen orientation for mobile.

Mobile App Identity

Field Required Description
Name No The app's formal name as it appears on the device's home screen and in app store interfaces. Defaults to the application name set in the General Settings tab.
Package Name No The app's unique identifier in reverse-DNS format (e.g. com.example.myapp). Only alphanumeric characters and dots are allowed.
Short Name No An optional shorter display name for the home screen, used when space is limited.
Description No Metadata that may appear in app store listings.

Author Information

Field Description
Name The author's name. Defaults to the currently logged-in user's name.
Email The author's email address. Defaults to the currently logged-in user's email.
Website The author's website URL.

App Resources

Field Description
Icon A graphic symbol representing the app on the device. Selected from the application's assets. Minimum required size: 1024 × 1024 px.
Splash Screen An image displayed when the app launches. Selected from the application's assets. Minimum required size: 2732 × 2732 px.

Icon and splash screen image files must first be added to the application's assets before they can be selected here.

Screen Preferences

Field Description
Fullscreen If checked, the app runs in fullscreen mode, hiding the device's status bar.
Orientation Sets the screen orientation. Options: Default, Portrait, Landscape.

Splash Screen Preferences

Field Description
Auto Hide Splash Screen If checked, the splash screen is hidden automatically after the delay period.
Splash Screen Delay Time in milliseconds to wait before hiding the splash screen. Setting this to 0 disables the splash screen entirely.
Fade Splash Screen If unchecked, the splash screen will not fade in or out when its display state changes.
Fade Splash Screen Duration Duration in milliseconds for the splash screen fade effect.

Android Settings

Android Code Signing

Field Description
Keystore File A binary file (.jks or .keystore) containing private keys used to sign the Android app during the build process. Click Add to open a wizard and select the file.

Android Preferences

Field Description
Android Insecure File Mode Enabled Enables insecure file mode on Android.
Android Launch Mode Sets the launch mode for Android activities. Options: Standard, Single Top, Single Task, Single Instance.
Keep Running If checked, the app continues running in the background.
Loading Dialog Sets the title and message text for the loading dialog shown during startup.
Load URL Timeout Value Timeout in milliseconds for loading a URL.
Show Title Determines whether to show the title of the web view.

iOS Settings

iOS Code Signing

Field Description
Store Certificate An Apple Developer or Distribution Certificate (.cer, .p12, or .pfx) used to verify the developer's identity and sign the app. Click Add to open a wizard and select the file.
Provisioning Profile A configuration file (.mobileprovision or .provisionprofile) that links the app's bundle identifier with the store certificate and specifies allowed devices or distribution methods. Click Add to open a wizard and select the file.

iOS Preferences

Field Description
Deployment Target The minimum iOS version required to run the app.
Target Device Specifies the target device type. Options: Universal, Handset, Tablet.
Allow Inline Media Playback If checked, media plays within the web view rather than launching fullscreen.
Backup Web Storage Specifies where the app's web storage data is backed up. Options: Local, Cloud, None.
Enable Viewport Scale If checked, enables scaling of the web view's viewport.
Gap Between Pages The gap in pixels between pages when paginating. Minimum: 0.
Page Length The length of each page in pixels when paginating. Minimum: 0.
Pagination Breaking Mode Behaviour when breaking pages while paginating. Options: Page, Column.
Pagination Mode Sets the pagination mode for web views. Options: Unpaginated, Left to Right, Top to Bottom, Bottom to Top, Right to Left.
Suppresses 3D Touch Gesture If checked, disables the 3D Touch gesture in the web view.
Suppresses Incremental Rendering If checked, waits until all content is received before rendering to the screen.
Suppresses Long Press Gesture If checked, disables the long-press gesture in the web view.
Top Activity Indicator Sets the colour of the top activity indicator during page transitions. Options: White Large, White, Gray.

Helpful Resources