WinUI to Avalonia
Start with:
../../references/65-winui-to-avalonia-modern-ui-conversion-index.md
../../references/winui-to-avalonia/README.md
Prioritize the chapters that match the source app:
- object or property system, bindings, resources, and state mapping
NavigationView, dialog, titlebar, and multi-window shell behavior
- composition, rendering, scroll, gesture, and advanced control migration
- platform services, activation, storage, notifications, and WebView boundaries
Workflow
- Identify the WinUI shell and state model before moving individual controls.
- Translate
ThemeResource, VisualStateManager, and composition assumptions explicitly.
- Rebuild platform integration through Avalonia services rather than Windows-only primitives.
- Keep modern-shell decisions intentional instead of chasing one-to-one surface parity.
Rules
- Do not treat
NavigationView, ContentDialog, or AppWindow as direct API renames.
- Separate composition effects from essential interaction behavior.
- Make Windows-specific contracts and Avalonia cross-platform replacements explicit.