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:
- Brand Identity — App name, bundle ID, URL scheme
- Firebase Project — For push notifications and Google Sign-In
- Apple Developer Account — For iOS app distribution
- Android Signing Key — For Play Store distribution
- Image Assets — App icon, splash screen, logos
- Brand Colors — Your color palette
- App Content — Text strings and links
- App Store Listing — Screenshots and descriptions
1. Brand Identity
| Field | Format | Example |
|---|---|---|
| Brand ID | Lowercase, no spaces | acmesupport |
| App Name | Display name on device | Acme Support |
| Bundle ID | Reverse-domain format | com.acme.support |
| URL Scheme | For deep links (lowercase) | acmesupport |
| Associated Domain | For 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
- Go to Firebase Console
- Create a new project (or use an existing one)
- Register two apps with your Bundle ID:
| Platform | Bundle ID | Download 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
| Credential | Where to Find |
|---|---|
| Web Client ID | Firebase Console → Authentication → Sign-in method → Google |
| iOS Reversed Client ID | Inside 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
| Item | Where to Find |
|---|---|
| Apple Developer Account | developer.apple.com — Requires enrollment ($99/year) |
| Team ID | Account → Membership |
3.2 APNs Key for Push Notifications
- Go to Certificates, Identifiers & Profiles → Keys
- Create a new key with APNs capability
- Download the
.p8file (save it securely — you can only download once) - Note the Key ID
3.3 Register Bundle IDs
Register these App IDs in Apple Developer Portal:
| App ID | Bundle ID | Capabilities |
|---|---|---|
| Main App | <your-bundle-id> | Push Notifications, App Groups |
| Notification Extension | <your-bundle-id>.NotificationServiceExtension | App Groups |
3.4 Create App Group
- Go to Identifiers → App Groups
- Register:
group.<your-bundle-id>.shared - Assign this App Group to both Bundle IDs above
3.5 Files to Deliver
APNs Auth Key (.p8 file)
Key ID
Team ID4. 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 100004.2 Get SHA Fingerprints
keytool -list -v -keystore your-app-release.keystoreCopy the SHA-1 and SHA-256 fingerprints.
4.3 Add Fingerprints to Firebase
- Firebase Console → Project Settings → Your Android app
- Add both SHA-1 and SHA-256 fingerprints
4.4 Files to Deliver
| Item | Description |
|---|---|
| Keystore file | .keystore or .jks file |
| Key alias | The alias you used |
| Keystore password | Password for the keystore |
| Key password | Password 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)
| File | Specs | Notes |
|---|---|---|
app-icon.png | 1024x1024px, PNG, no transparency | Used to generate all sizes |
5.2 Splash Screen (Required)
| File | Specs | Notes |
|---|---|---|
splash-logo.png | PNG, transparent background, ~400px wide | Centered on splash screen |
5.3 In-App Logos (Required)
| File | Specs | Usage |
|---|---|---|
logo.png | PNG, any size | App header and UI |
logo-white.png | PNG, white on transparent | Dark mode / dark backgrounds |
bot-avatar.png | PNG, square (e.g., 200x200) | AI assistant avatar |
5.4 Android Adaptive Icon (Optional)
For Android's adaptive icon system:
| File | Specs |
|---|---|
adaptive-fore.png | 1024x1024, PNG with transparency |
adaptive-back.png | 1024x1024, PNG solid background |
6. Brand Colors
Provide all colors in hex format (#RRGGBB):
| Color | Purpose | Example |
|---|---|---|
| Primary | Buttons, links, sent message bubbles | #0066FF |
| Primary Dark | Status bar, pressed states | #0052CC |
| Primary Light | Hover states, highlights | #3385FF |
| Primary Tint | Light backgrounds, subtle highlights | #E6F0FF |
| AI Color | AI assistant UI elements | #8B5CF6 |
| Splash Background | Boot splash screen background | #0066FF |
7. App Content
7.1 Onboarding Text
| Field | Example |
|---|---|
| Title | Welcome to Acme Support |
| Subtitle | AI-powered help, available 24/7 |
| Get Started Text | Sign in with your Acme account |
| Info Text | This app is for Acme customers and partners. |
7.2 Links
| Field | Example |
|---|---|
| Terms of Service | https://acme.com/terms |
| Privacy Policy | https://acme.com/privacy |
| Contact/Support | https://acme.com/contact |
8. App Store Listing
8.1 App Information
| Field | Platform | Notes |
|---|---|---|
| App Name | Both | Display name on stores |
| Short Description | Both | Max 80 characters |
| Full Description | Both | Detailed app description |
| Keywords | iOS | Comma-separated |
| Category | Both | e.g., Business, Productivity |
| Contact Email | Both | Public contact email |
| Support URL | Both | Link to support page |
8.2 Screenshots
| Type | Size | Platform |
|---|---|---|
| iPhone 6.7" (required) | 1290 x 2796 | iOS |
| iPhone 6.5" (required) | 1242 x 2688 | iOS |
| Phone screenshots | 1080 x 1920+ | Android |
| Feature Graphic | 1024 x 500 | Android |
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:
- Submit your assets — Send all files and information to the YourGPT team
- Review — We'll review and confirm everything is correct
- Build — We build and configure your branded app
- Test — You receive a test build for approval
- 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.