BetterBreadcrumbBar.WinUI3
0.8.7
dotnet add package BetterBreadcrumbBar.WinUI3 --version 0.8.7
NuGet\Install-Package BetterBreadcrumbBar.WinUI3 -Version 0.8.7
<PackageReference Include="BetterBreadcrumbBar.WinUI3" Version="0.8.7" />
<PackageVersion Include="BetterBreadcrumbBar.WinUI3" Version="0.8.7" />
<PackageReference Include="BetterBreadcrumbBar.WinUI3" />
paket add BetterBreadcrumbBar.WinUI3 --version 0.8.7
#r "nuget: BetterBreadcrumbBar.WinUI3, 0.8.7"
#:package BetterBreadcrumbBar.WinUI3@0.8.7
#addin nuget:?package=BetterBreadcrumbBar.WinUI3&version=0.8.7
#tool nuget:?package=BetterBreadcrumbBar.WinUI3&version=0.8.7
BetterBreadcrumbBar for WinUI 3
Author: Matteo Riso — zipgenius.it Version: 0.8.0 · Written with Claude AI · MIT License
A Windows-Explorer-style breadcrumb navigation bar for WinUI 3 / Windows App SDK.
Features
| Feature | Property / Event |
|---|---|
| Clickable path segments | SegmentClicked |
| Chevron dropdowns (siblings / children) | NodeSelected, IPathProvider |
| Optional last-segment chevron | ShowLastSegmentChevron |
Optional leading icon (SymbolIcon, FontIcon, …) |
LeadingIcon |
| Optional Back / Up / Home buttons | ShowBackButton, ShowUpButton, ShowHomeButton |
| Customisable button tooltips | BackButtonTooltip, UpButtonTooltip, HomeButtonTooltip |
| Bar tooltip shows current path | CurrentPath (read-only DP) |
| Inline address bar with autocomplete | PathSubmitted, IPathProvider.GetSuggestionsAsync |
| Overflow management (narrow windows) | automatic "…" button |
| Right-to-left layout | FlowDirection="RightToLeft" |
| Full typography customisation | FontFamily, FontSize, FontWeight, FontStyle, FontStretch, Foreground, CharacterSpacing |
| PerMonitorV2 Hi-DPI | app.manifest |
Requirements
- Windows App SDK 1.8+ runtime installed on the target machine
- .NET 9 / Windows 10 19041+
Quick start
xmlns:ctrl="using:BetterBreadcrumbBar.Control"
<ctrl:BetterBreadcrumbBar
x:Name="MyBreadcrumb"
PathProvider="{x:Bind MyProvider}"
ShowLastSegmentChevron="True"
ShowBackButton="True"
ShowUpButton="True"
ShowHomeButton="True"
CanGoBack="{x:Bind CanGoBack, Mode=OneWay}"
SegmentClicked="OnSegmentClicked"
NodeSelected="OnNodeSelected"
PathSubmitted="OnPathSubmitted"
BackRequested="OnBackRequested"
UpRequested="OnUpRequested"
HomeRequested="OnHomeRequested"/>
// Navigate to a path
MyBreadcrumb.SetPath(@"C:\Users\Public\Documents");
// Or supply an ordered list of PathNode objects
MyBreadcrumb.SetPath(myProvider.BuildPathNodes(currentPath));
IPathProvider
public class MyProvider : IPathProvider
{
public Task<IEnumerable<PathNode>> GetChildrenAsync(PathNode node, CancellationToken ct)
=> /* return child nodes */ Task.FromResult(Enumerable.Empty<PathNode>());
// Optional: drives autocomplete in the inline address bar
public Task<IEnumerable<string>> GetSuggestionsAsync(string partial, CancellationToken ct)
=> /* return matching paths */ Task.FromResult(Enumerable.Empty<string>());
}
Two ready-made providers are included:
FileSystemPathProvider— Windows filesystem paths (C:\Users\...)VirtualPathProvider— virtual / ZIP-style paths (src/components/...)
Typography
All standard WinUI 3 typography properties are fully supported and live-updatable:
<ctrl:BetterBreadcrumbBar
FontFamily="Cascadia Code"
FontSize="14"
FontWeight="SemiBold"/>
License
MIT — see LICENSE.
| Product | Versions Compatible and additional computed target framework versions. |
|---|---|
| .NET | net9.0-windows10.0.19041 is compatible. net10.0-windows was computed. |
-
net9.0-windows10.0.19041
- Microsoft.Windows.SDK.BuildTools (>= 10.0.26100.7705)
- Microsoft.WindowsAppSDK (>= 1.8.260209005)
NuGet packages
This package is not used by any NuGet packages.
GitHub repositories
This package is not used by any popular GitHub repositories.
| Version | Downloads | Last Updated |
|---|---|---|
| 0.8.7 | 86 | 2/27/2026 |
v0.8.7
- Fix: NuGet package Project Website and Source Repository URLs corrected
- Fix: FindDescendant build error resolved
v0.8.6
- Fix: demo app title and header now show the correct version number
v0.8.5
- Chevron and overflow flyouts now cap at 10 visible rows (scrollable)
- Demo: removed hard-coded FontFamily from breadcrumb controls
v0.8.0
- Renamed from ExplorerBreadcrumbBar to BetterBreadcrumbBar
- Full typography support: FontFamily, FontSize, FontWeight, FontStyle,
FontStretch, Foreground, CharacterSpacing (all live-updatable)
- Right-to-left layout support (FlowDirection=RightToLeft)
- Overflow management: ellipsis button when segments do not fit
- Inline address box with provider-driven autocomplete
- IPathProvider pattern: filesystem, ZIP archives, or any virtual tree
- Optional Back / Up / Home navigation buttons with customisable tooltips
- Optional leading icon (SymbolIcon, FontIcon, or any IconElement)
- PerMonitorV2 Hi-DPI support via app.manifest