MaterialDesignInXAML/MaterialDesignInXamlToolkit

This system is a comprehensive WPF UI component library that implements Material Design 2 and 3 themes, providing a rich set of controls, behaviors, and transition animations. It features a robust color engine that generates dynamic palettes and ensures accessibility compliance through WCAG contrast calculations. The toolkit also includes integration bridges for MahApps.Metro and specialized utilities for color manipulation and resource generation.

30 changes.

The project underwent a comprehensive modernization by upgrading to .NET 10, implementing centralized package management, and migrating to modern C\# patterns like CommunityToolkit.Mvvm. This period also introduced full support for Material Design 3, expanded the color manipulation API, and added new UI components such as the Transitioner and TreeListView. Development efforts were further bolstered by new demo applications, automated resource generation tools, and significantly expanded test coverage.

6 changes.

This period focused on porting core Material Design 3 specifications to .NET, including dynamic color utilities and motion primitives. It also introduced internal WPF behaviors and converters to refine UI layout, accessibility, and control states in alignment with these new standards.

This change introduces the \MaterialDesign3.Motion\ library, porting core animation primitives from Android's Compose Animation and Material3 libraries to support Material Design 3 motion in WPF. The new codebase provides the foundational building blocks for motion, including \SpringSimulation\ and \SpringMotionSpec\ for physics-based animations, \AnimationVector\ types (1D–4D) for animating arbitrary values, and \Easing\ curves like \CubicBezierEasing\. It also exposes \MotionTokens\ for standard durations and easing presets, as well as \MotionSchemes\ (Standard and Expressive) that define spring stiffness and damping ratios for spatial and effects motion, allowing developers to build WPF-friendly motion experiences using these Material 3-aligned specifications.

src/MaterialDesign3.Motion · high confidence

A new \MaterialDesignThemes.MahApps\ NuGet package has been added to bridge Material Design in XAML Toolkit with MahApps.Metro. This library provides \BundledTheme\ and \CustomColorTheme\ implementations that map Material Design primary/secondary colors to MahApps color resources, ensuring consistent theming across both frameworks. It includes attached properties (\FlyoutAssist\) to control MahApps Flyout headers, and XAML resource dictionaries that apply Material Design styles to MahApps controls such as \NumericUpDown\, \RangeSlider\, \TextBox\, \PasswordBox\, and dialog buttons.

src/MaterialDesignThemes.Wpf · high confidence

The library now includes a complete Material Design 3 theme alongside the existing Material Design 2. This adds new resource dictionaries for MD3-specific components such as the NavigationBar, NavigationDrawer, NavigationRail, Slider, and ToggleButton, along with a dedicated font resource (Noto). A new centralized color palette (\BaseThemeColors\) provides neutral, white, and black shades for consistent theming. Users can opt into the new design language by including \MaterialDesign3.Defaults.xaml\ in their application resources.

src/MaterialDesignThemes.Wpf/Themes · high confidence

The MahMaterialDragablzMashUp demo application has been added, providing a showcase for integrating Material Design in XAML, MahApps.Metro, and Dragablz. The app features a main window with a tabbed interface containing three sections: a Dialogs tab demonstrating MahApps dialogs styled with Material Design, a MahApps tab displaying various controls (ListBox, ToggleSwitch, Sliders, NumericUpDown, DataGrid) using the combined themes, and a PaletteSelector tab allowing users to dynamically change the application's primary/secondary colors and light/dark theme. It also includes a left-side flyout with Material Design TextBoxes and utilizes the ShowMeTheXAML library to display the XAML source of controls.

src/MahMaterialDragablzMashUp · high confidence

A new MaterialDesign3.Wpf demo application has been added, providing a complete showcase of the Material Design 3 component library for WPF. The app includes a full suite of demo pages for core controls such as Buttons, Cards, Chips, and a ColorTool, along with the necessary application infrastructure (App.xaml, App.config, and manifest) to run the demo. This serves as a visual reference and testing ground for the MaterialDesign3 theme and controls.

src/MaterialDesign3.Demo.Wpf · high confidence

