Fishman.Maui.Shell.MarkerModifier
10.2.0
dotnet add package Fishman.Maui.Shell.MarkerModifier --version 10.2.0
NuGet\Install-Package Fishman.Maui.Shell.MarkerModifier -Version 10.2.0
<PackageReference Include="Fishman.Maui.Shell.MarkerModifier" Version="10.2.0" />
<PackageVersion Include="Fishman.Maui.Shell.MarkerModifier" Version="10.2.0" />
<PackageReference Include="Fishman.Maui.Shell.MarkerModifier" />
paket add Fishman.Maui.Shell.MarkerModifier --version 10.2.0
#r "nuget: Fishman.Maui.Shell.MarkerModifier, 10.2.0"
#:package Fishman.Maui.Shell.MarkerModifier@10.2.0
#addin nuget:?package=Fishman.Maui.Shell.MarkerModifier&version=10.2.0
#tool nuget:?package=Fishman.Maui.Shell.MarkerModifier&version=10.2.0
Maui.Shell.MarkerModifier
Maui.Shell.MarkerModifier is a lightweight .NET MAUI library for customizing Shell visual markers (selection indicators).
Starting with version 10.2.0, the library uses Attached Properties. This allows you to style markers directly in XAML with full Hot Reload support.
✨ Features
- 🎨 XAML Integration: Set Color, Height, and Width directly on the
<Shell\>tag. - 🛠 Declarative UI: Manage visuals in XAML without extra C# code in MauiProgram.
- 📱 Platform Support: Optimized for Windows
(WinUI 3)with safe fallbacks for iOS/Android.
📦 Installation
Install the package via NuGet:
dotnet add package Maui.Shell.MarkerModifier --version 10.2.0
🚀 Getting Started
Setup in AppShell.xaml
Add the xmlns:marker namespace and apply properties to your root Shell element. This will update markers for all navigation items.
<Shell x:Class="MauiApp1.AppShell"
xmlns="[http://schemas.microsoft.com/dotnet/2021/maui](http://schemas.microsoft.com/dotnet/2021/maui)"
xmlns:x="[http://schemas.microsoft.com/winfx/2009/xaml](http://schemas.microsoft.com/winfx/2009/xaml)"
xmlns:marker="clr-namespace:Maui.Shell.MarkerModifier.Extensions;assembly=Maui.Shell.MarkerModifier"
xmlns:local="clr-namespace:MauiApp1"
Title="MauiApp1"
marker:MarkerWindowsExtensions.Color="Red"
marker:MarkerWindowsExtensions.Width="30"
marker:MarkerWindowsExtensions.Height="30"\>
<ShellContent Title="Home"
ContentTemplate="{DataTemplate local:MainPage}"
Route="MainPage" \>
<ShellContent Title="Exit"
ContentTemplate="{DataTemplate local:NewPage1}"
Route="NewPage1" \>
</Shell>
⚙️ Available Properties
Use the MarkerWindowsExtensions class to access these properties:
| Property | Description | Type | Default Value |
|---|---|---|---|
| Color | The color of the selection indicator. | Color | Colors.Transparent |
| Height | The thickness (height) of the marker line. | double | -1 |
| Width | The width of the marker line (Windows specific). | double | -1 |
⚠️ Important Changes
Legacy configuration methods like .UseShellMarker() are now [Obsolete]. Please use XAML Attached Properties for all settings in version 10.2.0.
📄 License
Boost Software License – Version 1.0
Copyright (c) 2025 Fishman. Built for the .NET MAUI community.
| Product | Versions Compatible and additional computed target framework versions. |
|---|---|
| .NET | net10.0-android36.0 is compatible. net10.0-ios26.0 is compatible. net10.0-maccatalyst26.0 is compatible. net10.0-windows10.0.19041 is compatible. |
-
net10.0-android36.0
- Microsoft.Maui.Controls (>= 10.0.1)
-
net10.0-ios26.0
- Microsoft.Maui.Controls (>= 10.0.1)
-
net10.0-maccatalyst26.0
- Microsoft.Maui.Controls (>= 10.0.1)
-
net10.0-windows10.0.19041
- Microsoft.Maui.Controls (>= 10.0.1)
NuGet packages
This package is not used by any NuGet packages.
GitHub repositories
This package is not used by any popular GitHub repositories.
Maui.Shell.MarkerModifier offers a straightforward API for styling Shell menu markers on Windows within .NET MAUI. It enables developers to customize marker colors and sizes while ensuring full compatibility with standard Shell elements. The project is actively evolving, with advanced styling options and enhanced integration tools planned for upcoming versions.