aalmada/Stationary / .agents/skills/dotnet-maui
dotnet-maui
VerifiedBuild, architect, debug, test, and publish .NET MAUI 10 cross-platform native apps for Android, iOS, Mac Catalyst, and Windows using C#, XAML, or C# markup. USE FOR: MAUI project configuration, single-project targeting, pages, layouts, controls, XAML, MVVM, data binding, CommunityToolkit.Mvvm, dependency injection, Shell navigation, handlers, platform integration, permissions, lifecycle, accessibility, localization, performance, trimming, Appium UI tests, Android/iOS/Windows publishing. DO NOT USE FOR: ASP.NET Core web UI, Blazor-only apps, Avalonia, WPF-only, Xamarin.Forms migration without MAUI target code, or generic .NET code with no MAUI UI or platform concern.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 6.2 KB |
| references/architecture-and-startup.md | markdown | 2.4 KB |
| references/best-practices.md | markdown | 7.2 KB |
| references/deployment-and-publishing.md | markdown | 1.9 KB |
| references/lifecycle-and-async.md | markdown | 1.7 KB |
| references/mvvm-bindings-and-ui.md | markdown | 3.9 KB |
| references/performance-and-trimming.md | markdown | 1.9 KB |
| references/platform-integration.md | markdown | 1.8 KB |
| references/shell-navigation.md | markdown | 1.7 KB |
| references/sources.md | markdown | 1.9 KB |
| references/testing.md | markdown | 1.6 KB |
references/shell-navigation.md
View on GitHub# Shell Navigation
## Route Design
- Use Shell for the application's primary hierarchy: tabs, flyout destinations, and root-level content.
- Explicitly set `Route` for every hierarchy item. Runtime-generated routes are not stable between sessions.
- Register detail pages not declared in the visual hierarchy with `Routing.RegisterRoute` before navigation. Duplicate routes throw `ArgumentException`.
- Use simple, globally unique route names and avoid coupling route strings to view-model type names.
## Navigate Safely
- Await `Shell.Current.GoToAsync` and let calling code handle failures and cancellation.
- Use absolute URIs such as `//home` for root navigation and relative routes for contextual navigation.
- Pass IDs or small immutable values. Resolve domain data at the destination and validate every navigation value, including deep-link values.
- Do not pass secrets or large mutable objects in query strings or navigation parameters.
- Test route resolution, tab switching, modal flows, back navigation, login/logout reset, and deep-link behavior.
## Lifecycle And Interception
- Use `Navigating` to validate/cancel a navigation or coordinate a navigation-specific action. Use `Navigated` for state that requires the completed destination.
- Keep navigation policy in an injectable service or view model when business rules control it; do not embed policy in page event handlers.
- Deregister temporary routes with `Routing.UnRegisterRoute` only when their lifetime is intentionally limited.
## Sources
- [Shell navigation](https://learn.microsoft.com/dotnet/maui/fundamentals/shell/navigation?view=net-maui-10.0)
- [Shell](https://learn.microsoft.com/dotnet/maui/fundamentals/shell/?view=net-maui-10.0)
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| finishing-a-development-branchobra/superpowersUse when implementation is complete, all tests pass, and you need to decide how to integrate the work | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| systematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixes | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| test-driven-developmentobra/superpowersUse when implementing any feature or bugfix, before writing implementation code | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| skill-creatoranthropics/skillsCreate new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |