Fishman.Maui.Shell.MarkerModifier 10.3.0

Maui.Shell.MarkerModifier

Maui.Shell.MarkerModifier is a lightweight .NET MAUI library for styling and customizing Shell navigation visual markers (selection indicators).

Starting with version 10.3.0, the library provides the modern ShellMarker Attached Properties API for declarative styling directly in XAML with full Hot Reload support.

✨ Features

• 🎨 Declarative XAML Integration: Set Color, Dimensions (Width, Height), CornerRadius, Margin, and Visibility directly on your <Shell> root element.
• 🔥 Hot Reload Support: Tweak marker appearance at runtime without restarting your application.
• 🌓 Theme-Aware (Windows WinUI 3): Fully persists custom indicator styling across system theme changes (Light / Dark mode).
• 📱 Multi-Platform Architecture: Windows (WinUI 3) selection indicators fully styled; Android and iOS platform hooks prepared.
• 🔄 100% Backwards Compatible: Retains MarkerWindowsExtensions for projects upgrading from 10.2.0.

📦 Installation

Install the package via the .NET CLI:

dotnet add package Fishman.Maui.Shell.MarkerModifier --version 10.3.0

Or via the NuGet Package Manager Console:

Install-Package Fishman.Maui.Shell.MarkerModifier -Version 10.3.0

🚀 Getting Started

1. Setup in AppShell.xaml

Add the xmlns:marker namespace and apply the ShellMarker attached properties to your root <Shell> tag:

<Shell x:Class="MyMauiApp.AppShell"
       xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
       xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
       xmlns:marker="clr-namespace:Maui.Shell.MarkerModifier;assembly=Maui.Shell.MarkerModifier"
       xmlns:local="clr-namespace:MyMauiApp"
       Title="MyMauiApp"
       FlyoutBehavior="Locked"

       
       marker:ShellMarker.Color="DarkGoldenrod"
       marker:ShellMarker.Width="30"
       marker:ShellMarker.Height="30"
       marker:ShellMarker.CornerRadius="6"
       marker:ShellMarker.Margin="4,0,4,0"
       marker:ShellMarker.IsVisible="True">

    <ShellContent Title="Home"
                  ContentTemplate="{DataTemplate local:MainPage}"
                  Route="MainPage" />

    <ShellContent Title="Settings"
                  ContentTemplate="{DataTemplate local:SettingsPage}"
                  Route="SettingsPage" />
</Shell>

Tip: Because Maui.Shell.MarkerModifier defines [XmlnsDefinition], you can also use ShellMarker.* directly without declaring a custom namespace in many XAML compilers!

⚙️ Available Attached Properties

All properties can be applied via the ShellMarker class (or via MarkerWindowsExtensions for 10.2.0 compatibility):

⚠️ Migration Notes

• Upgrading from 10.2.0: The MarkerWindowsExtensions class is preserved and delegates to ShellMarker. Existing code using marker:MarkerWindowsExtensions.Color will continue to compile and run seamlessly.
• Upgrading from 10.1.0 or older: The fluent builder method .UseShellMarker() in MauiProgram.cs is deprecated in favor of declarative XAML Attached Properties.

📄 License

Distributed under the Boost Software License – Version 1.0. See License.txt for details.

Copyright (c) 2025–2026 Fishman. Built for the .NET MAUI community.