maui-safe-area

Configure SafeAreaEdges and SafeAreaRegions for .NET MAUI layouts across platforms.

Updated Apr 21, 2026
One-click install
npx skills add https://github.com/snailb1007/snail-codex-skills --skill maui-safe-area-snailb1007
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: maui-safe-area
Source: https://github.com/snailb1007/snail-codex-skills/tree/main/skills/maui-safe-area
Command: npx skills add https://github.com/snailb1007/snail-codex-skills --skill maui-safe-area-snailb1007

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill guides .NET MAUI developers to implement robust safe-area handling and edge-to-edge layouts across Android, iOS, and Mac Catalyst, preventing content from clashing with status bars, notches, and keyboards.

Core Features & Use Cases

  • Per-edge SafeAreaEdges guidance to control left, top, right, and bottom insets.
  • Migration and interoperability notes for legacy APIs such as ios:Page.UseSafeArea and IgnoreSafeArea.
  • Platform-specific behavior details with best practices for keyboard avoidance, Blazor Hybrid scenarios, and notched device layouts.

Quick Start

Set ContentPage SafeAreaEdges to None for edge-to-edge layouts, then apply per-edge SafeAreaEdges on child layouts as needed.

Frequently Asked Questions about maui-safe-area

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

FAQPage Schema
How do I handle safe-area insets for edge-to-edge layouts in .NET MAUI?▼

To handle safe-area insets for edge-to-edge layouts in .NET MAUI, set the ContentPage SafeAreaEdges to None, then apply per-edge SafeAreaEdges configurations on child layouts to prevent clashing with notches and status bars.

How do I migrate from ios:Page.UseSafeArea to SafeAreaEdges in .NET MAUI?▼

Migrating from ios:Page.UseSafeArea to SafeAreaEdges involves adopting the new per-edge configuration API and reviewing interoperability notes for IgnoreSafeArea to ensure consistent layout behavior across iOS and Mac Catalyst.

What is the best way to configure safe-area regions for notched devices in MAUI?▼

Configuring safe-area regions for notched devices in MAUI requires using SafeAreaRegions and SafeAreaEdges to apply granular per-edge insets, ensuring content avoids physical display cutouts across Android and iOS platforms.

Does .NET MAUI safe-area handling work with Blazor Hybrid keyboard avoidance?▼

Yes, .NET MAUI safe-area handling works with Blazor Hybrid scenarios, providing specific best practices for keyboard avoidance and platform-specific behavior to ensure web UI components remain visible during input.

Why does my MAUI content overlap the status bar on Android and iOS?▼

Content overlaps the status bar in MAUI when safe-area insets are not applied, which you can resolve by setting SafeAreaEdges on your layouts to enforce proper padding for edge-to-edge designs across platforms.