Reflection-free Avalonia views
StaticViewLocator
Resolve view models to views at compile time and keep runtime discovery AOT-friendly.
Overview
A compile-time Avalonia view locator with convention and generic MVVM-contract mapping, exact factories, generated ReactiveUI and IDataTemplate adapters, inheritance fallbacks, and configurable MSBuild rules.
StaticViewLocator resolves conventions and configured generic MVVM contracts during compilation, then emits exact factories plus optional ReactiveUI IViewLocator and Avalonia IDataTemplate adapters. It removes reflection-heavy discovery while retaining deterministic generic, inherited, interface-based, and modular application fallbacks.
Compile-time exact factory tables
Generic MVVM contract mappings
Generated ReactiveUI and Avalonia adapters
Configurable naming conventions
Built for
Where it fits.
- Avalonia MVVM applications
- NativeAOT-conscious desktop teams
- Modular applications with inherited or interface view models
Compatibility & status
IDataTemplate
Reflection-free path
Opt-in scan
Supported
In the work
Real output,
not a mockup.
Architecture
Clear layers.
Replaceable seams.
Discovery
The generator scans eligible view models and accessible Avalonia view types.
Convention
Namespace, suffix, generic, and interface transforms derive candidate views.
Index
Resolved types become static factories; misses remain useful fallback metadata.
Lookup
Exact, generic, base, and interface helpers resolve runtime view-model types.
Inside StaticViewLocator
One repository.
Multiple serious systems.
Explore the focused capabilities, their package boundaries, architecture, installation, and smallest useful example.
The source generator maps ViewModel namespaces and suffixes to Avalonia views and emits direct Type-to-factory lookup tables without runtime reflection.
1 module→02 · Map real application hierarchiesFallback & ConfigurationExact types, generic definitions, base classes, and interfaces participate in a deterministic fallback order controlled by compiler-visible MSBuild properties.
1 module→Quick start
From package
to first frame.
Choose the package workflow used by your repository, then start from the smallest working example. Replace VERSION with the current stable or prerelease version shown on NuGet.
dotnet add package StaticViewLocator<PackageReference Include="StaticViewLocator" Version="VERSION" /><PackageVersion Include="StaticViewLocator" Version="VERSION" />[StaticViewLocator]public partial class ViewLocator : IDataTemplate{ public Control? Build(object? data) => data is null ? null : TryGetFactory(data.GetType())?.Invoke();}Package surface
Start focused.
Compose as needed.
Source, docs, samples, and releases
The repository is the source of truth.
Use the current documentation and samples, inspect changes, report issues, or support continued open-source maintenance.