A new web-based Palette Builder tool has been added to the src/web directory, allowing users to visually select and configure Material Design color swatches to generate ResourceDictionary files for XAML applications. The implementation includes the HTML interface, React-based JavaScript components (in both JSX and compiled script forms) for interactive hue and swatch selection, and a bundled copy of React v0.13.1 to power the UI.

src/web · high confidence

The Transitions folder now contains a complete set of new classes for content transitions, including the Transitioner control, TransitionerSlide, and TransitioningContent. This adds support for directional slide wipes (SlideWipe, SlideOutWipe) and circular wipe effects (CircleWipe), along with a system for opening effects (TransitionEffect) that can be applied to content upon loading or visibility changes. Users can now implement animated content switching with configurable directions, origins, and timing.

src/MaterialDesignThemes.Wpf/Transitions · high confidence

This change introduces several new behaviors and automation peers to enhance control functionality and accessibility. It adds TreeListViewAutomationPeer and TreeListViewItemAutomationPeer to provide proper UI Automation support for TreeListView controls, including expand/collapse pattern support. New behaviors are added for PasswordBox (PasswordBoxBehavior) and its reveal text box (PasswordBoxRevealTextBoxBehavior) to handle password visibility toggling and focus management correctly. Additionally, SmartHintBehavior is introduced to manage hint positioning updates, and TextBoxLineCountBehavior exposes the TextBox's line count as bindable attached properties, fixing issues with null references and unnecessary updates.

src/MaterialDesignThemes.Wpf/Behaviors · high confidence

The ColorManipulation namespace now includes a suite of new extension methods and helper types to improve color handling in WPF applications. Users can now calculate WCAG-compliant relative luminance and contrast ratios between colors, and automatically adjust foreground colors to meet specific contrast targets against a background. Additionally, the library adds support for converting between RGB, HSB, HSL, XYZ, and CIE Lab color spaces, enabling more advanced color transformations and lightness adjustments.

src/MaterialDesignColors.Wpf/ColorManipulation · high confidence

This change introduces several internal helper classes to support UI components. BindingProxy allows binding to non-dependency properties in XAML. ClearText provides a unified command to clear text in DatePicker, TimePicker, TextBox, ComboBox, RichTextBox, and PasswordBox. InternalTextFieldAssist helps manage mouse-over states for text field wrappers. PaddedBringIntoViewStackPanel adjusts scrolling behavior for TabControls to align with Material Design specifications. TreeListViewContentPresenter and TreeListViewItemsCollection add support for hierarchical data presentation in TreeListView controls. VisualStateMonitor enables waiting for specific visual states, improving reliability in DialogHost animations.

src/MaterialDesignThemes.Wpf/Internal · high confidence

The \src/MaterialDesignColors.Wpf/Recommended\ directory now includes dedicated swatch classes for the full Material Design palette, including Amber, Blue, BlueGrey, Brown, Cyan, DeepOrange, DeepPurple, Green, Grey, Indigo, LightBlue, LightGreen, Lime, Orange, Pink, Purple, Red, Teal, and Yellow. These new \ISwatch\ implementations provide structured access to primary, accent, and neutral tones, allowing WPF applications to easily integrate the recommended color system into their themes.

src/MaterialDesignColors.Wpf/Recommended · high confidence

The MaterialDesignToolkit.ResourceGeneration project has been restructured with new C\# source files (Brushes.cs, Icon.cs, IconDiff.cs, IconThing.cs, MdPalette.cs, PathHelper.cs) and supporting data files (Palette.json, MaterialColourSwatchesSnippet.xml, templates) to automate the generation of WPF theme resources, icon enums, and color swatches. This includes logic to parse color palettes into XAML dictionaries, update PackIconKind enums and data factories from external icon sources, and compare icon changes between NuGet versions, providing a centralized code-generation pipeline for the toolkit's visual assets.

src/MaterialDesignToolkit.ResourceGeneration · high confidence

