Custom Branded App (Agency)

Get your own fully branded YourGPT Chatbot mobile app for iOS and Android.

Launch your own custom-branded mobile app powered by YourGPT. Your brand, your identity — we handle the technical implementation.

This guide covers everything you need to provide to get your branded app live on the App Store and Google Play.


What You Get

  • Fully branded iOS and Android apps with your logo, colors, and identity
  • Published under your own App Store and Play Store accounts
  • Push notifications for real-time customer engagement
  • Google Sign-In with your own Firebase project
  • Deep linking with your custom URL scheme
  • All YourGPT Chatbot features with your branding

Requirements Overview

To set up your custom branded app, you'll need to provide:

  1. Brand Identity — App name, bundle ID, URL scheme
  2. Firebase Project — For push notifications and Google Sign-In
  3. Apple Developer Account — For iOS app distribution
  4. Android Signing Key — For Play Store distribution
  5. Image Assets — App icon, splash screen, logos
  6. Brand Colors — Your color palette
  7. App Content — Text strings and links
  8. App Store Listing — Screenshots and descriptions

1. Brand Identity

FieldFormatExample
Brand IDLowercase, no spacesacmesupport
App NameDisplay name on deviceAcme Support
Bundle IDReverse-domain formatcom.acme.support
URL SchemeFor deep links (lowercase)acmesupport
Associated DomainFor Universal Links (optional)app.acme.com

The Bundle ID must be unique and will be used for both iOS and Android.


2. Firebase Project

You need a Firebase project for push notifications and Google authentication.

2.1 Create Firebase Project

  1. Go to Firebase Console
  2. Create a new project (or use an existing one)
  3. Register two apps with your Bundle ID:
PlatformBundle IDDownload File
iOS<your-bundle-id>GoogleService-Info.plist
Android<your-bundle-id>google-services.json

2.2 Enable Firebase Services

  • Authentication → Sign-in method → Enable Google
  • Cloud Messaging → Enabled by default

2.3 Credentials to Provide

CredentialWhere to Find
Web Client IDFirebase Console → Authentication → Sign-in method → Google
iOS Reversed Client IDInside the downloaded GoogleService-Info.plist file

2.4 Files to Deliver

google-services.json       (Android)
GoogleService-Info.plist   (iOS)

Important

The BUNDLE_ID inside the iOS plist must exactly match your app's Bundle ID. A mismatch will break push notifications.


3. Apple Developer Account

Required for iOS App Store distribution.

3.1 Account Requirements

ItemWhere to Find
Apple Developer Accountdeveloper.apple.com — Requires enrollment ($99/year)
Team IDAccount → Membership

3.2 APNs Key for Push Notifications

  1. Go to Certificates, Identifiers & ProfilesKeys
  2. Create a new key with APNs capability
  3. Download the .p8 file (save it securely — you can only download once)
  4. Note the Key ID

3.3 Register Bundle IDs

Register these App IDs in Apple Developer Portal:

App IDBundle IDCapabilities
Main App<your-bundle-id>Push Notifications, App Groups
Notification Extension<your-bundle-id>.NotificationServiceExtensionApp Groups

3.4 Create App Group

  1. Go to IdentifiersApp Groups
  2. Register: group.<your-bundle-id>.shared
  3. Assign this App Group to both Bundle IDs above

3.5 Files to Deliver

APNs Auth Key (.p8 file)
Key ID
Team ID

4. Android Signing Key

Required for Google Play Store distribution.

4.1 Generate Keystore

Run this command to create your signing key:

keytool -genkeypair -v -storetype PKCS12 \
  -keystore your-app-release.keystore \
  -alias your-app-key \
  -keyalg RSA -keysize 2048 -validity 10000

4.2 Get SHA Fingerprints

keytool -list -v -keystore your-app-release.keystore

Copy the SHA-1 and SHA-256 fingerprints.

