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/platform-integration.md
View on GitHub# Platform Integration
## Choose A Boundary
| Need | Preferred Approach |
| --- | --- |
| Cross-platform device capability | MAUI Essentials API, wrapped by an app service when it affects business flow |
| Native-only behavior | Shared interface with an implementation in `Platforms/<target>/` |
| Small UI variation | Platform-specific view-layer code or XAML |
| Native control customization | Handler mapper scoped to the control and platform |
| Build/resource variation | Conditional MSBuild in the single project |
- Keep direct Android, iOS, Mac Catalyst, and Windows types out of shared domain and view-model code.
- Prefer partial classes for small target implementations and services for behavior that needs mocking or replacement.
- Use handler customization sparingly. A global mapper changes every instance of that control type; isolate it when behavior is feature-specific.
## Permissions And Privacy
- Declare Android permissions in `Platforms/Android/AndroidManifest.xml`. Add required iOS/Mac Catalyst usage-description keys and entitlements/capabilities before access.
- Request runtime permissions immediately before the feature needs them, check the returned status, and provide a usable denial path.
- Validate all data from platform callbacks, files, URI/deep links, sensors, and share targets.
- Use `SecureStorage` only for small secrets. Never log credentials, access tokens, locations, or personal data.
## Sources
- [Platform integration](https://learn.microsoft.com/dotnet/maui/platform-integration/?view=net-maui-10.0)
- [Handlers](https://learn.microsoft.com/dotnet/maui/user-interface/handlers/?view=net-maui-10.0)
- [Permissions](https://learn.microsoft.com/dotnet/maui/platform-integration/appmodel/permissions?view=net-maui-10.0)
- [Secure storage](https://learn.microsoft.com/dotnet/maui/platform-integration/storage/secure-storage?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 |