Skip to main content

Configuration Reference

All configuration values are compile-time constants. Changing them requires a rebuild of the app.

App

ConfigTypeDefaultDescription
SHOW_FOREGROUND_NOTIFICATIONSbooltrueDisplay push notifications while the app is in the foreground.

Feed

ConfigTypeDefaultDescription
HOME_SCREEN_TEMPLATEenumV2Home screen layout. V1 includes an inline calendar, V2 is a scrollable feed with a separate history screen.
IS_MULTI_ORGboolfalseWhether the app supports multiple organisations.
SORT_HOME_MOST_RECENTbooltrueIf true, cards are sorted newest-first. If false, oldest-first.
SHOW_HOME_HEALTH_MEASURES_FIRSTbooltrueIf true, the Health Measures section appears at the top of the feed. If false, at the bottom.
SHOW_HOME_FOOTERbooltrueDisplay the "That's all for now!" message at the bottom of the feed.
DISPLAY_CUSTOM_HOME_TITLEboolfalseReplace the default "Home" title with a custom widget.
DISPLAY_CUSTOM_HOME_FOOTERboolfalseShow a custom footer widget below the feed content.
DISPLAY_TODO_ICONboolfalseDisplay the app icon in the feed header.
DISPLAY_TODO_DATEbooltrueShow the current date in the feed title (e.g. "Home (Thu Feb 12)").
HOME_HEALTH_SCORESlist[SAHHA]Which health score sections to show on the feed. Options: SAHHA, SYMPTOMS.

Activity Cards

ConfigTypeDefaultDescription
HIDE_SUBTITLE_IN_ACTIVITY_CARDbooltrueHide the type/schedule subtitle line (e.g. "Content - Morning - Goal Name") on activity cards.
USE_SUBJECTIVE_ACTION_ICONbooltrueIf true, Yes/No responses use distinct icons (check for Yes, X for No). If false, both use check.
FULL_WIDTH_ACTIVITY_CARDSboolfalseIf true, cards render edge-to-edge without side padding. If false, cards appear as floating cards.
SQUARE_BORDER_ACTIVITY_CARDSboolfalseIf true, cards have square corners. If false, cards have rounded corners.
FULL_WIDTH_CATEGORICAL_BUTTONSboolfalseIf true, categorical response buttons span the full card width.
USE_ROUNDED_BUTTONSbooltrueWhether buttons use rounded styling.
ALLOW_CARD_DISMISSbooltrueWhether users can swipe cards to dismiss them. Only applies to cards where isDismissible is enabled.

Progress

ConfigTypeDefaultDescription
PROGRESS_CHARTS_ORDERlist[HealthMeasure, Biomarker, ActivityPlan]Order of chart sections on the Progress screen. Options: HealthMeasure, Biomarker, ActivityPlan, OneOff.
PROGRESS_CHART_DATE_RANGESlist[ONE_WEEK, FOUR_WEEKS, THREE_MONTHS, SIX_MONTHS]Date range filter tabs. Options: ONE_WEEK, FOUR_WEEKS, THREE_MONTHS, SIX_MONTHS, ONE_YEAR.
SHOW_ONE_OFF_ACTION_CHARTSboolfalseWhether to include one-off activities in progress charts.
ONE_OFF_CHART_FILTERSlist[]Chart filters for one-off activity charts.

Authentication

ConfigTypeDefaultDescription
AUTH_STRATEGIESlist[PHONE, EMAIL]Which authentication methods are available. Order determines display priority.
ALLOW_SIGN_UPbooltrueWhether new user registration (self-registration) is available.
SHOW_SIGN_UP_OPTION_FIRSTboolfalseIf true, the sign-up form is shown by default instead of the login form.
INCLUDE_GENDER_IN_SIGN_UPbooltrueWhether to include a gender field in the sign-up form.
INCLUDE_DOB_IN_SIGN_UPbooltrueWhether to include a date of birth field in the sign-up form.
ENABLE_BIOMETRIC_LOCAL_AUTHboolfalseEnable biometric authentication (Face ID / fingerprint).
ALLOW_CONSENT_CANCELLATIONbooltrueWhether users can back out of the consent screen.

Onboarding and Alerts

ConfigTypeDefaultDescription
SHOW_INTRODUCTION_SCREENSbooltrueShow the onboarding/introduction flow on first launch.
SHOW_COMPLIANCE_POPUPboolfalseDisplay a compliance warning before opening external URLs.
SHOW_CUSTOM_APP_START_ALERTboolfalseShow a custom alert dialog on every app start.
SHOW_FIRST_APP_START_ALERTboolfalseShow a one-time alert on the very first app launch.

Sahha Integration

ConfigTypeDefaultDescription
ENABLE_SAHHA_INTEGRATIONbooltrueMaster toggle for Sahha SDK health data integration.
USE_SAHHA_UI_WIDGETSbooltrueUse Sahha's built-in UI widgets for displaying health data.
ENABLED_SAHHA_SENSORSlist12 sensorsWhich device sensors to request data from (heart rate, HRV, blood pressure, glucose, floors, activity, sleep, steps).
ENABLED_HEALTH_BIOMARKERSlist11 biomarkersWhich biomarker types to display in charts and summaries.
ENABLED_SAHHA_SCORESlist[activity, sleep]Which Sahha wellness scores to fetch and display.
ENABLED_SAHHA_INTEGRATIONSmap{GARMIN: false}Third-party device integrations. Currently only Garmin is supported.
INFERENCE_SCORE_CHART_TYPEenumLINEARScore display style. LINEAR (horizontal bar) or RADIAL (circular gauge).
SHOW_INFERENCE_IN_PROGRESSbooltrueIf true, inference scores appear on the Progress screen. If false, they appear on the Feed.