enableEdgeToEdge() is now the decision hook — override it to control when edge-to-edge activates

activateEdgeToEdge() is the action method — it does both EdgeToEdge.enable(this) and SystemUiUtils.activateEdgeToEdge(), so it's impossible to enable Android edge-to-edge without also setting RNN's internal flag
The docs now show activateEdgeToEdge() in the override example instead of EdgeToEdge.enable(this)

Author: markdevocht

android/src/main/java/com/reactnativenavigation/NavigationActivity.java

@@ -154,9 +154,11 @@ public void onReload() {
     }
 
     /**
-     * Enables edge-to-edge display only if the app theme sets
+     * Controls when edge-to-edge is enabled. Override to customize the decision logic.
+     * Call {@link #activateEdgeToEdge()} from your override to enable edge-to-edge.
+     * <p>
+     * The default implementation enables edge-to-edge only if the app theme sets
      * {@code windowOptOutEdgeToEdgeEnforcement} to {@code false} (API 35+).
-     * By default, edge-to-edge is not enabled. Override to customize.
      * Called at the start of onCreate, before super.onCreate.
      */
     protected void enableEdgeToEdge() {
@@ -166,12 +168,21 @@ protected void enableEdgeToEdge() {
             boolean optOut = a.getBoolean(0, true);
             a.recycle();
             if (!optOut) {
-                EdgeToEdge.enable(this);
-                SystemUiUtils.activateEdgeToEdge();
+                activateEdgeToEdge();
             }
         }
     }
 
+    /**
+     * Enables edge-to-edge display and notifies the navigation framework.
+     * Call this from {@link #enableEdgeToEdge()} overrides instead of
+     * calling {@code EdgeToEdge.enable()} directly.
+     */
+    protected void activateEdgeToEdge() {
+        EdgeToEdge.enable(this);
+        SystemUiUtils.activateEdgeToEdge();
+    }
+
     protected void addDefaultSplashLayout() {
         View view = new View(this);
         setContentView(view);

website/docs/docs/style-edge-to-edge.mdx

@@ -34,17 +34,19 @@ When edge-to-edge is not active (the default), behavior is unchanged from previo
 
 ## Custom behavior
 
-`NavigationActivity.enableEdgeToEdge()` is a `protected` method. Override it in your `MainActivity` to customize when and how edge-to-edge is enabled:
+`NavigationActivity.enableEdgeToEdge()` is a `protected` method that controls when edge-to-edge is enabled. Override it in your `MainActivity` to customize the decision logic, and call `activateEdgeToEdge()` to enable it:
 
 ```kotlin
 class MainActivity : NavigationActivity() {
     override fun enableEdgeToEdge() {
-        // Always enable edge-to-edge regardless of theme
-        EdgeToEdge.enable(this)
+        // Always enable edge-to-edge regardless of theme or API level
+        activateEdgeToEdge()
     }
 }
 ```
 
+`activateEdgeToEdge()` handles both the Android system call and the internal navigation framework state. Always use it instead of calling `EdgeToEdge.enable()` directly.
+
 ## Styling system bars
 
 Status bar and navigation bar colors can still be controlled per-screen via options: