👁 Image
Zafiro.Avalonia.Icons.Projektanker 51.2.0

Zafiro.Avalonia

👁 NuGet
👁 NuGet Downloads

A UI components library for Avalonia 11.3.x that provides controls, dialogs, behaviors, and helpers for desktop, mobile, and browser applications. Built with ReactiveUI, a strong functional-reactive orientation (Result<T>, Maybe<T>, IObservable<T>), and absolute respect for the MVVM pattern — no logic in views, no UI in ViewModels.

Packages

Getting Started

dotnet add package Zafiro.Avalonia

For dialogs:

dotnet add package Zafiro.Avalonia.Dialogs

For auto-generated view locators and section registrations (recommended):

dotnet add package Zafiro.Avalonia.Generators

Quick Start

Application Bootstrap with Connect

Wire up your app in one line — works on Desktop, Mobile, and Browser:

public override void OnFrameworkInitializationCompleted()
{
 this.Connect(() => new MainView(), view => CompositionRoot.Create(view), () => new MainWindow());
 base.OnFrameworkInitializationCompleted();
}

Connect handles IClassicDesktopStyleApplicationLifetime and ISingleViewApplicationLifetime automatically, so the same code runs everywhere.

Shell, Sections, and Navigation

A section-based navigation system integrated with Microsoft.Extensions.DependencyInjection:

ServiceCollection services = new();

services.AddSingleton<IShell, Shell>();
services.AddSingleton(DialogService.Create());
services.AddScoped<INavigator>(provider => new Navigator(provider, logger, RxApp.MainThreadScheduler));
services.AddAllSectionsFromAttributes(logger); // auto-discovers [Section] ViewModels
services.AddTransient<MainViewModel>();

var serviceProvider = services.BuildServiceProvider();
return serviceProvider.GetRequiredService<MainViewModel>();

Combined with Zafiro.Avalonia.Generators, sections are discovered from [Section] attributes and registered automatically.

Dialogs and Wizards

Dialogs that work on both desktop and mobile:

Result<Maybe<T>> result = await dialog.ShowAndGetResult(viewModel, "Title");

https://github.com/SuperJMN-Zafiro/Zafiro.Avalonia/assets/3109851/d3d29a3e-3a35-4b27-abe0-14d95405c651

Build multi-step wizards declaratively with SlimWizard:

var wizard = WizardBuilder
 .StartWith(() => new Page1ViewModel(), "Step 1")
 .NextWith(model => model.Continue.Enhance("Next"))
 .Then(result => new Page2ViewModel(result), "Step 2")
 .NextWhenValid((vm, prev) => Result.Success(vm.Text!))
 .WithCompletionFinalStep();

https://github.com/SuperJMN-Zafiro/Zafiro.Avalonia/assets/3109851/47dad47a-af35-489c-83b7-0a7c853879f7

EnhancedCommand

Wraps ReactiveCommand with UX metadata (text, icon, name) and busy state — distinguishing between busy (executing) and disabled (can't execute) via IEnhancedCommand:

var command = ReactiveCommand.CreateFromTask(() => DoSomething());
var enhanced = command.Enhance("Save", name: "save");
// enhanced.IsBusy tracks execution; enhanced.CanExecute tracks enablement

View Locators

Automatically resolves Views for ViewModels by naming convention (MainViewModel → MainView) and by x:DataType discovery via source generators:

DataTemplates.Add(new NamingConventionViewLocator());

With Zafiro.Avalonia.Generators, x:DataType declarations in .axaml files are discovered at compile time and registered automatically.

Key Features

Navigation and Shell

• Shell / ShellView — Section-based application shell with sidebar navigation.
• Navigator — Observable navigation stack integrated with DI.
• SectionStrip — Tab-like section navigation with grouping support.
• Sections auto-registration — Source generator discovers [Section] ViewModels and wires DI.

Controls

https://github.com/SuperJMN-Zafiro/Zafiro.Avalonia/assets/3109851/13279313-92cc-4ba9-902e-e3a26da87916

Services

• DialogService — Show dialogs from ViewModels without coupling to the View layer.
• NotificationService — Push notifications from ViewModels.
• ILauncherService — Open URLs and files from ViewModels.

Commands and Selection

• EnhancedCommand — ReactiveCommand wrapper with text/icon metadata, busy/disabled distinction via IEnhancedCommand.
• ReactiveSelection — Observable selection model with multi-select support.
• CommandPool / EnqueueCommandAction — Throttled, pooled command execution.

Helpers

• Connect — One-line app bootstrap for all platforms (Desktop, Mobile, Browser).
• NamingConventionViewLocator + DataTypeViewLocator — Convention and x:DataType based ViewModel → View resolution.
• IconExtension — Unified icon markup extension supporting Projektanker and SVG providers.
• ReturnExtension — Markup extension for returning observables in design-time data.

Samples

The solution includes runnable samples that demonstrate all features:

# Desktop
dotnet run --project samples/TestApp/TestApp.Desktop

# Browser (WASM)
dotnet run --project samples/TestApp/TestApp.Browser

Philosophy

• Functional + Reactive — Result<T>, Maybe<T>, and IObservable<T> throughout. No exceptions for control flow, explicit error handling everywhere.
• MVVM purist — Strict separation: no UI logic in ViewModels, no business logic in Views. Services are injected, never resolved from Views.
• Composition over inheritance — Small, composable building blocks and extension methods.
• ReactiveUI-first — State as observables, commands for intents, no imperative event handlers.
• Cross-platform — Desktop, Android, iOS, and Browser from the same codebase.

Disclaimer

Zafiro.Avalonia is an independent community project and is not affiliated with, endorsed by, or sponsored by AvaloniaUI OÜ.

Avalonia is a trademark of AvaloniaUI OÜ.

License

© José Manuel Nieto (@SuperJMN)