📋 Overview
This guide covers the deployment and configuration of the Birth Model iOS application for enterprise environments. Birth Model integrates with your existing MDM solution and supports Apple Business Manager for streamlined deployment.
iOS: Apple Business Manager + MDM (Intune, Jamf, Kandji, Workspace ONE, Mosyle)
Deployment Options
- Apple Business Manager: Volume purchase and automatic deployment via MDM
- Managed App Configuration: Customize branding and settings per hospital
- Shared Device Mode: Multi-user support for shared L&D workstations
🍎 Apple Business Manager
Deploy Birth Model through Apple Business Manager (ABM) for seamless enterprise distribution without requiring individual Apple IDs on each device.
Benefits
- Volume Purchase Program (VPP): Acquire app licenses centrally
- Automated Device Enrollment: Pre-configure devices before deployment
- Silent App Installation: Deploy automatically without user intervention
- License Management: Reassign licenses when devices are retired
Setup Steps
Sign in to Apple Business Manager
Navigate to business.apple.com with your organization's admin credentials.
Acquire Birth Model Licenses
Go to Apps and Books, search for "Birth Model", and acquire the required number of licenses for your organization.
Assign to MDM Server
Assign the licenses to your MDM server location. The app will sync automatically.
Configure in MDM
Create an app deployment policy in your MDM portal and apply managed app configuration (see below).
App must be installed via MDM (not direct App Store download) for managed app configuration to apply.
⚙️ iOS MDM App Configuration
Configure the Birth Model iOS app through Managed App Configuration keys in your MDM portal. This allows hospital-specific branding and customization.
Supported MDM Solutions
- Microsoft Intune
- Jamf Pro / Jamf Now
- Kandji
- VMware Workspace ONE
- Mosyle
- Any MDM supporting Apple Managed App Configuration
🔑 Configuration Keys
Home Screen — User Initials
| Key | Type | Description |
|---|---|---|
home_username_initial_background_color |
HEX | Background color for user initials avatar |
home_username_initial_text_color |
HEX | Text color for user initials |
Login Button
| Key | Type | Description |
|---|---|---|
login_button_background_color |
HEX | Login button background color |
login_button_text_color |
HEX | Login button text color |
login_button_text_title |
String | Login button label text (e.g., "Start New Shift") |
Full Screen Images
| Key | Type | Description |
|---|---|---|
login_full_screen_background_image |
URL | Login screen background image URL |
splash_full_screen_background_image |
URL | Splash screen background image URL |
📝 Sample Configuration
XML/plist format for iOS Managed App Configuration:
<dict> <key>home_username_initial_background_color</key> <string>#574497</string> <key>home_username_initial_text_color</key> <string>#FFFFFF</string> <key>login_button_background_color</key> <string>#574497</string> <key>login_button_text_color</key> <string>#FFFFFF</string> <key>login_button_text_title</key> <string>Start New Shift</string> <key>login_full_screen_background_image</key> <string>https://your-hospital.com/images/birth_model_bg.png</string> <key>splash_full_screen_background_image</key> <string>https://your-hospital.com/images/birth_model_splash.png</string> </dict>
Configuration changes apply after app relaunch. Users may need to force-quit and reopen the app to see updated branding.
🖼️ Image Requirements
Requirements for background images provided via URL:
| Specification | Value |
|---|---|
| Protocol | HTTPS required |
| Access | Publicly accessible (no authentication) |
| Minimum Size | 1242 x 2688 px (portrait) |
| Aspect Ratio | ~19.5:9 recommended |
| Rendering | Aspect Fill (edges may crop) |
| Format | PNG or JPG |
| Color Space | sRGB |
| Max File Size | 500 KB recommended |
Keep logos, text, and critical visuals within the center 80% of the image. Avoid placing important content near the notch, Dynamic Island, or home indicator areas.
🔧 Troubleshooting
| Issue | Resolution |
|---|---|
| App not appearing on device | Verify ABM sync with MDM; check device group assignment; ensure license is available |
| Configuration not applied | Ensure managed app config is linked to correct app version; force-quit and relaunch app |
| Background image not loading | Verify URL is HTTPS and publicly accessible; check image format and file size |
| Shared Device Mode not activating | Confirm Microsoft Authenticator is installed and configured first; verify device is supervised |
| License assignment failed | Check available license count in Apple Business Manager; verify MDM server token |
Need Help?
Contact Birth Model support for enterprise deployment guidance:
Email: support@birthmodel.com