Add edge-to-edge to WebView, onboarding and misc activity groups

Roll out Android 15 edge-to-edge handling to three screen groups, each
gated behind a new sub-toggle of the existing `edgeToEdge` remote feature
(default INTERNAL) so the rollout is remotely controllable per group:

- webview: WebView, SettingsWebView, Subscriptions/Pir dashboards,
  EmailProtection in-context signup, GPM/Takeout import flows,
  PrivacyDashboard, Survey
- onboarding: SystemSearch, WidgetThemeConfiguration, AddWidgetInstructions
- misc: About, ChangeIcon, Bookmarks, BookmarkFolders, Downloads,
  GetDesktopBrowser, Windows, MacOs, Feedback, SubscriptionFeedback,
  RestoreSubscription, ChangePlan, Pir, EmailProtectionUnsupported

Each activity enables a transparent edge-to-edge window when its bucket is
enabled and applies status-bar / navigation-bar / display-cutout / IME
insets via EdgeToEdgeHandler. Adds a Theme.DuckDuckGo.SplashScreen.EdgeToEdge
theme (with a values-land override that reserves the display cutout as a
letterbox in landscape) for splash-themed screens, plus the common-utils
MISC bucket, misc() toggle, provider wiring and unit tests.

Author: aibrahim-

android-design-system/design-system/src/main/res/values-land/design-system-theming.xml

@@ -0,0 +1,28 @@
+<?xml version="1.0" encoding="utf-8"?><!--
+  ~ Copyright (c) 2026 DuckDuckGo
+  ~
+  ~ Licensed under the Apache License, Version 2.0 (the "License");
+  ~ you may not use this file except in compliance with the License.
+  ~ You may obtain a copy of the License at
+  ~
+  ~     http://www.apache.org/licenses/LICENSE-2.0
+  ~
+  ~ Unless required by applicable law or agreed to in writing, software
+  ~ distributed under the License is distributed on an "AS IS" BASIS,
+  ~ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  ~ See the License for the specific language governing permissions and
+  ~ limitations under the License.
+  -->
+
+<resources>
+
+    <!--
+      Landscape override: reserve the display cutout as a dark letterbox for edge-to-edge splash-themed
+      screens. The base splash theme (AndroidX Theme.SplashScreen) forces "shortEdges", which persists
+      over the runtime cutout handling, so we set "never" declaratively here where there is no timing race.
+    -->
+    <style name="Theme.DuckDuckGo.SplashScreen.EdgeToEdge" parent="Theme.DuckDuckGo.SplashScreen">
+        <item name="android:windowLayoutInDisplayCutoutMode">never</item>
+    </style>
+
+</resources>

android-design-system/design-system/src/main/res/values/design-system-theming.xml

@@ -477,6 +477,15 @@
         <item name="postSplashScreenTheme">@style/Theme.DuckDuckGo.Light</item>
     </style>
 
+    <!--
+      Splash-screen theme variant for edge-to-edge screens (e.g. SystemSearchActivity,
+      WidgetThemeConfiguration). Portrait keeps the splash defaults; the values-land override sets
+      layoutInDisplayCutoutMode to "never" so in landscape the cutout renders as a dark letterbox
+      instead of the window background bleeding into it (the base splash theme forces "shortEdges",
+      which otherwise overrides the runtime cutout handling).
+    -->
+    <style name="Theme.DuckDuckGo.SplashScreen.EdgeToEdge" parent="Theme.DuckDuckGo.SplashScreen" />
+
     <style name="Theme.DuckDuckGo.Splash" parent="Theme.SplashScreen">
         <item name="windowSplashScreenAnimatedIcon">@drawable/ic_dax_splash_screen_icon</item>
     </style>

app/src/main/AndroidManifest.xml

@@ -229,7 +229,7 @@
             android:exported="true"
             android:label="@string/appName"
             android:roundIcon="${appIconRound}"
-            android:theme="@style/Theme.DuckDuckGo.SplashScreen"
+            android:theme="@style/Theme.DuckDuckGo.SplashScreen.EdgeToEdge"
             android:launchMode="singleTask"
             android:stateNotNeeded="true">
 
