Restore Android system-bar layout after MAUI 10 edge-to-edge

[myieye]

TL;DR - Android's windowOptOutEdgeToEdgeEnforcement got deprecated. This PR uses the MAUI-provided alternative. A difference now is that we have our "brand navy-blue" in the notches of phones in landscape mode, which feels a bit odd. The pro-fix is in: #2283

Develop has been broken on Android since the .NET 10 / MAUI 10 bump (#2264): MauiAppCompatActivity.OnCreate now calls WindowCompat.SetDecorFitsSystemWindows(false) unconditionally, the old windowOptOutEdgeToEdgeEnforcement style is deprecated on API ≥ 36, and the BlazorWebView drew under the status / nav bars.

This restores the pre-MAUI-10 look:

• MainPage.xaml sets SafeAreaEdges="Container" (MAUI 10's official replacement for the deprecated opt-out), which pads the BlazorWebView back inside the safe area.
• MainActivity paints the surrounding gutter with colorPrimaryDark (the existing brand navy) and pins the system-bar icons to light. Re-applied on OnConfigurationChanged because MAUI re-decides icon appearance on config changes.
• The deprecated values-v35/styles.xml opt-out and the now-empty values/styles.xml are deleted.

Visually verified on a Pixel 9 / Android 16 emulator across portrait + landscape, system theme toggle, and the in-app theme override.

Considered and rejected: try/android-targetsdk-pin (5-line manifest pin to SDK 35 — doesn't help because MAUI calls SetDecorFitsSystemWindows(false) regardless of targetSdk), try/android-shrink-webview (Agent 2's ~120-line native-band approach, also works but larger), fix/android-edge-to-edge (the embrace-edge-to-edge branch with ~220 lines of CSS / Svelte adjustments). This branch is the smallest of the four that actually fixes the issue.

🤖 Generated with Claude Code

[coderabbitai]

📝 Walkthrough

Walkthrough

This PR refactors Android edge-to-edge display handling in FwLite by replacing style-based opt-out with runtime system-bar styling. The XAML declares safe-area container behavior; Android code applies branded window colors and insets controller configuration during initialization and after device configuration changes.

Changes

Android Edge-to-Edge Display and Safe-Area Styling

Layer / File(s)	Summary
XAML safe-area configuration and documentation backend/FwLite/FwLiteMaui/MainPage.xaml, backend/FwLite/FwLiteMaui/MainPage.xaml.Android.cs	MainPage now declares SafeAreaEdges="Container" to configure safe-area padding. Inline documentation explains how this affects BlazorWebView padding and system-bar gutter coloring in edge-to-edge mode.
Android system-bar implementation backend/FwLite/FwLiteMaui/Platforms/Android/MainActivity.cs	MainActivity applies branded system-bar styling via ApplyBrandedSystemBars() helper in OnCreate and re-applies it after configuration changes via new OnConfigurationChanged override. Uses AndroidX insets controller to configure status/navigation bar appearance. Removes previous style-based edge-to-edge opt-out approach.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~12 minutes

Suggested labels

💻 FW Lite

Poem

🐰 The edges bloom edge-to-edge so clean,
With SafeAreaEdges in between,
System bars branded, styled just right,
OnConfigChanged keeps them tight,
Android's bounds now safe and seen! 📱✨

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check name	Status	Explanation	Resolution
Docstring Coverage	⚠️ Warning	Docstring coverage is 16.67% which is insufficient. The required threshold is 80.00%.	Write docstrings for the functions missing them to satisfy the coverage threshold.

✅ Passed checks (4 passed)

Check name	Status	Explanation
Title check	✅ Passed	The title clearly and specifically summarizes the main change: restoring Android system-bar layout after the MAUI 10 edge-to-edge upgrade, which is the core issue addressed by the changeset.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Description check	✅ Passed	The pull request description clearly explains the problem (Android edge-to-edge regression in MAUI 10), the solution (SafeAreaEdges property and MainActivity styling), and provides implementation details matching the changeset.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing Touches

📝 Generate docstrings

• Create stacked PR
• Commit on current branch

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch try/android-alternative-safearea-edges

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[github-actions]

UI unit Tests

  1 files  ±0   59 suites  ±0   28s ⏱️ ±0s
176 tests ±0  176 ✅ ±0  0 💤 ±0  0 ❌ ±0 
245 runs  ±0  245 ✅ ±0  0 💤 ±0  0 ❌ ±0 

Results for commit 9338808. ± Comparison against base commit e362dd4.

♻️ This comment has been updated with latest results.

[argos-ci]

The latest updates on your projects. Learn more about Argos notifications ↗︎

Build	Status	Details	Updated (UTC)
default (Inspect)	✅ No changes detected	-	May 21, 2026, 12:18 PM