4.3 Add Fingerprints to Firebase

  1. Firebase Console → Project Settings → Your Android app
  2. Add both SHA-1 and SHA-256 fingerprints

4.4 Files to Deliver

ItemDescription
Keystore file.keystore or .jks file
Key aliasThe alias you used
Keystore passwordPassword for the keystore
Key passwordPassword for the key

Keep your keystore and passwords secure. If lost, you cannot update your app on the Play Store.


5. Image Assets

5.1 App Icon (Required)

FileSpecsNotes
app-icon.png1024x1024px, PNG, no transparencyUsed to generate all sizes

5.2 Splash Screen (Required)

FileSpecsNotes
splash-logo.pngPNG, transparent background, ~400px wideCentered on splash screen

5.3 In-App Logos (Required)

FileSpecsUsage
logo.pngPNG, any sizeApp header and UI
logo-white.pngPNG, white on transparentDark mode / dark backgrounds
bot-avatar.pngPNG, square (e.g., 200x200)AI assistant avatar

5.4 Android Adaptive Icon (Optional)

For Android's adaptive icon system:

FileSpecs
adaptive-fore.png1024x1024, PNG with transparency
adaptive-back.png1024x1024, PNG solid background

6. Brand Colors

Provide all colors in hex format (#RRGGBB):

ColorPurposeExample
PrimaryButtons, links, sent message bubbles#0066FF
Primary DarkStatus bar, pressed states#0052CC
Primary LightHover states, highlights#3385FF
Primary TintLight backgrounds, subtle highlights#E6F0FF
AI ColorAI assistant UI elements#8B5CF6
Splash BackgroundBoot splash screen background#0066FF

7. App Content

7.1 Onboarding Text

FieldExample
TitleWelcome to Acme Support
SubtitleAI-powered help, available 24/7
Get Started TextSign in with your Acme account
Info TextThis app is for Acme customers and partners.
FieldExample
Terms of Servicehttps://acme.com/terms
Privacy Policyhttps://acme.com/privacy
Contact/Supporthttps://acme.com/contact

8. App Store Listing

8.1 App Information

FieldPlatformNotes
App NameBothDisplay name on stores
Short DescriptionBothMax 80 characters
Full DescriptionBothDetailed app description
KeywordsiOSComma-separated
CategoryBothe.g., Business, Productivity
Contact EmailBothPublic contact email
Support URLBothLink to support page

8.2 Screenshots

TypeSizePlatform
iPhone 6.7" (required)1290 x 2796iOS
iPhone 6.5" (required)1242 x 2688iOS
Phone screenshots1080 x 1920+Android
Feature Graphic1024 x 500Android

We can help generate screenshots from your branded app if needed.


Delivery Checklist

Use this checklist to ensure you have everything ready:

Credentials & Config

  • Firebase google-services.json (Android)
  • Firebase GoogleService-Info.plist (iOS)
  • Google OAuth Web Client ID
  • iOS Reversed Client ID
  • Apple Developer Team ID
  • APNs Auth Key (.p8) + Key ID
  • Android keystore file + passwords
  • SHA fingerprints added to Firebase

Apple Developer Portal

  • Main Bundle ID registered with Push capability
  • Notification Extension Bundle ID registered
  • App Group created and assigned to both

Assets

  • App icon (1024x1024, no transparency)
  • Splash logo (PNG, transparent background)
  • Logo, white logo, bot avatar
  • 6 brand colors in hex format

Content

  • 4 onboarding text strings
  • 3 URLs (terms, privacy, contact)
  • App Store listing content
  • Screenshots for both platforms

Next Steps

Once you have all the requirements ready:

  1. Submit your assets — Send all files and information to the YourGPT team
  2. Review — We'll review and confirm everything is correct
  3. Build — We build and configure your branded app
  4. Test — You receive a test build for approval
  5. Publish — We submit to App Store and Play Store under your accounts

Questions?

Contact our team if you need help with any of the requirements above.

On this page