Thank you for sharing the details, here’s is the Step-by-Step Guide.
switching app icons based on system theme is a great way to enhance the user experience, and MAUI gives you a few options depending on the platform.
iOS & Mac Catalyst
iOS supports alternate app icons, which you can switch at runtime. You’ll need to:
Add alternate icons to your asset catalog (e.g., AppIconLight
, AppIconDark
)
Define them in your Info.plist
under CFBundleAlternateIcons
Use UIApplication.SharedApplication.SetAlternateIconName(...)
to switch icons based on the current theme
This works while the app is running, but note that iOS won’t auto-switch icons when the system theme changes unless your app is open.
Android
Android doesn’t support dynamic icon switching in the same way, but you can:
Use a monochrome icon layer (Android 13+) that adapts to light/dark mode automatically
- Or use activity aliases with different icons and enable/disable them at runtime (more complex)
SVG Support
Since your icon is an SVG, you’ll need to export it as PNGs for platform compatibility. MAUI doesn’t support SVGs directly for app icons, but you can use them within your app UI using libraries like SkiaSharp.
Let me know if the issue persists after following these steps. I’ll be happy to assist further if needed. If the issue has been resolved, kindly mark the response as answered.