@@ -490,7 +490,7 @@
             android:exported="false"
             android:label="@string/widgetConfigurationActivityTitle"
             android:roundIcon="${appIconRound}"
-            android:theme="@style/Theme.DuckDuckGo.SplashScreen">
+            android:theme="@style/Theme.DuckDuckGo.SplashScreen.EdgeToEdge">
             <intent-filter>
                 <action android:name="android.appwidget.action.APPWIDGET_CONFIGURE" />
             </intent-filter>

app/src/main/java/com/duckduckgo/app/WidgetThemeConfiguration.kt

@@ -30,6 +30,9 @@ import com.duckduckgo.app.pixels.AppPixelName
 import com.duckduckgo.app.statistics.pixels.Pixel
 import com.duckduckgo.appbuildconfig.api.AppBuildConfig
 import com.duckduckgo.common.ui.DuckDuckGoActivity
+import com.duckduckgo.common.utils.edgetoedge.EdgeToEdgeBucket
+import com.duckduckgo.common.utils.edgetoedge.EdgeToEdgeHandler
+import com.duckduckgo.common.utils.edgetoedge.EdgeToEdgeProvider
 import com.duckduckgo.di.scopes.ActivityScope
 import com.duckduckgo.widget.SearchAndFavoritesWidget
 import com.duckduckgo.widget.WidgetPreferences
