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/lifecycle-and-async.md
View on GitHub# Lifecycle And Async Work
## Window Lifecycle
| Event | Typical Action |
| --- | --- |
| `Created` | Initialize work that needs a native window/handler |
| `Activated` | Resume focus-dependent UI work |
| `Deactivated` | Stop focus-dependent work and protect sensitive content |
| `Stopped` | Cancel requests, pause streams, release exclusive resources |
| `Resumed` | Reconnect subscriptions and refresh visible content |
| `Destroying` | Detach native-window/control event subscriptions |
- Subscribe in `App.CreateWindow` or override methods on a custom `Window` class. Do not assume `Resumed` occurs on the first app launch.
- The OS may terminate a stopped app without a resume. Persist important state before it becomes unrecoverable.
- On iOS and Mac Catalyst, use `Backgrounding` state for small state that must survive backgrounding, and restore it through activation state.
## Async Boundaries
- Propagate `CancellationToken` from page/workflow ownership into HTTP, storage, and long-running work. Cancel it when navigation or lifecycle makes results irrelevant.
- Represent loading, empty, failure, and retry states in the view model. Do not suppress expected operational failures.
- Use `async Task` by default. Restrict `async void` to required framework event signatures and handle exceptions inside them.
- Update native controls and bound collections from the main thread. Avoid holding a page reference across an awaited background operation.
## Sources
- [App lifecycle](https://learn.microsoft.com/dotnet/maui/fundamentals/app-lifecycle?view=net-maui-10.0)
- [Main thread](https://learn.microsoft.com/dotnet/maui/platform-integration/appmodel/main-thread?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 |