App Configuration Best Practices
Recommendations for administrators and coaches setting up the Intervengine App.
Branding
Logo
Your logo appears on device home screens and loading screens. Use a simple, high-contrast design in square format (512x512px SVG). Avoid text in the logo - it becomes illegible at small sizes.
Test your logo at 48x48 pixels. If it's still recognizable, it will work well as an app icon.
Colors
The app uses three brand colors:
- Primary - headers, footers, and major UI elements. Should have sufficient contrast with white text.
- Secondary - buttons and calls-to-action. Should stand out against Primary.
- Tertiary - links and secondary actions. A lighter or accent shade works well.
Avoid very light colors for Primary or Secondary - buttons and text may become illegible. Always test in the staging app before going to production.
Typography
Prioritize readability on mobile. Choose fonts that match your organization's branding and test on slower connections, as web fonts add load time.
Onboarding
Welcome Screens
The three welcome screens are your first impression:
- The Hook - State the primary benefit clearly, with compelling imagery and minimal text
- How It Works - Briefly explain features and set expectations
- Call to Action - Motivate participants to get started
Registration
Use Invitation Only for controlled programs (clinical trials, corporate wellness). Use Self Registration for open programs (public health, consumer apps).
Sign-In Methods
- SMS OTP - simplest for participants, no passwords to remember. Good for older adults or less tech-savvy users.
- Email/Password - traditional authentication. Better for international users (avoids SMS costs).
Both methods can be enabled simultaneously.
Feed
- Sort order - Use ascending (oldest first) for sequential programs. Use descending (newest first) when recent content is most relevant.
- Card dismissal - Enable when content is optional or you want to reduce perceived burden. Disable for research studies or when complete data collection is critical.
- External links - Enable the confirmation prompt so participants know they're leaving the app.
Journey Management
Controls whether participants can pause, resume, stop, or restart their own journeys.
Enable for self-directed wellness programs where participant autonomy matters. Disable for clinical or structured programs where coaches need oversight.
For most programs, enable journey management but encourage participants to "pause" rather than "stop". The flexibility increases satisfaction without significantly increasing dropouts.
Health Data (Sahha)
Only request the sensors you'll actually use - each permission prompt can cause drop-off. Data syncs on-demand when participants view their progress screens, not continuously.
Available scores: Activity, Sleep
Available sensors: Heart Rate, HRV, Blood Pressure, Glucose, Steps, Floors Climbed, Activity Summary, Sleep
Apple requires an explanation of why health data is collected. Be clear about the benefits to the participant and transparent about how data is used.
Example Configurations
Corporate Wellness - Invitation Only, both sign-in methods, journey management enabled, Sahha with steps/sleep/activity. Employees are invited but have flexibility in how they engage.
Clinical Research - Invitation Only, SMS sign-in, journey management disabled, card dismissal disabled, all relevant Sahha sensors. Maximizes researcher control and data completeness.
Public Health - Self Registration, both sign-in methods, journey management enabled, card dismissal enabled, minimal Sahha (steps only). Low barrier to entry with maximum participant autonomy.
Before Launch
- Test the full onboarding flow as a new participant
- Verify branding renders correctly on iOS and Android
- Walk through each app section and test edge cases
- Run a pilot with a small group (10–20 participants) and gather feedback
- Adjust configuration based on findings before full rollout