@@ -48,13 +51,29 @@ class WidgetThemeConfiguration : DuckDuckGoActivity() {
     @Inject
     lateinit var appBuildConfig: AppBuildConfig
 
+    @Inject
+    lateinit var edgeToEdgeProvider: EdgeToEdgeProvider
+
+    @Inject
+    lateinit var edgeToEdgeHandler: EdgeToEdgeHandler
+
     private var appWidgetId = AppWidgetManager.INVALID_APPWIDGET_ID
 
     @Suppress("NewApi") // we use appBuildConfig
     override fun onCreate(savedInstanceState: Bundle?) {
         super.onCreate(savedInstanceState)
         val binding = ActivityWidgetConfigurationBinding.inflate(layoutInflater)
+        val edgeToEdgeEnabled = edgeToEdgeProvider.isEnabled(EdgeToEdgeBucket.ONBOARDING)
+        if (edgeToEdgeEnabled) {
+            enableTransparentEdgeToEdge()
+        }
         setContentView(binding.root)
+        if (edgeToEdgeEnabled) {
+            // Panel is top-anchored under this opaque theme, so status + sides go on the root; the nav-bar
+            // pad on the panel keeps the Add button clear if the panel is ever bottom-aligned.
+            edgeToEdgeHandler.applyStatusBarAndHorizontalInsets(binding.root)
+            edgeToEdgeHandler.applyNavigationBarInsets(binding.widgetConfigPanel, drawBehindGestureNav = false)
+        }
         val extras = intent.extras
         extras?.let {
             appWidgetId = it.getInt(AppWidgetManager.EXTRA_APPWIDGET_ID, appWidgetId)

app/src/main/java/com/duckduckgo/app/about/AboutDuckDuckGoActivity.kt

@@ -49,6 +49,9 @@ import com.duckduckgo.common.ui.DuckDuckGoActivity
 import com.duckduckgo.common.ui.view.getColorFromAttr
 import com.duckduckgo.common.ui.viewbinding.viewBinding
 import com.duckduckgo.common.utils.AppUrl.Url
+import com.duckduckgo.common.utils.edgetoedge.EdgeToEdgeBucket
+import com.duckduckgo.common.utils.edgetoedge.EdgeToEdgeHandler
+import com.duckduckgo.common.utils.edgetoedge.EdgeToEdgeProvider
 import com.duckduckgo.di.scopes.ActivityScope
 import com.duckduckgo.mobile.android.R.attr
 import com.duckduckgo.navigation.api.GlobalActivityStarter
@@ -78,18 +81,39 @@ class AboutDuckDuckGoActivity : DuckDuckGoActivity() {
     @Inject
     lateinit var globalActivityStarter: GlobalActivityStarter
 
+    @Inject
+    lateinit var edgeToEdgeProvider: EdgeToEdgeProvider
+
+    @Inject
+    lateinit var edgeToEdgeHandler: EdgeToEdgeHandler
+
     override fun onCreate(savedInstanceState: Bundle?) {
         super.onCreate(savedInstanceState)
 
+        val edgeToEdgeEnabled = edgeToEdgeProvider.isEnabled(EdgeToEdgeBucket.MISC)
+        if (edgeToEdgeEnabled) {
+            enableTransparentEdgeToEdge()
+        }
+
         setContentView(binding.root)
         setupToolbar(binding.includeToolbar.toolbar)
         supportActionBar?.setTitle(R.string.aboutActivityTitleNew)
 
+        if (edgeToEdgeEnabled) {
+            configureEdgeToEdgeInsets()
+        }
+
         configureUiEventHandlers()
         observeViewModel()
         configureClickableLinks()
     }
 
+    private fun configureEdgeToEdgeInsets() {
+        edgeToEdgeHandler.applyHorizontalSystemBarInsets(binding.root)
+        edgeToEdgeHandler.applyStatusBarInsets(binding.includeToolbar.appBarLayout)
+        edgeToEdgeHandler.applyNavigationBarInsets(binding.includeContent.longDescriptionContainer, drawBehindGestureNav = true)
+    }
+
     override fun onResume() {
         super.onResume()
         viewModel.resetEasterEggCounter()

app/src/main/java/com/duckduckgo/app/browser/webview/WebViewActivity.kt

@@ -33,6 +33,9 @@ import com.duckduckgo.app.statistics.pixels.Pixel
 import com.duckduckgo.browser.api.ui.BrowserScreens.WebViewActivityWithParams
 import com.duckduckgo.common.ui.DuckDuckGoActivity
 import com.duckduckgo.common.ui.viewbinding.viewBinding
+import com.duckduckgo.common.utils.edgetoedge.EdgeToEdgeBucket
+import com.duckduckgo.common.utils.edgetoedge.EdgeToEdgeHandler
+import com.duckduckgo.common.utils.edgetoedge.EdgeToEdgeProvider
 import com.duckduckgo.di.scopes.ActivityScope
 import com.duckduckgo.navigation.api.getActivityParams
 import com.duckduckgo.user.agent.api.UserAgentProvider
@@ -51,6 +54,12 @@ class WebViewActivity : DuckDuckGoActivity() {
     @Inject
     lateinit var pixel: Pixel
 
+    @Inject
+    lateinit var edgeToEdgeProvider: EdgeToEdgeProvider
+
+    @Inject
+    lateinit var edgeToEdgeHandler: EdgeToEdgeHandler
+
     private val binding: ActivityWebviewBinding by viewBinding()
 
     private val toolbar
@@ -60,9 +69,18 @@ class WebViewActivity : DuckDuckGoActivity() {
     override fun onCreate(savedInstanceState: Bundle?) {
         super.onCreate(savedInstanceState)
 
+        val edgeToEdgeEnabled = edgeToEdgeProvider.isEnabled(EdgeToEdgeBucket.WEBVIEW)
+        if (edgeToEdgeEnabled) {
+            enableTransparentEdgeToEdge()
+        }
+
         setContentView(binding.root)
         setupToolbar(toolbar)
 
+        if (edgeToEdgeEnabled) {
+            configureEdgeToEdgeInsets()
+        }
+
         val params = intent.getActivityParams(WebViewActivityWithParams::class.java)
         val url = params?.url
         title = params?.screenTitle.orEmpty()
@@ -110,6 +128,12 @@ class WebViewActivity : DuckDuckGoActivity() {
         }
     }
 
+    private fun configureEdgeToEdgeInsets() {
+        edgeToEdgeHandler.applyHorizontalSystemBarInsets(binding.root)
+        edgeToEdgeHandler.applyStatusBarInsets(binding.includeToolbar.appBarLayout)
+        edgeToEdgeHandler.applyNavigationBarInsets(binding.webViewContainer, drawBehindGestureNav = true)
+    }
+
     override fun onOptionsItemSelected(item: MenuItem): Boolean {
         when (item.itemId) {
             android.R.id.home -> {

app/src/main/java/com/duckduckgo/app/desktopbrowser/GetDesktopBrowserActivity.kt

@@ -33,6 +33,9 @@ import com.duckduckgo.app.browser.R
 import com.duckduckgo.app.browser.databinding.ActivityGetDesktopBrowserBinding
 import com.duckduckgo.common.ui.DuckDuckGoActivity
 import com.duckduckgo.common.ui.viewbinding.viewBinding
+import com.duckduckgo.common.utils.edgetoedge.EdgeToEdgeBucket
+import com.duckduckgo.common.utils.edgetoedge.EdgeToEdgeHandler
+import com.duckduckgo.common.utils.edgetoedge.EdgeToEdgeProvider
 import com.duckduckgo.di.scopes.ActivityScope
 import com.duckduckgo.navigation.api.GlobalActivityStarter.ActivityParams
 import com.duckduckgo.navigation.api.getActivityParams
@@ -50,6 +53,12 @@ class GetDesktopBrowserActivity : DuckDuckGoActivity() {
     @Inject
     lateinit var getDesktopBrowserViewModelFactory: GetDesktopBrowserViewModel.Factory
 
+    @Inject
+    lateinit var edgeToEdgeProvider: EdgeToEdgeProvider
+
+    @Inject
+    lateinit var edgeToEdgeHandler: EdgeToEdgeHandler
+
     private val binding: ActivityGetDesktopBrowserBinding by viewBinding()
 
     private val viewModel by lazy {
@@ -60,12 +69,28 @@ class GetDesktopBrowserActivity : DuckDuckGoActivity() {
 
     override fun onCreate(savedInstanceState: Bundle?) {
         super.onCreate(savedInstanceState)
+        val edgeToEdgeEnabled = edgeToEdgeProvider.isEnabled(EdgeToEdgeBucket.MISC)
+        if (edgeToEdgeEnabled) {
+            enableTransparentEdgeToEdge()
+        }
         setContentView(binding.root)
 
         setupObservers()
         setupBackNavigationHandler()
         setupClickListeners()
         setupToolbar(binding.includeToolbar.toolbar)
+
+        if (edgeToEdgeEnabled) {
+            configureEdgeToEdgeInsets()
+        }
+    }
+
+    private fun configureEdgeToEdgeInsets() {
+        edgeToEdgeHandler.applyHorizontalSystemBarInsets(binding.root)
+        edgeToEdgeHandler.applyStatusBarInsets(binding.includeToolbar.appBarLayout)
+        // Content ends in fixed bottom buttons (Share download link / No thanks), so keep them clear of the nav
+        // bar in every mode (padded above the gesture-nav chin) rather than drawing behind the gesture handle.
+        edgeToEdgeHandler.applyNavigationBarInsets(binding.contentScrollView, drawBehindGestureNav = false)
     }
 
     private fun setupObservers() {

app/src/main/java/com/duckduckgo/app/downloads/DownloadsActivity.kt

@@ -41,6 +41,9 @@ import com.duckduckgo.common.ui.view.hideKeyboard
 import com.duckduckgo.common.ui.view.show
 import com.duckduckgo.common.ui.view.showKeyboard
 import com.duckduckgo.common.ui.viewbinding.viewBinding
+import com.duckduckgo.common.utils.edgetoedge.EdgeToEdgeBucket
+import com.duckduckgo.common.utils.edgetoedge.EdgeToEdgeHandler
+import com.duckduckgo.common.utils.edgetoedge.EdgeToEdgeProvider
 import com.duckduckgo.di.scopes.ActivityScope
 import com.duckduckgo.downloads.api.DownloadsFileActions
 import com.duckduckgo.downloads.api.DownloadsScreens.DownloadsScreenNoParams
@@ -65,6 +68,12 @@ class DownloadsActivity : DuckDuckGoActivity() {
     @Inject
     lateinit var downloadsFileActions: DownloadsFileActions
 
+    @Inject
+    lateinit var edgeToEdgeProvider: EdgeToEdgeProvider
+
+    @Inject
+    lateinit var edgeToEdgeHandler: EdgeToEdgeHandler
+
     private val toolbar
         get() = binding.toolbar
 
@@ -75,9 +84,16 @@ class DownloadsActivity : DuckDuckGoActivity() {
 
     override fun onCreate(savedInstanceState: Bundle?) {
         super.onCreate(savedInstanceState)
+        val edgeToEdgeEnabled = edgeToEdgeProvider.isEnabled(EdgeToEdgeBucket.MISC)
+        if (edgeToEdgeEnabled) {
+            enableTransparentEdgeToEdge()
+        }
         setContentView(binding.root)
         setupToolbar(toolbar)
         setupRecyclerView()
+        if (edgeToEdgeEnabled) {
+            configureEdgeToEdgeInsets()
+        }
 
         lifecycleScope.launch {
             viewModel.viewState
@@ -92,6 +108,12 @@ class DownloadsActivity : DuckDuckGoActivity() {
         }
     }
 
+    private fun configureEdgeToEdgeInsets() {
+        edgeToEdgeHandler.applyHorizontalSystemBarInsets(binding.root)
+        edgeToEdgeHandler.applyStatusBarInsets(binding.appBarLayout)
+        edgeToEdgeHandler.applyNavigationBarInsets(binding.downloadsContentView, drawBehindGestureNav = true)
+    }
+
     override fun onResume() {
         super.onResume()
         viewModel.syncDownloads()

app/src/main/java/com/duckduckgo/app/email/ui/EmailProtectionUnsupportedActivity.kt

@@ -22,7 +22,11 @@ import com.duckduckgo.anvil.annotations.InjectWith
 import com.duckduckgo.app.browser.databinding.ActivityEmailUnsupportedBinding
 import com.duckduckgo.common.ui.DuckDuckGoActivity
 import com.duckduckgo.common.ui.viewbinding.viewBinding
+import com.duckduckgo.common.utils.edgetoedge.EdgeToEdgeBucket
+import com.duckduckgo.common.utils.edgetoedge.EdgeToEdgeHandler
+import com.duckduckgo.common.utils.edgetoedge.EdgeToEdgeProvider
 import com.duckduckgo.di.scopes.ActivityScope
+import javax.inject.Inject
 
 @InjectWith(ActivityScope::class)
 @ContributeToActivityStarter(EmailProtectionUnsupportedScreenNoParams::class)
@@ -33,10 +37,31 @@ class EmailProtectionUnsupportedActivity : DuckDuckGoActivity() {
     private val toolbar
         get() = binding.includeToolbar.toolbar
 
+    @Inject
+    lateinit var edgeToEdgeProvider: EdgeToEdgeProvider
+
+    @Inject
+    lateinit var edgeToEdgeHandler: EdgeToEdgeHandler
+
     override fun onCreate(savedInstanceState: Bundle?) {
         super.onCreate(savedInstanceState)
 
+        val edgeToEdgeEnabled = edgeToEdgeProvider.isEnabled(EdgeToEdgeBucket.MISC)
+        if (edgeToEdgeEnabled) {
+            enableTransparentEdgeToEdge()
+        }
+
         setContentView(binding.root)
         setupToolbar(toolbar)
+
+        if (edgeToEdgeEnabled) {
+            configureEdgeToEdgeInsets()
+        }
+    }
+
+    private fun configureEdgeToEdgeInsets() {
+        edgeToEdgeHandler.applyHorizontalSystemBarInsets(binding.root)
+        edgeToEdgeHandler.applyStatusBarInsets(binding.includeToolbar.appBarLayout)
+        edgeToEdgeHandler.applyNavigationBarInsets(binding.contentContainer, drawBehindGestureNav = true)
     }
 }