modern-android

Official source: https://developer.android.com/develop

You are an expert in modern Android platform features. Follow current platform requirements for edge-to-edge display, predictive back, Material 3, and lifecycle management.

Edge-to-Edge Display

Source: https://developer.android.com/develop/ui/views/layout/edge-to-edge

DO:

• Enable edge-to-edge display (mandatory for apps targeting Android 15+):

class MainActivity : ComponentActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        enableEdgeToEdge()
        super.onCreate(savedInstanceState)
        setContent { ... }
    }
}

• Handle window insets in Compose:

Scaffold(
    modifier = Modifier.fillMaxSize(),
    contentWindowInsets = WindowInsets(0),
) { innerPadding ->
    Content(modifier = Modifier.padding(innerPadding))
}

• Use Modifier.windowInsetsPadding() for manual inset handling:

Modifier
    .statusBarsPadding()
    .navigationBarsPadding()
    .imePadding()

DON'T:

• Use fitsSystemWindows="true" in Compose — handle insets with Compose APIs
• Assume a fixed status bar or navigation bar height
• Ignore insets — content will render behind system bars

Predictive Back Gesture

Source: https://developer.android.com/guide/navigation/custom-back/predictive-back-gesture

DO:

• Opt in to predictive back in the manifest:

<application android:enableOnBackInvokedCallback="true">

• Use the Navigation component's built-in back handling
• For custom back behavior, use BackHandler in Compose:

BackHandler(enabled = showBottomSheet) {
    showBottomSheet = false
}

DON'T:

• Override onBackPressed() — it's deprecated
• Use OnBackPressedDispatcher directly — use Compose's BackHandler
• Block the back gesture without clear user value

Splash Screen API

Source: https://developer.android.com/develop/ui/views/launch/splash-screen

DO:

• Use the Splash Screen API from androidx.core:core-splashscreen:

class MainActivity : ComponentActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        val splashScreen = installSplashScreen()
        super.onCreate(savedInstanceState)

        // Keep splash while loading initial data
        splashScreen.setKeepOnScreenCondition {
            viewModel.isLoading.value
        }
    }
}

• Define splash theme in res/values/themes.xml:

<style name="Theme.App.Splash" parent="Theme.SplashScreen">
    <item name="windowSplashScreenBackground">@color/splash_bg</item>
    <item name="windowSplashScreenAnimatedIcon">@drawable/splash_icon</item>
    <item name="postSplashScreenTheme">@style/Theme.App</item>
</style>