README

ModernWPF


  Modern Fluent styles and WinUI-inspired controls for Windows Presentation Foundation.



  
    
  
  
    
  
  
    
  



  Get started
   · 
  Gallery
   · 
  Documentation
   · 
  Discussions


ModernWPF is an independent, community-maintained library that brings Fluent
styling and modern controls to
Windows Presentation Foundation applications.
It runs directly on WPF; it is not WinUI and does not replace the WPF runtime.

 [!IMPORTANT]
 ModernWPF 1.x is the active preview line. The 0.9.x line is frozen and
 unsupported. No maintenance updates, security fixes, or new 0.9.x releases
 are planned.

 [!NOTE]
 ModernWPF is the product and display name. The repository and CLR
 namespaces continue to use ModernWpf, and the NuGet package remains
 ModernWpfUI.


  
  
  


 What ModernWPF provides

- Fluent styling for stock WPF controls, including Light, Dark, High Contrast,
  and compact-resource behavior.
- WPF ports of modern controls such as NavigationView, NumberBox,
  ContentDialog, InfoBar, CommandBarFlyout, and ItemsRepeater.
- Application, window, and element-level theme APIs with a consistent surface
  across every supported target.
- Modern window chrome, title-bar integration, layout helpers, and resource
  primitives for existing WPF applications.
- Source-backed compatibility audits and automated API, resource, theme,
  accessibility, package, and runtime tests.

 Relationship to WPF and WinUI

ModernWPF follows both upstream UI projects, but each has a different role:

| Area | Upstream authority | ModernWPF strategy |
| --- | --- | --- |
| WPF runtime, XAML, layout, and input | dotnet/wpf | Build directly on WPF and preserve WPF behavior. |
| Stock control styling | Official WPF Fluent resources | Use the platform Fluent theme on .NET 10 and a compatible ModernWPF backport on older supported targets. |
| Additional modern controls | microsoft-ui-xaml | Port current WinUI control APIs and behavior where WPF has no equivalent, documenting necessary WPF adaptations. |

ModernWPF is not affiliated with or endorsed by Microsoft.

 Project status

| Line | Status | Policy |
| --- | --- | --- |
| 1.x | Active preview | Current development line. 1.0.0-preview.1 records the first API/resource audit and migration baseline; the 1.0 roadmap carries source-audited feature previews through an API-frozen release candidate before stable 1.0.0 establishes the SemVer boundary. |
| 0.9.x | Frozen and unsupported | Historical packages remain available, but no updates or security fixes are planned. |

Source and binary compatibility with 0.9.x is not promised. Existing
applications should follow the
0.9.x migration guide, which covers target
framework changes, resource entries, renamed APIs, and the removal of the
MahApps adapter from 1.x.

 Supported targets

| Target framework | Stock control theme | Intended use |
| --- | --- | --- |
| net462 | ModernWPF Fluent backport | Existing .NET Framework WPF applications. |
| net8.0-windows7.0