The shared demo project now includes a set of new WPF value converters to support UI binding scenarios. These include BoolToTextWrappingConverter for toggling text wrapping, BooleanToDoubleConverter for mapping booleans to numeric values, BrushToHexConverter and ColorToBrushConverter for color manipulation, IsTransparentConverter for checking color transparency, MultiValueEqualityConverter for comparing multiple values, and StringJoinConverter for concatenating collections. These converters are now available for use within the MaterialDesignDemo.Shared namespace.

src/MaterialDesignDemo.Shared/Converters · high confidence

The Material Design 3 color utilities have been ported to .NET, introducing new C\# implementations for core color logic. This includes the \ContrastCurve\ record for calculating contrast levels and the \Scheme\ record for generating light and dark theme palettes (including content-based schemes) from a source ARGB color, enabling dynamic color scheme generation within the application.

MaterialDesign3.MaterialColorUtilities · high confidence

The MaterialColorUtilities library has been ported to .NET, introducing a comprehensive dynamic color system that generates palettes based on a source color. This includes support for the 2021 and 2025 Material Design color specifications, allowing applications to automatically derive primary, secondary, tertiary, and surface colors that adapt to light/dark modes and contrast levels. The update adds utilities for color blending (HCT and CAM16 spaces), contrast ratio calculations for accessibility, and analysis of universally disliked colors to ensure aesthetic quality.

src/MaterialDesign3.MaterialColorUtilities · high confidence

The repository has been restructured to use a centralized build configuration via a new Directory.Build.props file, which sets the C\# language version to 14.0, enables nullable reference types, and configures common package metadata. The project now targets .NET 10, as specified in the new global.json file (SDK version 10.0.301). Additionally, a new MaterialDesignToolkit.Full.slnx solution file organizes the source, demo, and test projects, while a comprehensive .editorconfig standardizes code formatting and naming conventions across the codebase.

(repo-wide) · high confidence

To support building on .NET Framework 4.6.2, new shim files have been added to the project. IsExternalInit.cs provides a dummy class required to compile C\# records on this older framework version, while MathCompat.cs implements a Cbrt (cube root) method to replace the missing System.Math.Cbrt function available in newer .NET versions.

src/Shims · high confidence

The MainDemo.Wpf project now includes standard WPF property files (AssemblyInfo, Resources, Settings) and a launchSettings.json profile. AssemblyInfo configures COM visibility and theme resource locations, while launchSettings.json defines a default startup profile that passes command-line arguments to the demo application.

src/MainDemo.Wpf/Properties · high confidence

The CircularProgressBar control now uses a set of new, dedicated value converters (ArcEndPointConverter, ArcSizeConverter, RotateTransformCentreConverter, and StartPointConverter) to handle the complex geometry required for drawing the progress arc. This change specifically addresses a rendering bug where a full circle (100% progress) would fail to draw because the start and end points of a single arc coincide; the new logic splits the drawing into two arcs to ensure the full circle is visible. Additionally, the previous StartPointConverter has been marked as obsolete to support this new structure.

src/MaterialDesignThemes.Wpf/Converters/CircularProgressBar · high confidence

The converter library has been completely reorganized to improve maintainability and flexibility. A new generic BooleanConverter base class now powers several standard converters (BooleanToVisibilityConverter, InvertBooleanConverter), reducing code duplication. SmartHint positioning logic has been significantly enhanced with dedicated converters (FloatingHintInitialVerticalOffsetConverter, FloatingHintClippingGridConverter) to correctly handle multi-line text and scaling, while the EqualityToVisibilityConverter now supports configurable visibility values. Additionally, new converters have been introduced for specific use cases, including BooleanAllConverter, BorderClipConverter, and EllipseClipConverter.

src/MaterialDesignThemes.Wpf/Converters · high confidence

The domain layer of the WPF demo application has been refactored to use the CommunityToolkit.Mvvm source generators. View models such as DialogsViewModel, FieldsViewModel, and MainWindowViewModel now inherit from ObservableObject and utilize \[ObservableProperty\] and \[RelayCommand\] attributes, replacing the previous manual INotifyPropertyChanged and ICommand implementations. This change modernizes the demo's codebase, simplifying the implementation of data binding and command logic for users studying the toolkit's usage patterns.

src/MainDemo.Wpf/Domain · high confidence

