AppActions.Icons.Maui 1.0.0-pre2

AppActions.Icons.Maui

A .NET MAUI library that provides some default icons for AppActions without having to create your own.

Features

Based on iOS' Home Screen Quick Action Icons, this library provides similar icons for both Android & Windows, but styled towards the platforms default design style. Also supports the use of SFSymbols as Icons on iOS.

• Out-of-the-box icons available for Android, iOS & Windows
• Use SF Symbols on iOS
• Customise Android icons with brand colors
• Builds on top of the Maui Essentials api
• Specify different image names per platform

Getting Started

1. Add the AppActions.Icons.Maui nuget package to your MAUI project.

2. Setup you app actions as per the Maui Documentation

3. In your MauiProgram.CreateMauiApp(), add UseAppActionIcons() to your Essentials configuration builder.

   public static MauiApp CreateMauiApp()
   {
       var builder = MauiApp.CreateBuilder();
       builder
           .UseMauiApp<App>()
           .ConfigureEssentials(essentials =>
           {
               essentials
                   .UseAppActionIcons() // Add this line
                   .AddAppAction("home_sc", "Home", icon: AppActionIcon.Home)
                   .OnAppAction(App.HandleAppActions);
           });
   
       return builder.Build();
   }
   

4. Now set the AppAction's icon property using one of the provided AppActionIcon options

For more examples of how to use and some troubleshooting tips, check the Github Repository