app-start-readiness-policy

name	App Start Readiness Policy
description	Guidelines for coordinating splash screen dismissal with background data readiness

App Start Readiness Policy

To prevent "Welcome" state flashes and UI jumps, the app must remain on the splash screen until the initial data payload is fully synchronized and processed.

1. Splash Screen Condition

Use the AndroidX SplashScreen API to hold the screen:

splashScreen.setKeepOnScreenCondition { 
    !isAuthSuccessful || !isDataLoaded 
}

2. Readiness Flags

• isAuthSuccessful: Set after Biometric or Firebase Auth succeeds.
• isDataLoaded: Set ONLY after the first valid data snapshot is processed (e.g., calculateHeroData finishes).

3. Safety Timeout (Failsafe)

Always implement a 5-second postDelayed fallback in initializeApp to ensure the app never hangs indefinitely due to network or Firestore latency:

mainNestedScrollView.postDelayed({
    if (!isDataLoaded) {
        isDataLoaded = true
    }
}, 5000)

4. Initialization Order (CRITICAL)

NEVER call background tasks or safety timeouts before your views are fully initialized. This prevents UninitializedPropertyAccessException.

1. setContentView
2. findViewById (All)
3. auth/viewModel Init
4. safetyTimeout (Last)