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.