Skip to content

Android/iOS App Settings Documentation

Menu Location: Settings > Android/iOS App Settings

Access Level: Administrator and above

Last Updated: 2026-03-01

Overview

The Android/iOS App Settings page configures your mobile app functionality, appearance, and integration with your subscription service. Control app features, branding, push notifications, and customer-facing app behavior.

Primary Functions:

  • Configure app branding and colors
  • Enable/disable app features
  • Set up push notification credentials
  • Control customer app experience
  • Manage app version requirements
  • Configure deep linking and app behavior

Page Layout

Header Section

  • Page Title: Mobile App Configuration
  • Save Button: Apply all changes
  • Preview Button: Test app settings

Configuration Sections

  • Branding: Colors, logos, app name
  • Features: Enable/disable app functionality
  • Push Notifications: Notification configuration
  • Security: App security settings
  • Behavior: App behavior and defaults

Branding Configuration

App Appearance

App Name:

  • Display name shown on device home screen
  • Keep under 12 characters for best display
  • Example: "FarmBox" or "Fresh Delivery"

Primary Color:

  • Main brand color in hex format
  • Example: #3498db for blue
  • Used for headers, buttons, primary elements

Secondary Color:

  • Accent color in hex format
  • Used for highlights, links, secondary buttons

Logo Image:

  • Upload square logo (512x512px minimum)
  • PNG format with transparent background
  • Used as app icon and splash screen

Splash Screen:

  • Image shown when app launches
  • Recommended size: 2048x2048px
  • PNG or JPG format
  • Displays while app loads

Feature Configuration

Customer Features

Enable/Disable Controls:

Account Management:

  • [ ] Allow password changes
  • [ ] Enable profile editing
  • [ ] Show delivery preferences
  • [ ] Display payment methods

Shopping Features:

  • [ ] Enable in-app shopping
  • [ ] Show product catalog
  • [ ] Allow add-ons
  • [ ] Enable one-time orders

Communication:

  • [ ] Push notifications
  • [ ] In-app messaging
  • [ ] Customer support chat
  • [ ] Email preferences

Delivery Tracking:

  • [ ] Show delivery status
  • [ ] Display driver location (if available)
  • [ ] Send delivery notifications
  • [ ] Show delivery history

Push Notification Settings

iOS Push Configuration

Requirements:

  • Apple Developer account
  • Push notification certificate (.p12 file)
  • App ID with push enabled

Configuration:

  1. Upload iOS push certificate
  2. Enter certificate password
  3. Select environment (Production/Sandbox)
  4. Test notification
  5. Save settings

Certificate Renewal:

  • Certificates expire annually
  • Upload new certificate before expiration
  • No app update required
  • Test after renewal

Android Push Configuration

Requirements:

  • Firebase project
  • Server key
  • Sender ID

Configuration:

  1. Enter Firebase Server Key
  2. Enter Sender ID
  3. Select notification icon
  4. Test notification
  5. Save settings

Firebase Setup:

  • Create Firebase project
  • Add Android app to project
  • Download google-services.json
  • Get Server Key from Cloud Messaging
  • Get Sender ID from project settings

Security Settings

App Security

Require App Updates:

  • Set minimum required app version
  • Force users to update before using
  • Example: "1.5.0" or higher

Session Management:

  • Set session timeout (minutes)
  • Require login frequency
  • Enable biometric authentication

Data Security:

  • Enable SSL certificate pinning
  • Require secure connections only
  • Enable encrypted local storage

App Behavior Settings

Default Settings

Home Screen:

  • Default landing page (Dashboard/Orders/Shop)
  • Show quick actions
  • Display notifications badge

Navigation:

  • Enable bottom navigation bar
  • Show sidebar menu
  • Set default menu items

Order Behavior:

  • Auto-select last delivery date
  • Remember product preferences
  • Enable quick reorder

Notifications:

  • Enable sound
  • Enable vibration
  • Set default notification channel

Common Use Cases

Use Case 1: Initial App Setup

Goal: Configure app for first launch

Steps:

  1. Go to Android/iOS App Settings
  2. Enter App Name
  3. Upload logo (512x512px)
  4. Set Primary Color (brand color)
  5. Set Secondary Color (accent)
  6. Upload splash screen image
  7. Enable essential features:
    • Account Management
    • Shopping Features
    • Delivery Tracking
  8. Configure push notifications (both platforms)
  9. Test notification
  10. Click "Save Settings"
  11. Build app with new settings

Use Case 2: Update App Branding

Goal: Rebrand app with new logo and colors

Steps:

  1. Prepare new assets:
    • New logo (512x512px PNG)
    • New splash screen
    • New color scheme
  2. Go to App Settings page
  3. Upload new logo
  4. Update Primary Color hex code
  5. Update Secondary Color hex code
  6. Upload new splash screen
  7. Click "Preview" to see changes
  8. Click "Save Settings"
  9. Notify customers of update
  10. Submit updated app to stores

Use Case 3: Enable New Feature

Goal: Turn on in-app shopping feature

Steps:

  1. Go to App Settings
  2. Scroll to Shopping Features section
  3. Check [ ] Enable in-app shopping
  4. Check [ ] Show product catalog
  5. Check [ ] Allow add-ons
  6. Optionally enable one-time orders
  7. Click "Save Settings"
  8. Test in app to verify
  9. Announce feature to customers

Use Case 4: Renew Push Certificate (iOS)

Goal: Update expiring iOS push certificate

