Troubleshooting
Find help diagnosing and resolving common issues when building Avalonia apps. Whether you've run into installation problems, performance bottlenecks, or challenges with styles and theming, you'll find targeted guidance on these pages to get your app back on track.
General
Common issues encountered when setting up .NET and Avalonia.
Steps to improve the runtime performance of your Avalonia app.
Controls
How to replicate GroupBox functionality using HeaderedContentControl with custom styling.
Common issues with the Avalonia Accelerate MediaPlayer control.
Options for displaying message dialogs, including third-party alternatives.
Platform-specific issues
Issues specific to macOS, including app menus and system integration.
Issues specific to Windows, including packaging, signing, and SmartScreen warnings.
Tools
Common issues when using Avalonia DevTools to inspect and debug your app.
UI development
Common issues with style selectors, including silent failures and unmatched targets.
Common issues with control themes, including theme lookup and unintended side effects.
XPF
Issues when using Avalonia XPF for WPF compatibility.
Have questions or feedback? Join the conversation below.