HandKit.Maui.Poppins 1.0.0

HandKit.Maui.Poppins

Effortlessly integrate the Poppins font family into your .NET MAUI applications.

Poppins, a popular geometric sans-serif typeface, offers a clean and modern aesthetic, supporting a wide range of languages.

This plugin simplifies the process of including the Poppins font family in your .NET MAUI apps, eliminating the need for manual font embedding and registration. It provides pre-configured font resources that can be easily accessed and applied to your UI elements.

Key Features

• Easy Integration: Simple setup with a single line of code in MauiProgram.cs.
• Comprehensive Collection: Includes 8 weights and styles of the Poppins font.
• Optimized: Designed for performance in mobile and desktop environments.
• Cross-Platform: Fully compatible with Android, iOS, Windows, and macOS.

Included Fonts

The following font styles are included and registered by default:

• Regular (PoppinsRegular.ttf)
• Italic (PoppinsItalic.ttf)
• Medium (PoppinsMedium.ttf)
• MediumItalic (PoppinsMediumItalic.ttf)
• SemiBold (PoppinsSemiBold.ttf)
• SemiBoldItalic (PoppinsSemiBoldItalic.ttf)
• Bold (PoppinsBold.ttf)
• BoldItalic (PoppinsBoldItalic.ttf)

Installation

You can install the plugin via NuGet Package Manager or the .NET CLI:

Install-Package HandKit.Maui.Poppins

Setup

1. Open your MauiProgram.cs file.
2. Add the using HandKit.Maui.Poppins; namespace.
3. Call .UsePoppinsFonts() on the MauiAppBuilder.

using HandKit.Maui.Poppins;

public static class MauiProgram
{
    public static MauiApp CreateMauiApp()
    {
        var builder = MauiApp.CreateBuilder();
        builder
            .UseMauiApp<App>()
            .UsePoppinsFonts() // <-- Registers the fonts
            .ConfigureFonts(fonts =>
            {
                fonts.AddFont("OpenSans-Regular.ttf", "OpenSansRegular");
            });

        return builder.Build();
    }
}

Usage

Basic Usage

By default, the fonts are registered with their style names as aliases (e.g., Regular, Bold). You can use them directly in XAML or C#.

XAML:

<Label Text="This is Poppins Regular" FontFamily="Regular" />
<Label Text="This is Poppins Bold" FontFamily="Bold" FontAttributes="Bold" />
<Label Text="This is Poppins Italic" FontFamily="Italic" FontAttributes="Italic" />

C#:

label.FontFamily = "SemiBold";

Advanced Usage (Custom Alias / Conflict Resolution)

If you have other fonts that might conflict with names like "Regular" or "Bold", you can provide a custom prefix when registering the fonts.

MauiProgram.cs:

// Registers fonts as "PoppinsRegular", "PoppinsBold", etc.
builder.UsePoppinsFonts("Poppins"); 

XAML:

<Label Text="Using Custom Alias" FontFamily="PoppinsRegular" />
<Label Text="Using Custom Alias (Bold)" FontFamily="PoppinsBold" />

Example Project

The repository includes a sample MAUI project demonstrating the usage of the plugin. You can find it in the samples directory.

Contributing

Contributions are welcome! Please open an issue or submit a pull request.

Contact

If you have any questions or suggestions, please feel free to contact me at andyapin@gmail.com