Steps:

  1. Log into Apple Developer
  2. Generate new push certificate (.p12)
  3. Download certificate and note password
  4. Go to App Settings page
  5. Scroll to iOS Push Configuration
  6. Click "Upload New Certificate"
  7. Select new .p12 file
  8. Enter certificate password
  9. Keep "Production" environment selected
  10. Click "Test Notification"
  11. Verify test notification received
  12. Click "Save Settings"
  13. Monitor for delivery issues

Use Case 5: Force App Update

Goal: Require users to update to fix critical bug

Steps:

  1. Release new app version to stores (e.g., 1.6.0)
  2. Wait until available in stores
  3. Go to App Settings
  4. Find "Require App Updates" setting
  5. Enter minimum version: "1.6.0"
  6. Click "Save Settings"
  7. Users with older versions will be prompted to update
  8. Monitor customer support for update issues

Troubleshooting

Push Notifications Not Working

Symptoms:

  • Customers not receiving push notifications
  • Test notifications fail
  • Errors in push logs

iOS Troubleshooting:

  1. Verify certificate not expired
  2. Check certificate environment (Production vs. Sandbox)
  3. Confirm certificate password correct
  4. Test with different device
  5. Check if notifications enabled in device settings
  6. Verify App ID has push enabled

Android Troubleshooting:

  1. Verify Firebase Server Key
  2. Confirm Sender ID correct
  3. Check Firebase project status
  4. Test with different device
  5. Verify app has notification permission
  6. Check Firebase Cloud Messaging quota

App Not Showing New Branding

Symptoms:

  • Updated logo not appearing
  • Colors still show old brand
  • Changes not visible in app

Solutions:

  1. Verify you clicked "Save Settings"
  2. Rebuild app with new settings
  3. Publish updated app to stores
  4. Users must update app to see changes
  5. Force users to update using version requirement
  6. Clear app cache/data and relaunch

Certificate Upload Fails

Symptoms:

  • Cannot upload .p12 certificate
  • Error message appears
  • Upload button doesn't work

Check:

  1. Verify file is .p12 format (not .p8 or .pem)
  2. Confirm file size under limit (usually 10MB)
  3. Check password is correct
  4. Ensure certificate created for correct App ID
  5. Try exporting certificate again from Keychain
  6. Use different browser

App Crashes After Settings Change

Symptoms:

  • App crashes on launch
  • Errors when opening specific features
  • App won't load

Investigation:

  1. Check which setting was changed
  2. Review error logs in app analytics
  3. Revert recent changes
  4. Test each setting individually
  5. Verify all required fields filled
  6. Check for invalid color codes or URLs

Quick Fix:

  1. Revert to previous working configuration
  2. Click "Save Settings"
  3. Test app
  4. Re-apply changes one at a time
  • Push Notifications - Send push notifications to customers
  • Customer Detail - View customer app usage
  • Email Settings - Configure email communications
  • Settings - Other system settings

Permissions & Access

Required Access Level: Administrator or higher

Access Level Capabilities:

  • Administrator: Modify all app settings, upload certificates
  • Kiva Admin: All features + advanced configuration

Restricted Features:

  • Only Administrators can modify security settings
  • Certificate uploads require Administrator access

Best Practices

Branding

  1. Use high-quality logo images (at least 512x512px)
  2. Choose accessible color combinations (contrast)
  3. Test colors on both light and dark mode
  4. Keep app name short and memorable
  5. Update branding consistently across all platforms

Feature Management

  1. Enable features gradually, not all at once
  2. Test each feature before enabling
  3. Announce new features to customers
  4. Provide documentation for new features
  5. Monitor usage after enabling

Push Notifications

  1. Renew certificates before expiration
  2. Test notifications after any configuration change
  3. Keep Firebase project active and monitored
  4. Don't spam users with too many notifications
  5. Respect user notification preferences

Security

  1. Require recent app versions for security updates
  2. Use SSL certificate pinning
  3. Set reasonable session timeouts (30-60 minutes)
  4. Enable biometric authentication where possible
  5. Keep push certificates secure

Updates

  • Plan app updates during low-traffic periods
  • Test thoroughly before requiring updates
  • Give users time to update before forcing
  • Communicate update benefits to customers
  • Monitor support requests after updates

Quick Reference Card

Task Action/Location
Upload new logo Branding section > Upload logo image
Change app colors Branding section > Primary/Secondary color
Enable feature Features section > Check feature box
Upload iOS certificate iOS Push > Upload certificate
Configure Android push Android Push > Enter Server Key and Sender ID
Force app update Security > Set minimum version
Test push notification Push section > "Test Notification" button
Preview changes Click "Preview" button (before saving)
Save all changes Click "Save Settings" button

FAQs

Do customers need to update the app to see new settings?

For branding changes (logo, colors), yes - customers must update to the latest app version. For feature toggles and behavior settings, changes take effect immediately without app update.

How often should I renew push certificates?

iOS certificates expire annually. Set a reminder to renew 2-4 weeks before expiration to avoid notification outages.

Can I test app changes before making them live?

Use the "Preview" button to see visual changes. For features, test in a development/staging environment before enabling in production.

What happens if I set the minimum version too high?

Users with older versions won't be able to use the app until they update. Set minimum version carefully and only when necessary (security fixes, critical bugs).

Why aren't my color changes showing?

Colors are bundled into the app itself. After changing colors, you must rebuild the app and submit updates to app stores. Users see changes after updating.

Can I have different settings for iOS and Android?

Most settings apply to both platforms. Push notification configuration is separate for each platform due to different requirements (Apple vs. Firebase).

End of Documentation

For additional help, contact your system administrator or Kiva Logic support.