dotnet-maui-aot

Configure Native AOT compilation for .NET MAUI iOS and Mac Catalyst apps.

10|Updated Jan 28, 2026
One-click install
npx skills add https://github.com/AGIBuild/Agibuild.Fulora --skill dotnet-maui-aot
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: dotnet-maui-aot
Source: https://github.com/AGIBuild/Agibuild.Fulora/tree/main/.cursor/skills/dotnet-maui-aot
Command: npx skills add https://github.com/AGIBuild/Agibuild.Fulora --skill dotnet-maui-aot

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill addresses the challenges of optimizing .NET MAUI applications for iOS and Mac Catalyst by leveraging Native AOT compilation, leading to significant improvements in app size and startup performance.

Core Features & Use Cases

  • Native AOT Pipeline: Understand and configure the compilation process for Native AOT on iOS/Catalyst.
  • Size & Startup Optimization: Achieve up to 50% reduction in app size and startup time.
  • Library Compatibility: Identify and resolve issues with .NET libraries in an AOT environment.
  • Trimming & Opt-Out: Manage trimming interplay and configure opt-out mechanisms for specific scenarios.
  • Use Case: A developer wants to reduce their MAUI app's download size and make it launch faster on user devices. They use this Skill to configure Native AOT, address library compatibility warnings, and test the final AOT build.

Quick Start

Configure your .NET MAUI project to use Native AOT for iOS by setting PublishAot to true in your .csproj file.

Frequently Asked Questions about dotnet-maui-aot

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I enable Native AOT compilation in a .NET MAUI iOS app?

Enable Native AOT in .NET MAUI iOS apps by setting the PublishAot property to true in your .csproj file. This activates the native compilation pipeline to optimize app size and startup performance for iOS and Mac Catalyst.

What performance improvements can I expect from Native AOT in MAUI?

Native AOT in MAUI achieves up to a 50% reduction in both app size and startup time. This optimization significantly enhances the user experience on iOS and Mac Catalyst devices by delivering faster launches and smaller downloads.

Does Native AOT work with all .NET MAUI libraries on iOS?

Not all .NET libraries are compatible with Native AOT on iOS. You must identify and resolve library compatibility warnings and manage trimming interactions to ensure full AOT support.

Why does trimming cause issues when using Native AOT with .NET MAUI?

Trimming issues with Native AOT in .NET MAUI occur because the AOT compilation process removes unused code, which can conflict with libraries relying on reflection. You can manage trimming interplay and configure opt-out mechanisms for specific scenarios.

Can I use Native AOT for Mac Catalyst apps with .NET MAUI?

Yes, you can use Native AOT for Mac Catalyst apps with .NET MAUI. The optimization targets a .NET 8.0+ baseline and supports both iOS and Mac Catalyst platforms for size and startup time improvements.