Set default of SystemUiMode to edge-to-edge

Edge-to-edge mode is Android's default display behavior as of Android version 15 and above. In Android 15, you could opt out of this behavior but, as of Android 16, you can't. To learn more about this change, check out the Android 16 release notes.

Using the mechanism to opt out of edge-to-edge on Android 16 or later might cause your app to crash, but you can avoid this by using version-specific resources; for details, visit the migration guide.

To learn how to structure your app to avoid this, we recommend that you visit the Leancode article, Mastering Edge-To-Edge in Flutter: A Deep Dive Into the System Navigation Bar in Android. You can also find more discussion in Issue 168635 on GitHub.

If your Flutter app targets Android SDK version 15, your app automatically displays in edge-to-edge mode, as documented on the SystemUiMode API page. To maintain non edge-to-edge app behavior (including an unset SystemUiMode), follow the steps in the migration guide.

By default, Android enforces edge-to-edge mode for all apps that target Android 15 or later. To learn more about this change, check out the Android 15 release notes. This impacts devices running on Android SDK 15+ or API 35+.

Prior to Flutter 3.27, Flutter apps targeted Android 14 by default and didn't opt into edge-to-edge mode automatically, but your app will be impacted when you choose to target Android 15. If your app targets flutter.targetSdkVersion (as it does by default), then it targets Android 15 starting with Flutter version 3.27, automatically opting your app in to edge-to-edge.

If your app explicitly sets SystemUiMode.edgeToEdge to run in edge-to-edge mode by calling SystemChrome.setEnabledSystemUIMode, then your app is already migrated. Apps needing more time to migrate to edge-to-edge mode must use the following steps to opt out on devices running Android SDK 15.

Be aware of the following:

1. Android plans for the workaround detailed here to be temporary.
2. Flutter plans to align with Android (and iOS) to support edge-to-edge by default within the year, so migrate to edge-to-edge mode before the operating system removes the ability to opt out.

To opt out of edge-to-edge on Android SDK 15, specify the new style attribute in each activity that requires it. If you have a parent style that child styles need to opt out of, you can modify the parent only. In the following example, update the style configuration generated from flutter create.

By default, the styles used in a Flutter app are set in the Android manifest file (your_app/android/app/src/main/AndroidManifest.xml). Generally, styles are denoted by @style and help theme your app. Modify these default styles in your manifest file:

<manifest xmlns:android="http://schemas.android.com/apk/res/android">
    <application ...>
        <activity ...>
            <!-- Style to modify: -->
            <meta-data
              android:name="io.flutter.embedding.android.NormalTheme"
              android:resource="@style/NormalTheme"
            />
        </activity>
    </application>
</manifest>

Locate the style definition in: your_app/android/app/src/main/res/values/styles.xml.

Add the following attribute to the appropriate styles:

<?xml version="1.0" encoding="utf-8"?>
<resources>
    <style name="LaunchTheme" parent="@android:style/Theme.Light.NoTitleBar">
        ...
        <!-- Add the following line: -->
        <item name="android:windowOptOutEdgeToEdgeEnforcement">true</item>
    </style>
    ...
    <style name="NormalTheme" parent="@android:style/Theme.Light.NoTitleBar">
        ...
	      <!-- Add the following line: -->
        <item name="android:windowOptOutEdgeToEdgeEnforcement">true</item>
    </style>
</resources>

Make sure to apply the same change in the night mode styles file as well: your_app/android/app/src/main/res/values-night/styles.xml.

Ensure both styles are updated consistently in both files.

This modified style opts your app out of edge-to-edge for apps targeting Android SDK 15.

Starting in Flutter 3.27, Flutter apps target Android 15 by default, so if you wish to use this version and not manually set a lower target SDK version for your Flutter app, follow the preceding migration steps to maintain an unset or non-edge-to-edge SystemUiMode.

Landed in version: 3.26.0-0.0.pre
Stable release: 3.27

• The supported Flutter SystemUiModes
• The Android 15 edge-to-edge behavior changes guide
• The Android 16 edge-to-edge behavior changes guide