SerinaNya/KLALB
1
1
Fork 0
forked from KNEMC/KLALB
Code Pull Requests Activity

add ui-ux-pro-max skill for javafx design

Browse Source
This commit is contained in:
SerinaNya
2026-08-27 23:29:27 +08:00
parent c3172a04b1
commit c907e52478
172 changed files with 88283 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files
.agents/skills/ui-ux-pro-max/data/stacks/uno.csv
+60
View File
@@ -0,0 +1,60 @@
No,Category,Guideline,Description,Do,Don't,Code Good,Code Bad,Severity,Docs URL,Applies To,Status,Verified At
1,XAML,Use WinUI XAML API surface,Uno implements the WinUI API across platforms,Microsoft.UI.Xaml namespace for all UI code,WPF or Xamarin.Forms namespaces,using Microsoft.UI.Xaml.Controls;,using System.Windows.Controls; or using Xamarin.Forms;,High,https://platform.uno/docs/articles/implemented-views.html,uno current Uno.Sdk/Uno.WinUI,active,2026-08-13
2,XAML,Check API implementation status,Not all WinUI APIs are implemented on every platform,Uno API compatibility docs before using new APIs,Assuming all WinUI APIs work everywhere,Check platform.uno/docs for API status,Using unimplemented API and discovering at runtime,High,https://platform.uno/docs/articles/implemented-views.html,uno current Uno.Sdk/Uno.WinUI,active,2026-08-13
3,XAML,Use Uno.WinUI not Uno.UI for new projects,Uno.WinUI uses WinUI 3 APIs,Uno.WinUI NuGet packages for new projects,Uno.UI (UWP API surface) for new projects,"<Project Sdk=""Uno.Sdk""> (Uno.WinUI / WinUI 3 surface implicit)","<PackageReference Include=""Uno.UI""/> (legacy UWP API surface)",Medium,https://platform.uno/docs/articles/updating-to-winui3.html,uno current Uno.Sdk/Uno.WinUI,active,2026-08-13
4,XAML,Use XAML Hot Reload,Speed up development with live XAML editing,Hot Reload for iterating on layouts,Restarting app for every XAML change,Click Hot Reload button in VS toolbar or save in VS Code/Rider to apply XAML changes,Full rebuild for margin tweak,Medium,https://platform.uno/docs/articles/features/working-with-xaml-hot-reload.html,uno current Uno.Sdk/Uno.WinUI,active,2026-08-13
5,Conditional,Use platform-specific XAML,Conditional namespaces for platform-specific UI,xmlns:android xmlns:ios xmlns:wasm for platform XAML,Shared XAML when platforms need different controls,"<TextBlock android:Text=""Android"" ios:Text=""iOS"" Text=""Default""/>",#if in code-behind to set text per platform,Medium,https://platform.uno/docs/articles/platform-specific-xaml.html,uno current Uno.Sdk/Uno.WinUI,active,2026-08-13
6,Conditional,Use partial classes for platform code,Separate platform implementations in partial files,Partial class files with platform-specific logic,#if directives in shared code for large blocks,MainPage.iOS.cs MainPage.Android.cs partial class files,#if __IOS__ ... #elif __ANDROID__ ... 100-line blocks in shared file,Medium,https://platform.uno/docs/articles/platform-specific-csharp.html,uno current Uno.Sdk/Uno.WinUI,active,2026-08-13
7,Conditional,Use preprocessor symbols correctly,Target correct platforms with defines,__IOS__ __ANDROID__ __WASM__ __DESKTOP__ for platform checks,Inventing custom symbols or checking OS at runtime,#if __ANDROID__ Android-specific code #endif,if (RuntimeInformation.IsOSPlatform(OSPlatform.Android)) for compile-time choice,Medium,https://platform.uno/docs/articles/platform-specific-csharp.html,uno current Uno.Sdk/Uno.WinUI,active,2026-08-13
8,Conditional,Minimize platform-specific code,Keep shared code maximized,Abstract platform differences behind interfaces,Duplicating logic across platform files,IDeviceService with per-platform implementation,Same 50 lines copy-pasted into iOS and Android partial classes,High,https://platform.uno/docs/articles/platform-specific-csharp.html,uno current Uno.Sdk/Uno.WinUI,active,2026-08-13
9,Navigation,Use Frame-based navigation,Standard WinUI navigation pattern,Frame.Navigate with page types,Manual content swapping,"rootFrame.Navigate(typeof(DetailPage), parameter);",contentPresenter.Content = new DetailPage();,Medium,https://platform.uno/docs/articles/guides/native-frame-nav-tutorial.html,uno current Uno.Sdk/Uno.WinUI,active,2026-08-13
10,Navigation,Use Uno.Extensions.Navigation,Type-safe navigation with DI integration,Uno.Extensions navigation for complex apps,Manual Frame management in large apps,"navigator.NavigateViewModelAsync<DetailViewModel>(this, data: item);",Frame.Navigate with string parsing everywhere,Medium,https://platform.uno/docs/articles/external/uno.extensions/doc/Overview/Navigation/NavigationOverview.html,uno current Uno.Sdk/Uno.WinUI,active,2026-08-13
11,Navigation,Handle platform back navigation,SystemNavigationManager.BackRequested works on Android iOS and WASM but is unimplemented on WinAppSDK desktop where calling GetForCurrentView() throws at runtime,Subscribe to BackRequested only on platforms that support it or use Uno.Toolkit NavigationBar for cross-platform back UX,Calling SystemNavigationManager.GetForCurrentView() on WinUI 3 desktop without a guard,#if __ANDROID__ || __IOS__ || __WASM__ SystemNavigationManager.GetForCurrentView().BackRequested += OnBackRequested; #endif,SystemNavigationManager.GetForCurrentView().BackRequested += OnBackRequested; with no platform guard — crashes on Windows desktop,High,https://platform.uno/docs/articles/guides/native-frame-nav-tutorial.html,uno current Uno.Sdk/Uno.WinUI,active,2026-08-13
12,Navigation,Use deep linking,Support URI activation across platforms,Handle protocol activation and URI routing,Single entry point ignoring activation,Route URIs to specific pages on activation,Ignoring OnLaunched activation args,Medium,https://platform.uno/docs/articles/features/protocol-activation.html,uno current Uno.Sdk/Uno.WinUI,active,2026-08-13
13,Renderers,Understand Skia vs native rendering,Uno offers both rendering approaches,Skia for pixel-perfect cross-platform consistency,Assuming native rendering on all platforms,<TargetFrameworks>net10.0-desktop;net10.0-browserwasm</TargetFrameworks> uses unified Skia Desktop shell,Expecting platform-native controls on Skia targets,High,https://platform.uno/docs/articles/features/using-skia-desktop.html,uno current Uno.Sdk/Uno.WinUI,active,2026-08-13
14,Renderers,Use unified net10.0-desktop target,Uno 5.2+ ships a single Skia Desktop shell that auto-selects X11 Win32 or AppKit per OS — Skia.Gtk Skia.Linux.Framebuffer and Skia.WPF heads are deprecated,net10.0-desktop TFM with UnoPlatformHostBuilder for cross-platform desktop,Targeting the legacy Skia.Gtk or Skia.Linux.Framebuffer heads in new projects,<TargetFrameworks>net10.0-desktop</TargetFrameworks> in the Uno.Sdk single project,Per-OS Skia.Gtk Skia.MacOS Skia.Linux.Framebuffer head projects,Medium,https://platform.uno/docs/articles/features/using-skia-desktop.html,uno current Uno.Sdk/Uno.WinUI,active,2026-08-13
15,Renderers,Test rendering on each target,Visual differences exist between renderers,Visual testing on each active target platform,Testing only on Windows assuming others match,Screenshot tests on iOS Android WASM and Desktop,Testing only on Windows Desktop,High,https://platform.uno/docs/articles/external/uno.uitest/doc/using-uno-uitest.html,uno current Uno.Sdk/Uno.WinUI,active,2026-08-13
16,Renderers,Use platform-native features when needed,Access native APIs through Uno abstractions,Native platform APIs via platform-specific code,Avoiding native features for purity,#if __IOS__ UIKit API call #endif for camera access,Pure shared code that avoids using the camera,Medium,https://platform.uno/docs/articles/platform-specific-csharp.html,uno current Uno.Sdk/Uno.WinUI,active,2026-08-13
17,Performance,Optimize WASM bundle size,WebAssembly downloads can be large,IL linker and AOT for smaller WASM bundles,Default settings for production WASM,<WasmShellILLinkerEnabled>true</WasmShellILLinkerEnabled>,Publishing WASM without linker,High,https://platform.uno/docs/articles/features/using-il-linker-webassembly.html,uno current Uno.Sdk/Uno.WinUI,active,2026-08-13
18,Performance,Use x:Load for deferred XAML,Defer element creation until needed,x:Load=False for hidden panels and tabs,Loading all UI elements upfront,"<StackPanel x:Load=""{x:Bind ShowAdvanced}"">",Always-loaded Collapsed panels,Medium,https://platform.uno/docs/articles/features/windows-ui-xaml-xbind.html,uno current Uno.Sdk/Uno.WinUI,active,2026-08-13
19,Data Binding,Use x:Bind for compiled bindings,Compiled bindings eliminate runtime reflection — Uno supports x:Bind across iOS Android WASM Skia and Windows targets that compile XAML so prefer it over {Binding} for static well-typed bindings,x:Bind for property and event bindings; reserve {Binding} for runtime-typed DataContext scenarios,{Binding} everywhere when x:Bind would compile,"<TextBlock Text=""{x:Bind ViewModel.Title, Mode=OneWay}""/>","<TextBlock Text=""{Binding Title}""/> for a statically known property",High,https://platform.uno/docs/articles/features/windows-ui-xaml-xbind.html,uno current Uno.Sdk/Uno.WinUI,active,2026-08-13
20,Performance,Profile per platform,Performance characteristics vary by target,Platform-specific profiling tools,Assuming desktop perf equals mobile,Instruments on iOS and Android Profiler on Android,Profiling only on Windows,Medium,https://platform.uno/docs/articles/guides/profiling-applications.html,uno current Uno.Sdk/Uno.WinUI,active,2026-08-13
21,Styling,Use WinUI theme resources,Consistent theming across platforms,ThemeResource for adaptive colors,Hardcoded colors per platform,"Background=""{ThemeResource ApplicationPageBackgroundThemeBrush}""","Background=""#FFFFFF""",High,https://platform.uno/docs/articles/features/working-with-themes.html,uno current Uno.Sdk/Uno.WinUI,active,2026-08-13
22,Styling,Support light and dark themes,Application.RequestedTheme accepts only ApplicationTheme.Light/Dark — to follow the system theme leave it unset entirely. ElementTheme.Default exists only on FrameworkElement.RequestedTheme not on Application,Omit Application.RequestedTheme so the OS theme wins; set Light or Dark explicitly only after a user chooses an override,"Setting Application.RequestedTheme=""Default"" — not a valid ApplicationTheme value and throws at parse time",<Application></Application> with RequestedTheme unset,"<Application RequestedTheme=""Default""> // not a valid ApplicationTheme",Medium,https://platform.uno/docs/articles/features/working-with-themes.html,uno current Uno.Sdk/Uno.WinUI,active,2026-08-13
23,Styling,Use Lightweight Styling,Override control sub-properties via resources,Lightweight styling keys for minor tweaks,Full ControlTemplate for small changes,"<Button><Button.Resources><StaticResource x:Key=""ButtonBackground"" ResourceKey=""AccentBrush""/></Button.Resources></Button>",Copying entire ControlTemplate to change one color,Medium,https://platform.uno/docs/articles/external/uno.themes/doc/lightweight-styling.html,uno current Uno.Sdk/Uno.WinUI,active,2026-08-13
24,Styling,Test themes on each platform,Theme rendering differs across platforms,Visual theme testing on all targets,Assuming themes look identical everywhere,Screenshot comparison across platforms for themed controls,Theming only tested on Windows,Low,https://platform.uno/docs/articles/features/working-with-themes.html,uno current Uno.Sdk/Uno.WinUI,active,2026-08-13
25,Architecture,Use MVVM pattern,Separate view and logic,CommunityToolkit.Mvvm or Prism for MVVM,Code-behind for business logic,[ObservableProperty] public partial string Title { get; set; } [RelayCommand] private void Save() { },MainPage.xaml.cs with all logic,High,https://platform.uno/docs/articles/external/workshops/simple-calc/modules/MVVM-XAML/04-App%20Architecture/README.html,uno current Uno.Sdk/Uno.WinUI,active,2026-08-13
26,Architecture,Use Uno.Extensions,Official extension libraries for common patterns,Uno.Extensions for DI navigation configuration,Building infrastructure from scratch,Host.CreateDefaultBuilder().UseNavigation().UseConfiguration(),Manual DI and navigation setup,Medium,https://platform.uno/docs/articles/external/uno.extensions/doc/ExtensionsOverview.html,uno current Uno.Sdk/Uno.WinUI,active,2026-08-13
27,Architecture,Use dependency injection,Register services for testability,Microsoft.Extensions.DI through Uno.Extensions,Static service locators and singletons,"services.AddSingleton<IApiService, ApiService>();",ApiService.Instance or new ApiService() in ViewModels,Medium,https://platform.uno/docs/articles/external/uno.extensions/doc/Learn/DependencyInjection/DependencyInjectionOverview.html,uno current Uno.Sdk/Uno.WinUI,active,2026-08-13
28,Architecture,Share code via class libraries,Maximize code reuse across targets,Business logic in .NET Standard or shared library,Business logic in platform head projects,MyApp.Core class library referenced by all heads,Business logic in MyApp.Wasm.csproj,Medium,https://platform.uno/docs/articles/cross-targeted-libraries.html,uno current Uno.Sdk/Uno.WinUI,active,2026-08-13
29,Architecture,Use Uno.Resizetizer for assets,Single source SVG to multi-platform assets,UnoImage for automatic asset generation from SVG,Manual asset export per resolution and platform,"<UnoImage Include=""Assets/icon.svg"" BaseSize=""24,24""/>",Manually exporting icon_1x.png icon_2x.png icon_3x.png per platform,Medium,https://platform.uno/docs/articles/external/uno.resizetizer/doc/using-uno-resizetizer.html,uno current Uno.Sdk/Uno.WinUI,active,2026-08-13
30,Accessibility,Set AutomationProperties,Enable screen readers across platforms,AutomationProperties.Name on interactive controls,Controls without accessible names,"<Button AutomationProperties.Name=""Submit form""><SymbolIcon Symbol=""Accept""/></Button>","<Button><SymbolIcon Symbol=""Accept""/></Button> without name",High,https://platform.uno/docs/articles/features/working-with-accessibility.html,uno current Uno.Sdk/Uno.WinUI,active,2026-08-13
31,Accessibility,Test accessibility per platform,Each platform has different assistive tech,Test with VoiceOver TalkBack and Narrator,Testing accessibility on one platform only,VoiceOver on iOS + TalkBack on Android + Narrator on Windows,Only testing with Narrator on Windows,High,https://platform.uno/docs/articles/features/working-with-accessibility.html,uno current Uno.Sdk/Uno.WinUI,active,2026-08-13
32,Accessibility,Support platform text scaling,Respect user font size preferences,Dynamic font scaling for all text,Fixed font sizes ignoring accessibility,"FontSize=""{ThemeResource BodyTextBlockFontSize}""","FontSize=""14"" everywhere",Medium,https://platform.uno/docs/articles/features/working-with-accessibility.html,uno current Uno.Sdk/Uno.WinUI,active,2026-08-13
33,Testing,Unit test ViewModels,Test business logic independently,xUnit or MSTest on shared ViewModel code,UI testing only,[Fact] public void LoadData_SetsItems() { vm.Load(); Assert.NotEmpty(vm.Items); },Manual testing on each platform,Medium,https://platform.uno/docs/articles/external/uno.uitest/doc/using-uno-uitest.html,uno current Uno.Sdk/Uno.WinUI,active,2026-08-13
34,Testing,Use Uno.UITest for integration,Cross-platform UI testing framework,Uno.UITest for automated UI tests across platforms,Manual regression testing,"app.WaitForElement(""SaveButton""); app.Tap(""SaveButton"");",Manual click-through on each platform,Medium,https://platform.uno/docs/articles/external/uno.uitest/doc/using-uno-uitest.html,uno current Uno.Sdk/Uno.WinUI,active,2026-08-13
35,WASM,Show an extended splash screen on WASM,WASM bundle download and runtime startup take several seconds on first load — render branded UI immediately so users do not see a blank page (AOT and trimming are covered separately),Render a splash overlay in wwwroot/index.html that hides on first XAML navigation,Letting the user wait on a blank white page while the runtime boots,"index.html: <div id=""uno-loading"">Loading…</div> hidden via JS interop after first Frame.Navigate",No splash markup in index.html — 5-second blank page on first visit,Medium,https://platform.uno/docs/articles/external/uno.wasm.bootstrap/doc/runtime-execution-modes.html,uno current Uno.Sdk/Uno.WinUI,active,2026-08-13
36,WASM,Use AOT compilation for performance,Ahead-of-time compilation improves runtime speed,AOT for production WASM builds,Interpreter mode in production,<WasmShellMonoRuntimeExecutionMode>InterpreterAndAOT</WasmShellMonoRuntimeExecutionMode>,Default interpreter mode in production deployment,Medium,https://platform.uno/docs/articles/external/uno.wasm.bootstrap/doc/runtime-execution-modes.html,uno current Uno.Sdk/Uno.WinUI,active,2026-08-13
37,WASM,Handle browser limitations,WASM runs in browser sandbox,Feature detection for browser APIs,Assuming desktop capabilities in browser,"[JSImport(""globalThis.hasApi"")] static partial bool HasApi(); #if __WASM__ if (HasApi()) { ... } #endif","#if __WASM__ StorageFile.GetFileFromPathAsync(""C:/data"") #endif",Medium,https://platform.uno/docs/articles/platform-specific-csharp.html,uno current Uno.Sdk/Uno.WinUI,active,2026-08-13
38,Controls,Use NavigationView for app shell,WinUI NavigationView for consistent navigation across platforms,NavigationView with MenuItems for app navigation,Custom hamburger menu implementation,"<NavigationView><NavigationView.MenuItems><NavigationViewItem Content=""Home"" Icon=""Home""/></NavigationView.MenuItems></NavigationView>",Custom SplitView with manual toggle button,High,https://platform.uno/docs/articles/controls/NavigationView.html,uno current Uno.Sdk/Uno.WinUI,active,2026-08-13
39,Controls,Use ContentDialog for modal interactions,Cross-platform modal dialogs using WinUI API,ContentDialog for confirmations and input,Custom overlay Panel as dialog,"<ContentDialog Title=""Confirm"" PrimaryButtonText=""OK"" CloseButtonText=""Cancel""/>",Grid overlay with manual focus trapping,Medium,https://learn.microsoft.com/en-us/windows/apps/develop/ui/controls/dialogs-and-flyouts/dialogs,uno current Uno.Sdk/Uno.WinUI,active,2026-08-13
40,Controls,Use CommandBar for app actions,Standard command bar with primary and secondary commands,CommandBar with AppBarButtons for toolbar actions,Custom StackPanel toolbar,"<CommandBar><AppBarButton Icon=""Save"" Label=""Save""/><AppBarButton Icon=""Delete"" Label=""Delete""/></CommandBar>","<StackPanel Orientation=""Horizontal""><Button>Save</Button></StackPanel>",Medium,https://learn.microsoft.com/en-us/windows/apps/develop/ui/controls/command-bar,uno current Uno.Sdk/Uno.WinUI,active,2026-08-13
41,Controls,Use ToggleSwitch for boolean settings,Platform-native toggle control for on/off preferences,ToggleSwitch for settings and feature flags,CheckBox for toggle settings,"<ToggleSwitch Header=""Dark Mode"" IsOn=""{x:Bind ViewModel.IsDarkMode, Mode=TwoWay}""/>","<CheckBox Content=""Enable dark mode""/>",Low,https://learn.microsoft.com/en-us/windows/apps/develop/ui/controls/toggles,uno current Uno.Sdk/Uno.WinUI,active,2026-08-13
42,Data Binding,Implement INotifyPropertyChanged,Enable UI updates when ViewModel properties change,CommunityToolkit.Mvvm [ObservableProperty] for auto-notification,Properties without change notification,[ObservableProperty] public partial string Title { get; set; },public string Title { get; set; } without notification,High,https://platform.uno/docs/articles/external/uno.extensions/doc/Overview/Mvux/Overview.html,uno current Uno.Sdk/Uno.WinUI,active,2026-08-13
43,Data Binding,Use ObservableCollection for bound lists,Collection change notifications for ItemsSources across platforms,ObservableCollection<T> for data-bound lists,List<T> for bound ItemsSources,ObservableCollection<Item> Items { get; } = new();,List<Item> Items { get; set; } = new();,High,https://platform.uno/docs/articles/controls/ListViewBase.html,uno current Uno.Sdk/Uno.WinUI,active,2026-08-13
44,Lifecycle,Handle app suspension on mobile,iOS and Android may suspend or terminate the app — WinAppSDK desktop does not raise Suspending so use window Closed for desktop save-state,Save state in OnSuspending and restore on activation,Ignoring lifecycle losing user state on mobile,"Application.Current.Suspending += (s, e) => { var d = e.SuspendingOperation.GetDeferral(); SaveState(); d.Complete(); };",No suspend handler losing form data on mobile,High,https://platform.uno/docs/articles/features/windows-ui-xaml-application.html,uno current Uno.Sdk/Uno.WinUI,active,2026-08-13
45,Lifecycle,Use Uno.Extensions.Hosting for startup,Structured app initialization with DI and configuration,IHost builder pattern for app startup and service registration,Manual initialization in App constructor,Host.CreateDefaultBuilder().ConfigureServices(s => s.AddSingleton<MainViewModel>()).Build();,new MainViewModel() in App.xaml.cs constructor,Medium,https://platform.uno/docs/articles/external/uno.extensions/doc/Overview/Hosting/HostingOverview.html,uno current Uno.Sdk/Uno.WinUI,active,2026-08-13
46,Performance,Use ListView virtualization for large lists,Only renders visible items to reduce memory and layout cost,ListView with default ItemsStackPanel virtualization,ItemsControl or StackPanel for large data sets,"<ListView ItemsSource=""{x:Bind Items}""/> (virtualizes by default)",<ItemsControl><StackPanel> rendering 5000 items at once,High,https://platform.uno/docs/articles/controls/ListViewBase.html,uno current Uno.Sdk/Uno.WinUI,active,2026-08-13
47,Accessibility,Support keyboard navigation on desktop,Skia and WinAppSDK targets need full keyboard operability — note TabIndex routing is not fully implemented on every Uno target,AccessKey and KeyboardAccelerator on Skia and WinAppSDK targets,Mouse-only interactions on desktop,"<Button AccessKey=""S"" Content=""Save""><Button.KeyboardAccelerators><KeyboardAccelerator Modifiers=""Control"" Key=""S""/></Button.KeyboardAccelerators></Button>",Clickable controls without keyboard support on desktop,High,https://platform.uno/docs/articles/controls/NavigationView.html,uno current Uno.Sdk/Uno.WinUI,active,2026-08-13
48,WASM,Use service workers for offline support,Enable PWA capabilities for WASM deployments,Service worker registration for caching and offline mode,Online-only WASM app with no offline fallback,<WasmPWAManifestFile>manifest.webmanifest</WasmPWAManifestFile>,No service worker leaving WASM app unusable offline,Low,https://platform.uno/docs/articles/external/uno.wasm.bootstrap/doc/features-pwa.html,uno current Uno.Sdk/Uno.WinUI,active,2026-08-13
49,Performance,Marshal to UI thread with DispatcherQueue,Cross-thread access to UI elements throws — capture the UI DispatcherQueue once and use TryEnqueue to update from background work,DispatcherQueue.GetForCurrentThread().TryEnqueue from background work,Touching UI controls directly from a Task,"_dispatcher.TryEnqueue(() => StatusText.Text = ""Done"");","await Task.Run(() => StatusText.Text = ""Done""); throws on non-UI thread",High,https://platform.uno/docs/articles/howto-consume-webservices.html,uno current Uno.Sdk/Uno.WinUI,active,2026-08-13
50,Styling,Merge XamlControlsResources in App.xaml,Required for Fluent control styles to load — without it controls render with no template,Add XamlControlsResources at the top of Application.Resources MergedDictionaries,Skipping the merged dictionary and wondering why Buttons look unstyled,"<Application.Resources><ResourceDictionary><ResourceDictionary.MergedDictionaries><XamlControlsResources xmlns=""using:Microsoft.UI.Xaml.Controls""/></ResourceDictionary.MergedDictionaries></ResourceDictionary></Application.Resources>","<Application.Resources><SolidColorBrush x:Key=""MyBrush"" Color=""Red""/></Application.Resources> with no XamlControlsResources merged",High,https://platform.uno/docs/articles/features/fluent-styles.html,uno current Uno.Sdk/Uno.WinUI,active,2026-08-13
51,Architecture,Use async [RelayCommand] for I/O,AsyncRelayCommand reports CanExecute=false (raising CanExecuteChanged) and exposes IsRunning while the Task is in flight — the bound control is disabled and re-entrancy is prevented by default (AllowConcurrentExecutions=false),[RelayCommand] on a Task-returning method for awaitable work,async void event handlers calling .Wait() or .Result,[RelayCommand] private async Task LoadAsync() { Items = await _api.GetAsync(); },"public void OnLoadClick(object s, EventArgs e) { LoadAsync().Wait(); } deadlock risk",Medium,https://learn.microsoft.com/en-us/dotnet/communitytoolkit/mvvm/generators/relaycommand,uno current Uno.Sdk/Uno.WinUI,active,2026-08-13
52,Architecture,Use x:Uid for localized strings,WinUI x:Uid resolves UI text from .resw resources at runtime — use it instead of hardcoded strings to support localization across iOS Android WASM and desktop from a single project,x:Uid on every user-facing string with matching .resw entries per language under Strings/{lang}/Resources.resw,Hardcoding language-specific strings into XAML or code-behind,"<Button x:Uid=""SubmitButton""/> with Strings/en/Resources.resw entry SubmitButton.Content=Submit","<Button Content=""Submit""/> hardcoded in XAML",High,https://platform.uno/docs/articles/features/working-with-strings.html,uno current Uno.Sdk/Uno.WinUI,active,2026-08-13
53,Architecture,Wire up ILogger via Uno.Extensions.Logging,Cross-platform logging routes to platform-native sinks (OSLog on iOS Console on WASM Debug elsewhere) when configured through the IHost builder,Inject ILogger<T> into ViewModels and services and call UseLogging() on the host builder,Console.WriteLine or platform-specific log APIs scattered across shared code,Host.CreateDefaultBuilder().UseLogging(c => c.SetMinimumLevel(LogLevel.Information)) and ILogger<MainViewModel> via constructor injection,"Console.WriteLine(""error"") in shared code with no platform-aware routing",Medium,https://platform.uno/docs/articles/external/uno.extensions/doc/Overview/Logging/LoggingOverview.html,uno current Uno.Sdk/Uno.WinUI,active,2026-08-13
54,Performance,Enable PublishAot on net10.0-desktop,Skia Desktop on .NET 10 supports Native AOT for faster cold start and smaller deployments — opt in per-target so debug builds remain fast,<PublishAot>true</PublishAot> in a TFM-conditional PropertyGroup for net10.0-desktop release builds,Enabling PublishAot globally and breaking debug iteration on every TFM,"<PropertyGroup Condition=""'$(TargetFramework)'=='net10.0-desktop' AND '$(Configuration)'=='Release'""><PublishAot>true</PublishAot></PropertyGroup>",<PublishAot>true</PublishAot> at root with no TFM/Configuration condition,Medium,https://platform.uno/docs/articles/features/using-skia-desktop.html,uno current Uno.Sdk/Uno.WinUI,active,2026-08-13
55,Performance,Never block on async with .Result or .Wait(),Blocking on a Task from the UI thread deadlocks because the awaiter cannot resume on the captured SynchronizationContext — always await async APIs through to the event handler,Await async methods all the way up; in libraries call ConfigureAwait(false) to avoid context capture,Calling .Result .Wait() or GetAwaiter().GetResult() on a Task from the UI thread,"private async void OnLoadClick(object s, RoutedEventArgs e) { var data = await _api.GetAsync(); Items = data; }","private void OnLoadClick(object s, RoutedEventArgs e) { var data = _api.GetAsync().Result; } // deadlocks on UI thread",High,https://platform.uno/docs/articles/howto-consume-webservices.html,uno current Uno.Sdk/Uno.WinUI,active,2026-08-13
56,Styling,Define ThemeDictionaries for Light Dark and HighContrast,Resources placed inside ResourceDictionary.ThemeDictionaries entries are automatically swapped when the system theme changes — required for theme-aware brushes,Wrap brushes in a ThemeDictionaries dictionary keyed by Light Dark and HighContrast in App.xaml or page resources,Defining a single brush at the root and missing dark/high-contrast variants,"<ResourceDictionary.ThemeDictionaries><ResourceDictionary x:Key=""Light""><SolidColorBrush x:Key=""Brand"" Color=""#005A9E""/></ResourceDictionary><ResourceDictionary x:Key=""Dark""><SolidColorBrush x:Key=""Brand"" Color=""#3A96DD""/></ResourceDictionary></ResourceDictionary.ThemeDictionaries>","<SolidColorBrush x:Key=""Brand"" Color=""#005A9E""/> at root with no theme variants",Medium,https://platform.uno/docs/articles/features/working-with-themes.html,uno current Uno.Sdk/Uno.WinUI,active,2026-08-13
57,Architecture,Use Uno.Sdk with UnoFeatures,Uno.Sdk is the modern single-project SDK that auto-resolves Uno.WinUI Uno.Toolkit Material and other packages from a UnoFeatures property — declare features by name instead of hand-managing dozens of PackageReferences,Declare features in the csproj via <UnoFeatures>...</UnoFeatures> and let the SDK resolve transitive packages,Hand-adding every Uno.* PackageReference and matching version numbers across packages,"<Project Sdk=""Uno.Sdk""><PropertyGroup><UnoFeatures>Material;Hosting;Toolkit;Logging;MVVM</UnoFeatures></PropertyGroup></Project>","<PackageReference Include=""Uno.WinUI""/><PackageReference Include=""Uno.Material.WinUI""/> ... duplicated per feature with mismatched versions",Medium,https://platform.uno/docs/articles/features/using-the-uno-sdk.html,uno current Uno.Sdk/Uno.WinUI,active,2026-08-13
58,Lifecycle,Persist desktop window state via Window.Closed,WinAppSDK and Skia desktop heads do not raise Application.Suspending — handle the Window.Closed event (and AppWindow size/position changes) to save user state when desktop apps shut down,Subscribe to MainWindow.Closed and persist any unsaved state before the window is destroyed,Relying on Application.Suspending to fire on desktop targets,"m_window.Closed += (s, e) => SaveState();",Application.Current.Suspending += SaveState; // never fires on WinAppSDK or Skia desktop,Medium,https://learn.microsoft.com/en-us/windows/windows-app-sdk/api/winrt/microsoft.ui.xaml.window,uno current Uno.Sdk/Uno.WinUI,active,2026-08-13
59,Architecture,Use WinRT.Interop for native window handle on Windows,Calling Win32 APIs from a WinUI Window (file pickers icon embedding etc.) requires the HWND — retrieve it via WinRT.Interop.WindowNative.GetWindowHandle and guard the call so non-Windows targets stay unaffected,GetWindowHandle inside a #if WINDOWS block when you need the HWND,Calling WinRT.Interop in shared code without a platform guard,#if WINDOWS\nvar hWnd = WinRT.Interop.WindowNative.GetWindowHandle(MainWindow);\n#endif,var hWnd = WinRT.Interop.WindowNative.GetWindowHandle(MainWindow); // breaks build on iOS Android WASM,Medium,https://learn.microsoft.com/en-us/windows/apps/develop/ui/retrieve-hwnd,uno current Uno.Sdk/Uno.WinUI,active,2026-08-13
1 No Category Guideline Description Do Don't Code Good Code Bad Severity Docs URL Applies To Status Verified At
2 1 XAML Use WinUI XAML API surface Uno implements the WinUI API across platforms Microsoft.UI.Xaml namespace for all UI code WPF or Xamarin.Forms namespaces using Microsoft.UI.Xaml.Controls; using System.Windows.Controls; or using Xamarin.Forms; High https://platform.uno/docs/articles/implemented-views.html uno current Uno.Sdk/Uno.WinUI active 2026-08-13
3 2 XAML Check API implementation status Not all WinUI APIs are implemented on every platform Uno API compatibility docs before using new APIs Assuming all WinUI APIs work everywhere Check platform.uno/docs for API status Using unimplemented API and discovering at runtime High https://platform.uno/docs/articles/implemented-views.html uno current Uno.Sdk/Uno.WinUI active 2026-08-13
4 3 XAML Use Uno.WinUI not Uno.UI for new projects Uno.WinUI uses WinUI 3 APIs Uno.WinUI NuGet packages for new projects Uno.UI (UWP API surface) for new projects <Project Sdk="Uno.Sdk"> (Uno.WinUI / WinUI 3 surface implicit) <PackageReference Include="Uno.UI"/> (legacy UWP API surface) Medium https://platform.uno/docs/articles/updating-to-winui3.html uno current Uno.Sdk/Uno.WinUI active 2026-08-13
5 4 XAML Use XAML Hot Reload Speed up development with live XAML editing Hot Reload for iterating on layouts Restarting app for every XAML change Click Hot Reload button in VS toolbar or save in VS Code/Rider to apply XAML changes Full rebuild for margin tweak Medium https://platform.uno/docs/articles/features/working-with-xaml-hot-reload.html uno current Uno.Sdk/Uno.WinUI active 2026-08-13
6 5 Conditional Use platform-specific XAML Conditional namespaces for platform-specific UI xmlns:android xmlns:ios xmlns:wasm for platform XAML Shared XAML when platforms need different controls <TextBlock android:Text="Android" ios:Text="iOS" Text="Default"/> #if in code-behind to set text per platform Medium https://platform.uno/docs/articles/platform-specific-xaml.html uno current Uno.Sdk/Uno.WinUI active 2026-08-13
7 6 Conditional Use partial classes for platform code Separate platform implementations in partial files Partial class files with platform-specific logic #if directives in shared code for large blocks MainPage.iOS.cs MainPage.Android.cs partial class files #if __IOS__ ... #elif __ANDROID__ ... 100-line blocks in shared file Medium https://platform.uno/docs/articles/platform-specific-csharp.html uno current Uno.Sdk/Uno.WinUI active 2026-08-13
8 7 Conditional Use preprocessor symbols correctly Target correct platforms with defines __IOS__ __ANDROID__ __WASM__ __DESKTOP__ for platform checks Inventing custom symbols or checking OS at runtime #if __ANDROID__ Android-specific code #endif if (RuntimeInformation.IsOSPlatform(OSPlatform.Android)) for compile-time choice Medium https://platform.uno/docs/articles/platform-specific-csharp.html uno current Uno.Sdk/Uno.WinUI active 2026-08-13
9 8 Conditional Minimize platform-specific code Keep shared code maximized Abstract platform differences behind interfaces Duplicating logic across platform files IDeviceService with per-platform implementation Same 50 lines copy-pasted into iOS and Android partial classes High https://platform.uno/docs/articles/platform-specific-csharp.html uno current Uno.Sdk/Uno.WinUI active 2026-08-13
10 9 Navigation Use Frame-based navigation Standard WinUI navigation pattern Frame.Navigate with page types Manual content swapping rootFrame.Navigate(typeof(DetailPage), parameter); contentPresenter.Content = new DetailPage(); Medium https://platform.uno/docs/articles/guides/native-frame-nav-tutorial.html uno current Uno.Sdk/Uno.WinUI active 2026-08-13
11 10 Navigation Use Uno.Extensions.Navigation Type-safe navigation with DI integration Uno.Extensions navigation for complex apps Manual Frame management in large apps navigator.NavigateViewModelAsync<DetailViewModel>(this, data: item); Frame.Navigate with string parsing everywhere Medium https://platform.uno/docs/articles/external/uno.extensions/doc/Overview/Navigation/NavigationOverview.html uno current Uno.Sdk/Uno.WinUI active 2026-08-13
12 11 Navigation Handle platform back navigation SystemNavigationManager.BackRequested works on Android iOS and WASM but is unimplemented on WinAppSDK desktop where calling GetForCurrentView() throws at runtime Subscribe to BackRequested only on platforms that support it or use Uno.Toolkit NavigationBar for cross-platform back UX Calling SystemNavigationManager.GetForCurrentView() on WinUI 3 desktop without a guard #if __ANDROID__ || __IOS__ || __WASM__ SystemNavigationManager.GetForCurrentView().BackRequested += OnBackRequested; #endif SystemNavigationManager.GetForCurrentView().BackRequested += OnBackRequested; with no platform guard — crashes on Windows desktop High https://platform.uno/docs/articles/guides/native-frame-nav-tutorial.html uno current Uno.Sdk/Uno.WinUI active 2026-08-13
13 12 Navigation Use deep linking Support URI activation across platforms Handle protocol activation and URI routing Single entry point ignoring activation Route URIs to specific pages on activation Ignoring OnLaunched activation args Medium https://platform.uno/docs/articles/features/protocol-activation.html uno current Uno.Sdk/Uno.WinUI active 2026-08-13
14 13 Renderers Understand Skia vs native rendering Uno offers both rendering approaches Skia for pixel-perfect cross-platform consistency Assuming native rendering on all platforms <TargetFrameworks>net10.0-desktop;net10.0-browserwasm</TargetFrameworks> uses unified Skia Desktop shell Expecting platform-native controls on Skia targets High https://platform.uno/docs/articles/features/using-skia-desktop.html uno current Uno.Sdk/Uno.WinUI active 2026-08-13
15 14 Renderers Use unified net10.0-desktop target Uno 5.2+ ships a single Skia Desktop shell that auto-selects X11 Win32 or AppKit per OS — Skia.Gtk Skia.Linux.Framebuffer and Skia.WPF heads are deprecated net10.0-desktop TFM with UnoPlatformHostBuilder for cross-platform desktop Targeting the legacy Skia.Gtk or Skia.Linux.Framebuffer heads in new projects <TargetFrameworks>net10.0-desktop</TargetFrameworks> in the Uno.Sdk single project Per-OS Skia.Gtk Skia.MacOS Skia.Linux.Framebuffer head projects Medium https://platform.uno/docs/articles/features/using-skia-desktop.html uno current Uno.Sdk/Uno.WinUI active 2026-08-13
16 15 Renderers Test rendering on each target Visual differences exist between renderers Visual testing on each active target platform Testing only on Windows assuming others match Screenshot tests on iOS Android WASM and Desktop Testing only on Windows Desktop High https://platform.uno/docs/articles/external/uno.uitest/doc/using-uno-uitest.html uno current Uno.Sdk/Uno.WinUI active 2026-08-13
17 16 Renderers Use platform-native features when needed Access native APIs through Uno abstractions Native platform APIs via platform-specific code Avoiding native features for purity #if __IOS__ UIKit API call #endif for camera access Pure shared code that avoids using the camera Medium https://platform.uno/docs/articles/platform-specific-csharp.html uno current Uno.Sdk/Uno.WinUI active 2026-08-13
18 17 Performance Optimize WASM bundle size WebAssembly downloads can be large IL linker and AOT for smaller WASM bundles Default settings for production WASM <WasmShellILLinkerEnabled>true</WasmShellILLinkerEnabled> Publishing WASM without linker High https://platform.uno/docs/articles/features/using-il-linker-webassembly.html uno current Uno.Sdk/Uno.WinUI active 2026-08-13
19 18 Performance Use x:Load for deferred XAML Defer element creation until needed x:Load=False for hidden panels and tabs Loading all UI elements upfront <StackPanel x:Load="{x:Bind ShowAdvanced}"> Always-loaded Collapsed panels Medium https://platform.uno/docs/articles/features/windows-ui-xaml-xbind.html uno current Uno.Sdk/Uno.WinUI active 2026-08-13
20 19 Data Binding Use x:Bind for compiled bindings Compiled bindings eliminate runtime reflection — Uno supports x:Bind across iOS Android WASM Skia and Windows targets that compile XAML so prefer it over {Binding} for static well-typed bindings x:Bind for property and event bindings; reserve {Binding} for runtime-typed DataContext scenarios {Binding} everywhere when x:Bind would compile <TextBlock Text="{x:Bind ViewModel.Title, Mode=OneWay}"/> <TextBlock Text="{Binding Title}"/> for a statically known property High https://platform.uno/docs/articles/features/windows-ui-xaml-xbind.html uno current Uno.Sdk/Uno.WinUI active 2026-08-13
21 20 Performance Profile per platform Performance characteristics vary by target Platform-specific profiling tools Assuming desktop perf equals mobile Instruments on iOS and Android Profiler on Android Profiling only on Windows Medium https://platform.uno/docs/articles/guides/profiling-applications.html uno current Uno.Sdk/Uno.WinUI active 2026-08-13
22 21 Styling Use WinUI theme resources Consistent theming across platforms ThemeResource for adaptive colors Hardcoded colors per platform Background="{ThemeResource ApplicationPageBackgroundThemeBrush}" Background="#FFFFFF" High https://platform.uno/docs/articles/features/working-with-themes.html uno current Uno.Sdk/Uno.WinUI active 2026-08-13
23 22 Styling Support light and dark themes Application.RequestedTheme accepts only ApplicationTheme.Light/Dark — to follow the system theme leave it unset entirely. ElementTheme.Default exists only on FrameworkElement.RequestedTheme not on Application Omit Application.RequestedTheme so the OS theme wins; set Light or Dark explicitly only after a user chooses an override Setting Application.RequestedTheme="Default" — not a valid ApplicationTheme value and throws at parse time <Application></Application> with RequestedTheme unset <Application RequestedTheme="Default"> // not a valid ApplicationTheme Medium https://platform.uno/docs/articles/features/working-with-themes.html uno current Uno.Sdk/Uno.WinUI active 2026-08-13
24 23 Styling Use Lightweight Styling Override control sub-properties via resources Lightweight styling keys for minor tweaks Full ControlTemplate for small changes <Button><Button.Resources><StaticResource x:Key="ButtonBackground" ResourceKey="AccentBrush"/></Button.Resources></Button> Copying entire ControlTemplate to change one color Medium https://platform.uno/docs/articles/external/uno.themes/doc/lightweight-styling.html uno current Uno.Sdk/Uno.WinUI active 2026-08-13
25 24 Styling Test themes on each platform Theme rendering differs across platforms Visual theme testing on all targets Assuming themes look identical everywhere Screenshot comparison across platforms for themed controls Theming only tested on Windows Low https://platform.uno/docs/articles/features/working-with-themes.html uno current Uno.Sdk/Uno.WinUI active 2026-08-13
26 25 Architecture Use MVVM pattern Separate view and logic CommunityToolkit.Mvvm or Prism for MVVM Code-behind for business logic [ObservableProperty] public partial string Title { get; set; } [RelayCommand] private void Save() { } MainPage.xaml.cs with all logic High https://platform.uno/docs/articles/external/workshops/simple-calc/modules/MVVM-XAML/04-App%20Architecture/README.html uno current Uno.Sdk/Uno.WinUI active 2026-08-13
27 26 Architecture Use Uno.Extensions Official extension libraries for common patterns Uno.Extensions for DI navigation configuration Building infrastructure from scratch Host.CreateDefaultBuilder().UseNavigation().UseConfiguration() Manual DI and navigation setup Medium https://platform.uno/docs/articles/external/uno.extensions/doc/ExtensionsOverview.html uno current Uno.Sdk/Uno.WinUI active 2026-08-13
28 27 Architecture Use dependency injection Register services for testability Microsoft.Extensions.DI through Uno.Extensions Static service locators and singletons services.AddSingleton<IApiService, ApiService>(); ApiService.Instance or new ApiService() in ViewModels Medium https://platform.uno/docs/articles/external/uno.extensions/doc/Learn/DependencyInjection/DependencyInjectionOverview.html uno current Uno.Sdk/Uno.WinUI active 2026-08-13
29 28 Architecture Share code via class libraries Maximize code reuse across targets Business logic in .NET Standard or shared library Business logic in platform head projects MyApp.Core class library referenced by all heads Business logic in MyApp.Wasm.csproj Medium https://platform.uno/docs/articles/cross-targeted-libraries.html uno current Uno.Sdk/Uno.WinUI active 2026-08-13
30 29 Architecture Use Uno.Resizetizer for assets Single source SVG to multi-platform assets UnoImage for automatic asset generation from SVG Manual asset export per resolution and platform <UnoImage Include="Assets/icon.svg" BaseSize="24,24"/> Manually exporting icon_1x.png icon_2x.png icon_3x.png per platform Medium https://platform.uno/docs/articles/external/uno.resizetizer/doc/using-uno-resizetizer.html uno current Uno.Sdk/Uno.WinUI active 2026-08-13
31 30 Accessibility Set AutomationProperties Enable screen readers across platforms AutomationProperties.Name on interactive controls Controls without accessible names <Button AutomationProperties.Name="Submit form"><SymbolIcon Symbol="Accept"/></Button> <Button><SymbolIcon Symbol="Accept"/></Button> without name High https://platform.uno/docs/articles/features/working-with-accessibility.html uno current Uno.Sdk/Uno.WinUI active 2026-08-13
32 31 Accessibility Test accessibility per platform Each platform has different assistive tech Test with VoiceOver TalkBack and Narrator Testing accessibility on one platform only VoiceOver on iOS + TalkBack on Android + Narrator on Windows Only testing with Narrator on Windows High https://platform.uno/docs/articles/features/working-with-accessibility.html uno current Uno.Sdk/Uno.WinUI active 2026-08-13
33 32 Accessibility Support platform text scaling Respect user font size preferences Dynamic font scaling for all text Fixed font sizes ignoring accessibility FontSize="{ThemeResource BodyTextBlockFontSize}" FontSize="14" everywhere Medium https://platform.uno/docs/articles/features/working-with-accessibility.html uno current Uno.Sdk/Uno.WinUI active 2026-08-13
34 33 Testing Unit test ViewModels Test business logic independently xUnit or MSTest on shared ViewModel code UI testing only [Fact] public void LoadData_SetsItems() { vm.Load(); Assert.NotEmpty(vm.Items); } Manual testing on each platform Medium https://platform.uno/docs/articles/external/uno.uitest/doc/using-uno-uitest.html uno current Uno.Sdk/Uno.WinUI active 2026-08-13
35 34 Testing Use Uno.UITest for integration Cross-platform UI testing framework Uno.UITest for automated UI tests across platforms Manual regression testing app.WaitForElement("SaveButton"); app.Tap("SaveButton"); Manual click-through on each platform Medium https://platform.uno/docs/articles/external/uno.uitest/doc/using-uno-uitest.html uno current Uno.Sdk/Uno.WinUI active 2026-08-13
36 35 WASM Show an extended splash screen on WASM WASM bundle download and runtime startup take several seconds on first load — render branded UI immediately so users do not see a blank page (AOT and trimming are covered separately) Render a splash overlay in wwwroot/index.html that hides on first XAML navigation Letting the user wait on a blank white page while the runtime boots index.html: <div id="uno-loading">Loading…</div> hidden via JS interop after first Frame.Navigate No splash markup in index.html — 5-second blank page on first visit Medium https://platform.uno/docs/articles/external/uno.wasm.bootstrap/doc/runtime-execution-modes.html uno current Uno.Sdk/Uno.WinUI active 2026-08-13
37 36 WASM Use AOT compilation for performance Ahead-of-time compilation improves runtime speed AOT for production WASM builds Interpreter mode in production <WasmShellMonoRuntimeExecutionMode>InterpreterAndAOT</WasmShellMonoRuntimeExecutionMode> Default interpreter mode in production deployment Medium https://platform.uno/docs/articles/external/uno.wasm.bootstrap/doc/runtime-execution-modes.html uno current Uno.Sdk/Uno.WinUI active 2026-08-13
38 37 WASM Handle browser limitations WASM runs in browser sandbox Feature detection for browser APIs Assuming desktop capabilities in browser [JSImport("globalThis.hasApi")] static partial bool HasApi(); #if __WASM__ if (HasApi()) { ... } #endif #if __WASM__ StorageFile.GetFileFromPathAsync("C:/data") #endif Medium https://platform.uno/docs/articles/platform-specific-csharp.html uno current Uno.Sdk/Uno.WinUI active 2026-08-13
39 38 Controls Use NavigationView for app shell WinUI NavigationView for consistent navigation across platforms NavigationView with MenuItems for app navigation Custom hamburger menu implementation <NavigationView><NavigationView.MenuItems><NavigationViewItem Content="Home" Icon="Home"/></NavigationView.MenuItems></NavigationView> Custom SplitView with manual toggle button High https://platform.uno/docs/articles/controls/NavigationView.html uno current Uno.Sdk/Uno.WinUI active 2026-08-13
40 39 Controls Use ContentDialog for modal interactions Cross-platform modal dialogs using WinUI API ContentDialog for confirmations and input Custom overlay Panel as dialog <ContentDialog Title="Confirm" PrimaryButtonText="OK" CloseButtonText="Cancel"/> Grid overlay with manual focus trapping Medium https://learn.microsoft.com/en-us/windows/apps/develop/ui/controls/dialogs-and-flyouts/dialogs uno current Uno.Sdk/Uno.WinUI active 2026-08-13
41 40 Controls Use CommandBar for app actions Standard command bar with primary and secondary commands CommandBar with AppBarButtons for toolbar actions Custom StackPanel toolbar <CommandBar><AppBarButton Icon="Save" Label="Save"/><AppBarButton Icon="Delete" Label="Delete"/></CommandBar> <StackPanel Orientation="Horizontal"><Button>Save</Button></StackPanel> Medium https://learn.microsoft.com/en-us/windows/apps/develop/ui/controls/command-bar uno current Uno.Sdk/Uno.WinUI active 2026-08-13
42 41 Controls Use ToggleSwitch for boolean settings Platform-native toggle control for on/off preferences ToggleSwitch for settings and feature flags CheckBox for toggle settings <ToggleSwitch Header="Dark Mode" IsOn="{x:Bind ViewModel.IsDarkMode, Mode=TwoWay}"/> <CheckBox Content="Enable dark mode"/> Low https://learn.microsoft.com/en-us/windows/apps/develop/ui/controls/toggles uno current Uno.Sdk/Uno.WinUI active 2026-08-13
43 42 Data Binding Implement INotifyPropertyChanged Enable UI updates when ViewModel properties change CommunityToolkit.Mvvm [ObservableProperty] for auto-notification Properties without change notification [ObservableProperty] public partial string Title { get; set; } public string Title { get; set; } without notification High https://platform.uno/docs/articles/external/uno.extensions/doc/Overview/Mvux/Overview.html uno current Uno.Sdk/Uno.WinUI active 2026-08-13
44 43 Data Binding Use ObservableCollection for bound lists Collection change notifications for ItemsSources across platforms ObservableCollection<T> for data-bound lists List<T> for bound ItemsSources ObservableCollection<Item> Items { get; } = new(); List<Item> Items { get; set; } = new(); High https://platform.uno/docs/articles/controls/ListViewBase.html uno current Uno.Sdk/Uno.WinUI active 2026-08-13
45 44 Lifecycle Handle app suspension on mobile iOS and Android may suspend or terminate the app — WinAppSDK desktop does not raise Suspending so use window Closed for desktop save-state Save state in OnSuspending and restore on activation Ignoring lifecycle losing user state on mobile Application.Current.Suspending += (s, e) => { var d = e.SuspendingOperation.GetDeferral(); SaveState(); d.Complete(); }; No suspend handler losing form data on mobile High https://platform.uno/docs/articles/features/windows-ui-xaml-application.html uno current Uno.Sdk/Uno.WinUI active 2026-08-13
46 45 Lifecycle Use Uno.Extensions.Hosting for startup Structured app initialization with DI and configuration IHost builder pattern for app startup and service registration Manual initialization in App constructor Host.CreateDefaultBuilder().ConfigureServices(s => s.AddSingleton<MainViewModel>()).Build(); new MainViewModel() in App.xaml.cs constructor Medium https://platform.uno/docs/articles/external/uno.extensions/doc/Overview/Hosting/HostingOverview.html uno current Uno.Sdk/Uno.WinUI active 2026-08-13
47 46 Performance Use ListView virtualization for large lists Only renders visible items to reduce memory and layout cost ListView with default ItemsStackPanel virtualization ItemsControl or StackPanel for large data sets <ListView ItemsSource="{x:Bind Items}"/> (virtualizes by default) <ItemsControl><StackPanel> rendering 5000 items at once High https://platform.uno/docs/articles/controls/ListViewBase.html uno current Uno.Sdk/Uno.WinUI active 2026-08-13
48 47 Accessibility Support keyboard navigation on desktop Skia and WinAppSDK targets need full keyboard operability — note TabIndex routing is not fully implemented on every Uno target AccessKey and KeyboardAccelerator on Skia and WinAppSDK targets Mouse-only interactions on desktop <Button AccessKey="S" Content="Save"><Button.KeyboardAccelerators><KeyboardAccelerator Modifiers="Control" Key="S"/></Button.KeyboardAccelerators></Button> Clickable controls without keyboard support on desktop High https://platform.uno/docs/articles/controls/NavigationView.html uno current Uno.Sdk/Uno.WinUI active 2026-08-13
49 48 WASM Use service workers for offline support Enable PWA capabilities for WASM deployments Service worker registration for caching and offline mode Online-only WASM app with no offline fallback <WasmPWAManifestFile>manifest.webmanifest</WasmPWAManifestFile> No service worker leaving WASM app unusable offline Low https://platform.uno/docs/articles/external/uno.wasm.bootstrap/doc/features-pwa.html uno current Uno.Sdk/Uno.WinUI active 2026-08-13
50 49 Performance Marshal to UI thread with DispatcherQueue Cross-thread access to UI elements throws — capture the UI DispatcherQueue once and use TryEnqueue to update from background work DispatcherQueue.GetForCurrentThread().TryEnqueue from background work Touching UI controls directly from a Task _dispatcher.TryEnqueue(() => StatusText.Text = "Done"); await Task.Run(() => StatusText.Text = "Done"); throws on non-UI thread High https://platform.uno/docs/articles/howto-consume-webservices.html uno current Uno.Sdk/Uno.WinUI active 2026-08-13
51 50 Styling Merge XamlControlsResources in App.xaml Required for Fluent control styles to load — without it controls render with no template Add XamlControlsResources at the top of Application.Resources MergedDictionaries Skipping the merged dictionary and wondering why Buttons look unstyled <Application.Resources><ResourceDictionary><ResourceDictionary.MergedDictionaries><XamlControlsResources xmlns="using:Microsoft.UI.Xaml.Controls"/></ResourceDictionary.MergedDictionaries></ResourceDictionary></Application.Resources> <Application.Resources><SolidColorBrush x:Key="MyBrush" Color="Red"/></Application.Resources> with no XamlControlsResources merged High https://platform.uno/docs/articles/features/fluent-styles.html uno current Uno.Sdk/Uno.WinUI active 2026-08-13
52 51 Architecture Use async [RelayCommand] for I/O AsyncRelayCommand reports CanExecute=false (raising CanExecuteChanged) and exposes IsRunning while the Task is in flight — the bound control is disabled and re-entrancy is prevented by default (AllowConcurrentExecutions=false) [RelayCommand] on a Task-returning method for awaitable work async void event handlers calling .Wait() or .Result [RelayCommand] private async Task LoadAsync() { Items = await _api.GetAsync(); } public void OnLoadClick(object s, EventArgs e) { LoadAsync().Wait(); } deadlock risk Medium https://learn.microsoft.com/en-us/dotnet/communitytoolkit/mvvm/generators/relaycommand uno current Uno.Sdk/Uno.WinUI active 2026-08-13
53 52 Architecture Use x:Uid for localized strings WinUI x:Uid resolves UI text from .resw resources at runtime — use it instead of hardcoded strings to support localization across iOS Android WASM and desktop from a single project x:Uid on every user-facing string with matching .resw entries per language under Strings/{lang}/Resources.resw Hardcoding language-specific strings into XAML or code-behind <Button x:Uid="SubmitButton"/> with Strings/en/Resources.resw entry SubmitButton.Content=Submit <Button Content="Submit"/> hardcoded in XAML High https://platform.uno/docs/articles/features/working-with-strings.html uno current Uno.Sdk/Uno.WinUI active 2026-08-13
54 53 Architecture Wire up ILogger via Uno.Extensions.Logging Cross-platform logging routes to platform-native sinks (OSLog on iOS Console on WASM Debug elsewhere) when configured through the IHost builder Inject ILogger<T> into ViewModels and services and call UseLogging() on the host builder Console.WriteLine or platform-specific log APIs scattered across shared code Host.CreateDefaultBuilder().UseLogging(c => c.SetMinimumLevel(LogLevel.Information)) and ILogger<MainViewModel> via constructor injection Console.WriteLine("error") in shared code with no platform-aware routing Medium https://platform.uno/docs/articles/external/uno.extensions/doc/Overview/Logging/LoggingOverview.html uno current Uno.Sdk/Uno.WinUI active 2026-08-13
55 54 Performance Enable PublishAot on net10.0-desktop Skia Desktop on .NET 10 supports Native AOT for faster cold start and smaller deployments — opt in per-target so debug builds remain fast <PublishAot>true</PublishAot> in a TFM-conditional PropertyGroup for net10.0-desktop release builds Enabling PublishAot globally and breaking debug iteration on every TFM <PropertyGroup Condition="'$(TargetFramework)'=='net10.0-desktop' AND '$(Configuration)'=='Release'"><PublishAot>true</PublishAot></PropertyGroup> <PublishAot>true</PublishAot> at root with no TFM/Configuration condition Medium https://platform.uno/docs/articles/features/using-skia-desktop.html uno current Uno.Sdk/Uno.WinUI active 2026-08-13
56 55 Performance Never block on async with .Result or .Wait() Blocking on a Task from the UI thread deadlocks because the awaiter cannot resume on the captured SynchronizationContext — always await async APIs through to the event handler Await async methods all the way up; in libraries call ConfigureAwait(false) to avoid context capture Calling .Result .Wait() or GetAwaiter().GetResult() on a Task from the UI thread private async void OnLoadClick(object s, RoutedEventArgs e) { var data = await _api.GetAsync(); Items = data; } private void OnLoadClick(object s, RoutedEventArgs e) { var data = _api.GetAsync().Result; } // deadlocks on UI thread High https://platform.uno/docs/articles/howto-consume-webservices.html uno current Uno.Sdk/Uno.WinUI active 2026-08-13
57 56 Styling Define ThemeDictionaries for Light Dark and HighContrast Resources placed inside ResourceDictionary.ThemeDictionaries entries are automatically swapped when the system theme changes — required for theme-aware brushes Wrap brushes in a ThemeDictionaries dictionary keyed by Light Dark and HighContrast in App.xaml or page resources Defining a single brush at the root and missing dark/high-contrast variants <ResourceDictionary.ThemeDictionaries><ResourceDictionary x:Key="Light"><SolidColorBrush x:Key="Brand" Color="#005A9E"/></ResourceDictionary><ResourceDictionary x:Key="Dark"><SolidColorBrush x:Key="Brand" Color="#3A96DD"/></ResourceDictionary></ResourceDictionary.ThemeDictionaries> <SolidColorBrush x:Key="Brand" Color="#005A9E"/> at root with no theme variants Medium https://platform.uno/docs/articles/features/working-with-themes.html uno current Uno.Sdk/Uno.WinUI active 2026-08-13
58 57 Architecture Use Uno.Sdk with UnoFeatures Uno.Sdk is the modern single-project SDK that auto-resolves Uno.WinUI Uno.Toolkit Material and other packages from a UnoFeatures property — declare features by name instead of hand-managing dozens of PackageReferences Declare features in the csproj via <UnoFeatures>...</UnoFeatures> and let the SDK resolve transitive packages Hand-adding every Uno.* PackageReference and matching version numbers across packages <Project Sdk="Uno.Sdk"><PropertyGroup><UnoFeatures>Material;Hosting;Toolkit;Logging;MVVM</UnoFeatures></PropertyGroup></Project> <PackageReference Include="Uno.WinUI"/><PackageReference Include="Uno.Material.WinUI"/> ... duplicated per feature with mismatched versions Medium https://platform.uno/docs/articles/features/using-the-uno-sdk.html uno current Uno.Sdk/Uno.WinUI active 2026-08-13
59 58 Lifecycle Persist desktop window state via Window.Closed WinAppSDK and Skia desktop heads do not raise Application.Suspending — handle the Window.Closed event (and AppWindow size/position changes) to save user state when desktop apps shut down Subscribe to MainWindow.Closed and persist any unsaved state before the window is destroyed Relying on Application.Suspending to fire on desktop targets m_window.Closed += (s, e) => SaveState(); Application.Current.Suspending += SaveState; // never fires on WinAppSDK or Skia desktop Medium https://learn.microsoft.com/en-us/windows/windows-app-sdk/api/winrt/microsoft.ui.xaml.window uno current Uno.Sdk/Uno.WinUI active 2026-08-13
60 59 Architecture Use WinRT.Interop for native window handle on Windows Calling Win32 APIs from a WinUI Window (file pickers icon embedding etc.) requires the HWND — retrieve it via WinRT.Interop.WindowNative.GetWindowHandle and guard the call so non-Windows targets stay unaffected GetWindowHandle inside a #if WINDOWS block when you need the HWND Calling WinRT.Interop in shared code without a platform guard #if WINDOWS\nvar hWnd = WinRT.Interop.WindowNative.GetWindowHandle(MainWindow);\n#endif var hWnd = WinRT.Interop.WindowNative.GetWindowHandle(MainWindow); // breaks build on iOS Android WASM Medium https://learn.microsoft.com/en-us/windows/apps/develop/ui/retrieve-hwnd uno current Uno.Sdk/Uno.WinUI active 2026-08-13