ModernWpf

<h1 align="center">ModernWPF</h1>

<p align="center">
  Modern Fluent styles and WinUI-inspired controls for Windows Presentation Foundation.
</p>

<p align="center">
  <a href="https://github.com/Kinnara/ModernWpf/actions/workflows/build.yml">
    <img src="https://github.com/Kinnara/ModernWpf/actions/workflows/build.yml/badge.svg?branch=master" alt="Build status">
  </a>
  <a href="https://www.nuget.org/packages/ModernWpfUI">
    <img src="https://img.shields.io/nuget/vpre/ModernWpfUI?label=NuGet&amp;color=004880&amp;logo=nuget&amp;logoColor=white" alt="Latest ModernWpfUI package version">
  </a>
  <a href="LICENSE">
    <img src="https://img.shields.io/badge/license-MIT-green.svg" alt="MIT license">
  </a>
</p>

<p align="center">
  <a href="#getting-started">Get started</a>
  <span> · </span>
  <a href="#gallery">Gallery</a>
  <span> · </span>
  <a href="#documentation">Documentation</a>
  <span> · </span>
  <a href="https://github.com/Kinnara/ModernWpf/discussions">Discussions</a>
</p>

ModernWPF is an independent, community-maintained library that brings Fluent
styling and modern controls to
[Windows Presentation Foundation](https://github.com/dotnet/wpf) 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`.

<picture>
  <source media="(prefers-color-scheme: dark)" srcset="docs/images/Gallery.Dark.png">
  <source media="(prefers-color-scheme: light)" srcset="docs/images/Gallery.Light.png">
  <img
    alt="ModernWPF Gallery home screen showing controls, samples, and navigation"
    src="docs/images/Gallery.Light.png">
</picture>

## 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](https://github.com/dotnet/wpf) | Build directly on WPF and preserve WPF behavior. |
| Stock control styling | Official WPF Fluent resources | Use the platform Fluent theme on .NET