Tooluck logoTooluck
SKILL.md

maui-safe-area

Agent skill fromdotnet/skills

.NET MAUI safe area and edge-to-edge layout guidance for .NET 10+. Covers the new SafeAreaEdges property, SafeAreaRegions enum, per-edge control, keyboard avoidance, Blazor Hybrid CSS safe areas, migration from legacy iOS-only APIs, and platform-specific behavior for Android, iOS, and Mac Catalyst. USE FOR: "safe area", "edge-to-edge", "SafeAreaEdges", "SafeAreaRegions", "keyboard avoidance", "notch insets", "status bar overlap", "iOS safe area", "Android edge-to-edge", "content behind status bar", "UseSafeArea migration", "soft input keyboard", "IgnoreSafeArea replacement". DO NOT USE FOR: general layout or grid design (use Grid and StackLayout), app lifecycle handling (use maui-app-lifecycle), theming or styling (use maui-theming), or Shell navigation structure.

How to install maui-safe-area

install maui-safe-area
# install the skills pack with the skills CLI
npx skills add dotnet/skills

# or add only this skill to Claude Code: copy the folder

plugins/dotnet-maui/skills/maui-safe-area/

# into

~/.claude/skills/maui-safe-area/ (all projects)

.claude/skills/maui-safe-area/ (one project)

plugins/dotnet-maui/skills/maui-safe-area/SKILL.md

MITFull file
1# Safe Area & Edge-to-Edge Layout (.NET 10+)
2
3.NET 10 introduces a **brand-new, cross-platform safe area API** that replaces the legacy iOS-only `UseSafeArea` and the layout-level `IgnoreSafeArea` properties. The new `SafeAreaEdges` property and `SafeAreaRegions` flags enum give you per-edge, per-control safe area management on Android, iOS, and Mac Catalyst from a single API surface.
4
5> **This is new API surface in .NET 10.** If the project targets .NET 9 or earlier, these APIs do not exist. Guide the developer to the legacy `ios:Page.UseSafeArea` and `Layout.IgnoreSafeArea` properties instead.
6
7## When to Use
8
9- Content overlaps status bar, notch, Dynamic Island, or home indicator after upgrading to .NET 10
10- Implementing edge-to-edge / immersive layouts (photo viewers, video players, maps)
11- Keyboard avoidance for chat or form UIs
12- Migrating from `ios:Page.UseSafeArea`, `Layout.IgnoreSafeArea`, or `WindowSoftInputModeAdjust.Resize`
13- Blazor Hybrid apps that need CSS `env(safe-area-inset-*)` coordination
14- Mixed layouts with an edge-to-edge header but a safe-area-respecting body
15
16## When Not to Use
17
18- Projects targeting .NET 9 or earlier — use the legacy iOS-specific APIs
19- General page layout questions unrelated to system bars or keyboard — use standard layout guidance
20- App lifecycle or navigation structure — use maui-app-lifecycle or Shell guidance
21- Theming or visual styling — use the **maui-theming** skill
22
23## Inputs
24…

Excerpt shown under the repository's MIT license.

More skills in skills

Keep exploring

Similar skill repositories

thedotmack /

claude-mem
116k

Persistent Context Across Sessions for Every Agent – Captures everything your agent does during sessions, compresses it with AI, and injects relevant context back into future sessions. Works with Claude Code, OpenClaw, Codex, Gemini, Hermes, Copilot, OpenCode + More

CCCXGHGM+135 skills

Newsletter

Join the Community

Subscribe to our newsletter for the latest news and updates