EightBot.Maui.Badger 0.1.2

<p align="center"> <img src="logo.png" alt="EightBot.Maui.Badger Logo" width="128" height="128"> </p>

EightBot.Maui.Badger

A .NET MAUI library for adding badges to TabbedPage tabs with support for custom colors.

Features

• 🏷️ Badge Text - Display text or numbers on tab badges
• 🎨 Custom Colors - Customize badge background and text colors
• 📱 Cross-Platform - Supports Android, iOS, and MacCatalyst

Platform Support

Installation

Install via NuGet Package Manager:

dotnet add package EightBot.Maui.Badger

Or via the Package Manager Console:

Install-Package EightBot.Maui.Badger

Setup

Add .UseBadger() in your MauiProgram.cs:

using EightBot.Maui.Badger;

public static MauiApp CreateMauiApp()
{
    var builder = MauiApp.CreateBuilder();
    builder
        .UseMauiApp<App>()
        .UseBadger();  // Add this line

    return builder.Build();
}

Usage

XAML

<TabbedPage xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
            xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
            xmlns:badger="clr-namespace:EightBot.Maui.Badger;assembly=EightBot.Maui.Badger">
    
    <ContentPage Title="Home"
                 badger:TabBadge.BadgeText="5"
                 badger:TabBadge.BadgeColor="Red"
                 badger:TabBadge.BadgeTextColor="White">
        
    </ContentPage>
    
    <ContentPage Title="Messages"
                 badger:TabBadge.BadgeText="{Binding UnreadCount}"
                 badger:TabBadge.BadgeColor="#FF5722">
        
    </ContentPage>
    
</TabbedPage>

C#

using EightBot.Maui.Badger;

// Set badge on a page
TabBadge.SetBadgeText(myPage, "99+");
TabBadge.SetBadgeColor(myPage, Colors.Red);
TabBadge.SetBadgeTextColor(myPage, Colors.White);

// Clear badge
TabBadge.SetBadgeText(myPage, null);

API Reference

Attached Properties

Sample Application

A sample application demonstrating all features is included in the repository under EightBot.Maui.Badger.Sample.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Acknowledgments

• Inspired by the original Xamarin.Forms Tab Badge library

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.