Skip to main content

Mobile App Customization

This guide covers how to white-label and customize both the Android and iOS apps. Follow these steps when you want to rebrand the apps under your own product name and visual identity.

What You Can Customizeโ€‹

  • App name (shown under the icon on the home screen)
  • App icon
  • Launch screen / splash screen
  • Primary and accent colors
  • Default instance URL (pre-filled on the login screen)
  • Bundle identifier / package name (required for store submission)

Android Customizationโ€‹

App Nameโ€‹

Edit app/src/main/res/values/strings.xml:

<string name="app_name">Your App Name</string>

Package Nameโ€‹

  1. In Android Studio, right-click your package folder and use Refactor โ†’ Rename to rename the package.
  2. Update applicationId in app/build.gradle: 
    applicationId "com.yourcompany.yourapp"

App Iconโ€‹

Replace the files in:

  • app/src/main/res/mipmap-hdpi/ic_launcher.png
  • app/src/main/res/mipmap-mdpi/ic_launcher.png
  • app/src/main/res/mipmap-xhdpi/ic_launcher.png
  • app/src/main/res/mipmap-xxhdpi/ic_launcher.png
  • app/src/main/res/mipmap-xxxhdpi/ic_launcher.png

Android Studio's Image Asset Studio (File โ†’ New โ†’ Image Asset) can generate all sizes from a single 1024x1024 source image.

Colorsโ€‹

Edit app/src/main/res/values/colors.xml:

<color name="colorPrimary">#E63946</color>
<color name="colorPrimaryDark">#C1121F</color>
<color name="colorAccent">#2EC4B6</color>

Default Instance URLโ€‹

Find the constant in the project (look for DEFAULT_BASE_URL or similar in a Constants.kt or Config.kt file) and set it to your LeadHub instance URL. This pre-fills the URL field for users so they do not need to type it.

iOS Customizationโ€‹

App Nameโ€‹

  1. In Xcode, click the project root in the Navigator.
  2. Under Targets, select your app target.
  3. In the General tab, change Display Name to your product name.

Bundle Identifierโ€‹

Change the Bundle Identifier in the same General tab:

com.yourcompany.yourapp

This must be unique and registered in your Apple Developer account.

App Iconโ€‹

  1. In Xcode, open Assets.xcassets.
  2. Click AppIcon.
  3. Drag your icon images into the appropriate slots. You need a 1024x1024 image for the App Store and various smaller sizes for devices.

Xcode's asset catalog will tell you what sizes are needed. Use a tool like makeappicon.com to generate all required sizes from a single source.

Launch Screenโ€‹

Edit LaunchScreen.storyboard in Xcode to customize the splash screen shown while the app loads.

Colorsโ€‹

Look for a Colors.swift or Theme.swift file in the project and update the primary and accent color values:

struct Theme {
    static let primaryColor = UIColor(hex: "#E63946")
    static let accentColor  = UIColor(hex: "#2EC4B6")
}

Or update color assets in Assets.xcassets โ†’ Colors.

Default Instance URLโ€‹

Look for a Constants.swift or Config.swift file and update:

static let defaultBaseURL = "https://crm.yourcompany.com"

Push Notification Configurationโ€‹

Both apps need separate push notification credentials for each platform. See the Android and iOS developer guides for step-by-step instructions on setting up FCM (Android) and APNs (iOS).

After configuring push credentials, update your LeadHub server's environment configuration with the appropriate keys. Your system administrator handles this part.

Store Submission Checklistโ€‹

Before submitting to Google Play or the Apple App Store:

  • App name matches your product (not "LeadHub")
  • Package name / Bundle ID updated to your company's domain
  • App icon replaced with your branding (all required sizes)
  • Launch screen / splash screen updated
  • Colors match your brand
  • Default instance URL set (optional but recommended)
  • Push notification credentials configured
  • Privacy policy URL added (required by both stores)
  • App Store / Play Store screenshots prepared
  • Description written for your product