winui3-migration-guide

Installation
Summary

Complete reference for migrating UWP apps to WinUI 3 with before/after code examples.

  • Maps all namespace changes from Windows.UI.Xaml.* to Microsoft.UI.Xaml.*, plus threading, windowing, and dialog APIs
  • Covers the three most common Copilot mistakes: ContentDialog without XamlRoot, MessageDialog usage, and CoreDispatcher patterns
  • Includes migration tables for window management, pickers, background tasks, settings, and GetForCurrentView() replacements
  • Provides a 15-item migration checklist and guidance on updating unit test projects to WinUI 3 test templates with [UITestMethod] attributes
SKILL.md

WinUI 3 Migration Guide

Use this skill when migrating UWP apps to WinUI 3 / Windows App SDK, or when verifying that generated code uses correct WinUI 3 APIs instead of legacy UWP patterns.


Namespace Changes

All Windows.UI.Xaml.* namespaces move to Microsoft.UI.Xaml.*:

UWP Namespace WinUI 3 Namespace
Windows.UI.Xaml Microsoft.UI.Xaml
Windows.UI.Xaml.Controls Microsoft.UI.Xaml.Controls
Windows.UI.Xaml.Media Microsoft.UI.Xaml.Media
Windows.UI.Xaml.Input Microsoft.UI.Xaml.Input
Windows.UI.Xaml.Data Microsoft.UI.Xaml.Data
Windows.UI.Xaml.Navigation Microsoft.UI.Xaml.Navigation
Windows.UI.Xaml.Shapes Microsoft.UI.Xaml.Shapes
Related skills

More from github/awesome-copilot

Installs
5.4K
GitHub Stars
32.8K
First Seen
Mar 3, 2026