maui-safe-area

Configure SafeAreaEdges and SafeAreaRegions for .NET MAUI 10+ apps.

Updated Nov 27, 2025
One-click install
npx skills add https://github.com/seydakaratekeli/KamPay3 --skill maui-safe-area-seydakaratekeli
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: maui-safe-area
Source: https://github.com/seydakaratekeli/KamPay3/tree/main/KamPay/.github/skills/maui-safe-area%20-%20Kopyala
Command: npx skills add https://github.com/seydakaratekeli/KamPay3 --skill maui-safe-area-seydakaratekeli

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill documents how to avoid content being obscured by system UI and notches while enabling edge-to-edge layouts in .NET MAUI 10+, and how to preserve keyboard-aware behavior and platform-consistent insets after migration from older APIs.

Core Features & Use Cases

  • Explains the SafeAreaEdges property and the SafeAreaRegions enum and how to combine flags for per-edge behavior.
  • Shows patterns for edge-to-edge backgrounds, keyboard avoidance for chat/input bars, and mixed layouts with safe bodies and edge-to-edge headers.
  • Covers Blazor Hybrid guidance using CSS env() and viewport-fit=cover, plus migration mappings from legacy UseSafeArea and IgnoreSafeArea properties.
  • Provides platform-specific notes for Android, iOS, and Mac Catalyst and a checklist for common upgrade issues and breaking changes.

Quick Start

Set SafeAreaEdges to None on both the ContentPage and its primary layout to enable full edge-to-edge content and set the bottom edge to SoftInput on a wrapper layout to preserve keyboard avoidance.

Frequently Asked Questions about maui-safe-area

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I configure edge-to-edge layouts in .NET MAUI without content being obscured by notches?

To enable edge-to-edge layouts in .NET MAUI 10+, set SafeAreaEdges to None on both the ContentPage and its primary layout. This allows full screen content while avoiding system UI overlap.

What is the difference between SafeAreaEdges and SafeAreaRegions in .NET MAUI?

SafeAreaEdges defines per-edge behavior for system UI avoidance, while SafeAreaRegions uses enum flags to combine specific safe area behaviors. Both properties are used together to configure edge-to-edge layouts in .NET MAUI.

How do I preserve keyboard avoidance for input bars in a .NET MAUI edge-to-edge layout?

To preserve keyboard avoidance in .NET MAUI edge-to-edge layouts, set the bottom edge to SoftInput on a wrapper layout. This ensures input bars remain visible above the keyboard without disabling full screen backgrounds.

Does this .NET MAUI safe area guidance apply to Blazor Hybrid web views?

Yes, the guidance covers Blazor Hybrid web views by integrating CSS env() and viewport-fit=cover. This ensures Blazor web content respects the native safe area insets on Android, iOS, and Mac Catalyst.

How do I migrate from legacy UseSafeArea and IgnoreSafeArea properties in .NET MAUI 10?

To migrate from legacy UseSafeArea and IgnoreSafeArea properties, follow the provided migration mappings to adopt SafeAreaEdges and SafeAreaRegions. The guidance includes a checklist for resolving common upgrade issues and breaking changes.