The demo application's view models and supporting infrastructure have been moved to the shared \MaterialDesignDemo.Shared.Domain\ project. This includes new implementations for buttons, color tools, combo boxes, pickers, tooltips, and typography, along with a shared command implementation and view model base class, enabling consistent demo behavior across different project targets.

src/MaterialDesignDemo.Shared/Domain · high confidence

The assembly now exposes a new XML namespace (\http://materialdesigninxaml.net/winfx/xaml/themes-internal\) mapped to the prefix \materialDesignInternal\. This allows XAML consumers to reference types located in the \MaterialDesignThemes.Wpf.Internal\, \MaterialDesignThemes.Wpf.Converters.Internal\, and \MaterialDesignThemes.Wpf.Behaviors.Internal\ namespaces, facilitating the use of internal components in XAML markup.

src/MaterialDesignThemes.Wpf/Properties · high confidence

The WPF demo application has been reorganized into a new project structure, moving shared view models and resources into a separate shared assembly. The application manifest and configuration now target .NET Framework 4.7.2 and include DPI awareness settings for better display on high-DPI monitors. The demo interface has been updated to showcase the latest Material Design controls, including new button styles, card layouts, chip components, and a color tool, while also fixing visual issues like white edges on cards and ensuring proper dark mode support.

src/MainDemo.Wpf · high confidence

The build process now includes several new PowerShell scripts to support development and release workflows. ApplyXamlStyler.ps1 automates XAML code formatting using the local dotnet tool. MigrateBrushes.ps1 and MigrateStyles.ps1 provide automated refactoring tools to update XAML resource references, migrating legacy brush and style names to the new MaterialDesign.Brush and Secondary naming conventions. BuildNugets.ps1 and UpdateNugets.ps1 streamline the creation of NuGet packages and the modification of their dependency versions, while GenerateThemesWikiMarkdown.ps1 automates the generation of documentation for available themes.

build · high confidence

Added two new internal behaviors to improve UI consistency and usability. TabControlHeaderScrollBehavior enables opt-in navigation panel support and custom header content for TabControls, aligning scrolling behavior with Material Design specifications. TextBoxHorizontalScrollBarBehavior fixes horizontal scrollbar placement for multi-line TextBox controls by synchronizing a custom scrollbar with the underlying ScrollViewer, ensuring proper visibility and value updates.

src/MaterialDesignThemes.Wpf/Behaviors/Internal · high confidence

This change introduces a suite of new internal value converters in the MaterialDesignThemes.Wpf library to support refined UI behaviors. These include converters for tab control navigation panel visibility and margins, horizontal scrollbar placement in multi-line text boxes, and floating hint alignment animations. Additional converters handle dialog background blurring, slider tooltip formatting and label positioning, grid view column detection, and clear button visibility in text fields. An automation properties converter ensures correct accessibility names for hints. These components collectively improve layout precision, accessibility compliance, and visual polish for specific control states.

src/MaterialDesignThemes.Wpf/Converters/Internal · high confidence

The WPF color library has been restructured to introduce new core types including ColorPair, Hue, Swatch, and ISwatch, which replace the previous resource-based model with a programmatic API for defining and accessing color swatches. This change also updates the supported target frameworks to .NET Framework 4.6.2 and .NET 8.0, dropping support for .NET 6 and .NET 7, and includes a new NuGet specification to embed the package icon.

src/MaterialDesignColors.Wpf · high confidence

The WPF theme files in the Themes directory have been restructured to include explicit foreground color definitions (e.g., \AmberPrimary50Foreground\) for every primary and secondary shade. Previously, these resources likely relied on implicit contrast logic or lacked dedicated foreground keys; now, each color shade has a corresponding foreground resource (typically black or white with alpha transparency) to ensure consistent text readability. This change affects all color palettes (Amber, Blue, BlueGrey, Brown, Cyan, DeepOrange, DeepPurple, etc.) and provides developers with direct access to pre-calculated foreground colors for better control over UI contrast.

src/MaterialDesignColors.Wpf/Themes · high confidence

Added unit tests for MaterialColorUtilities color conversions and scheme generation; Added unit tests for TreeListViewItemsCollection and test assembly metadata; Added unit tests for WPF value converters; Added unit tests for color swatch and contrast logic; Expanded UI test coverage for controls and samples; Expanded unit test coverage for WPF controls and utilities.

The project has upgraded its target framework to .NET 10 (net10.0-windows) across core libraries and demo applications, replacing previous .NET 8 and .NET 6 targets. To support this, the solution now uses Central Package Management (CPM) via a new Directory.packages.props file, which centralizes dependency versions for packages such as CommunityToolkit.Mvvm (8.4.2), MahApps.Metro (2.4.11), and the Microsoft.CodeAnalysis suite (5.3.0). Additionally, the test infrastructure has been migrated from xUnit to TUnit (1.53.0) for unit and UI tests.

(dependencies) · high confidence

Written by watchdog.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.

• CAI 52 → 59 (+6.7)
• Rubric changed (rubric-2026.08.19 → rubric-2026.09.15) — scores are not directly comparable.

• Code Health 68 → 59 (-9.7)
• Architecture 98 → 98 (+0.1)
• Maturity 54 → 56 (+2.6)
• Readiness 60 → 60 (-0.1)
• Security 42 → 56 (+13.8)
• Domain Modelling 96 (new)
• Performance 70 → 70 (+0.0)

• Bounded contexts not declared
• Build status unknown
• Concentrated knowledge decay
• Duplicated block (10 lines × 2) (src/MaterialDesign3.MaterialColorUtilities/DynamicColor/ColorSpec2021.cs)
• Duplicated block (10 lines × 2) (src/MaterialDesign3.MaterialColorUtilities/DynamicColor/ColorSpec2021.cs)
• Duplicated block (10 lines × 2) (src/MaterialDesignThemes.Wpf/Converters/BorderClipConverter.cs)
• Duplicated block (11 lines × 2) (src/MainDemo.Wpf/Dialogs.xaml.cs)
• Duplicated block (11 lines × 2) (src/MainDemo.Wpf/Dialogs.xaml.cs)
• Duplicated block (11 lines × 2) (src/MainDemo.Wpf/Domain/IconPackViewModel.cs)
• Duplicated block (11 lines × 2) (src/MaterialDesign3.MaterialColorUtilities/Scheme/Scheme.cs)
• Duplicated block (11 lines × 2) (src/MaterialDesign3.MaterialColorUtilities/Scheme/Scheme.cs)
• Duplicated block (11 lines × 2) (src/MaterialDesignThemes.Wpf/Transitions/SlideWipe.cs)
• Duplicated block (12 lines × 2) (src/MainDemo.Wpf/Domain/IconPackViewModel.cs)
• Duplicated block (12 lines × 2) (src/MainDemo.Wpf/FieldsLineUp.xaml.cs)
• Duplicated block (12 lines × 2) (src/MaterialDesign3.MaterialColorUtilities/Contrast/Contrast.cs)
• Duplicated block (12 lines × 2) (src/MaterialDesignThemes.Wpf/RatingBar.cs)
• Duplicated block (13 lines × 2) (src/MainDemo.Wpf/Domain/ThemeSettingsViewModel.cs)
• Duplicated block (13 lines × 2) (src/MaterialDesignThemes.Wpf/ResourceDictionaryExtensions.cs)
• Duplicated block (14 lines × 2) (src/MainDemo.Wpf/Domain/DialogsViewModel.cs)
• Duplicated block (14 lines × 2) (src/MainDemo.Wpf/Pickers.xaml.cs)
• …and 62 more

• ColorSpec2025.OnSurface.get (cognitive 27) (src/MaterialDesign3.MaterialColorUtilities/DynamicColor/ColorSpec2025.cs)
• ColorSpec2025.OnSurfaceVariant.get (cognitive 21) (src/MaterialDesign3.MaterialColorUtilities/DynamicColor/ColorSpec2025.cs)
• ColorSpec2025.Outline.get (cognitive 19) (src/MaterialDesign3.MaterialColorUtilities/DynamicColor/ColorSpec2025.cs)
• ColorSpec2025.OutlineVariant.get (cognitive 19) (src/MaterialDesign3.MaterialColorUtilities/DynamicColor/ColorSpec2025.cs)
• ColorSpec2025.Primary.get (cognitive 27) (src/MaterialDesign3.MaterialColorUtilities/DynamicColor/ColorSpec2025.cs)
• ColorSpec2025.PrimaryContainer.get (cognitive 22) (src/MaterialDesign3.MaterialColorUtilities/DynamicColor/ColorSpec2025.cs)
• ColorSpec2025.PrimaryContainer.get (cyclomatic 16) (src/MaterialDesign3.MaterialColorUtilities/DynamicColor/ColorSpec2025.cs)
• ColorSpec2025.SurfaceContainer.get (cognitive 19) (src/MaterialDesign3.MaterialColorUtilities/DynamicColor/ColorSpec2025.cs)
• ColorSpec2025.SurfaceContainerHigh.get (cognitive 19) (src/MaterialDesign3.MaterialColorUtilities/DynamicColor/ColorSpec2025.cs)
• ColorSpec2025.SurfaceContainerLow.get (cognitive 19) (src/MaterialDesign3.MaterialColorUtilities/DynamicColor/ColorSpec2025.cs)
• ColorSpec2025.Tertiary.get (cognitive 18) (src/MaterialDesign3.MaterialColorUtilities/DynamicColor/ColorSpec2025.cs)
• ColorSpec2025.TertiaryContainer.get (cognitive 31) (src/MaterialDesign3.MaterialColorUtilities/DynamicColor/ColorSpec2025.cs)
• ColorSpec2025.TertiaryContainer.get (cyclomatic 16) (src/MaterialDesign3.MaterialColorUtilities/DynamicColor/ColorSpec2025.cs)
• CommentedOutCode (src/MaterialDesignThemes.Wpf/DataGridComboBoxColumn.cs)
• CommentedOutCode (src/MaterialDesignThemes.Wpf/TreeHelper.cs)
• Documentation: no installation or build instructions (README.md)
• Duplicated block (10 lines × 2) (src/MainDemo.Wpf/Domain/ThemeSettingsViewModel.cs)
• Duplicated block (10 lines × 2) (src/MainDemo.Wpf/Domain/ThemeSettingsViewModel.cs)
• Duplicated block (10 lines × 2) (src/MainDemo.Wpf/Domain/ThemeSettingsViewModel.cs)
• Duplicated block (11 lines × 2) (src/MainDemo.Wpf/Domain/FutureDateValidationRule.cs)
• …and 153 more

• 13 commits — 8 feature/other, 5 fixes

• src/MaterialDesignThemes.Wpf — 8 commits
• .github/workflows — 2 commits
• src/MahMaterialDragablzMashUp — 1 commit
• src/MainDemo.Wpf — 1 commit
• src/MaterialDesignDemo.Shared — 1 commit

• fix: Fix nightly release workflow previous run detection (#4089)
• fix: fix(DataGrid): Center DataGridCell-Content by default (#4087)
• fix: fix(DialogHost): Improve reliability of visual state monitoring (#4088)
• fix: fix(combobox): allow dropdown toggle when clicking prefix or suffix text (#4091)
• fix: fix(popupbox): close popup when toggle button is clicked while open (#4082)
• change: Adds ComboBox dropdown background brush (#4059)
• change: Allow for waiting for DialogHost animations. (#4083)
• change: Allow triple left click on a TextBox to select all text (#4081)
• change: Bump MaterialDesignXAML base versions to 5.4.0
• change: Remove explicit Win32 SetFocus call when opening DialogHost (#4078)
• change: Two things I have to write before I specify what I did: (#4085)
• change: [bot] Pack Icon update (#4084)
• change: docs: add DialogHost.WaitFor* example (#4092)

• Unchanged — 1 containers · 1 contexts · 0 edges

Written by watchdog.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.

MaterialDesignInXAML/MaterialDesignInXamlToolkit was measured the same way every project in this corpus was: the same rubric, at a pinned commit, with the result published in full. Point a surveyor at a repository you know and see whether you agree with it.