AvalloyThe layer a desktop app sits on.

App bootstrap, window chrome, a token-driven theme engine, commands and keybindings, preferences with hot reload, an icon pipeline, and in-app updates — for Avalonia, so the app itself is only the app.

Get started

View on GitHub

Batteries in, seams out

Derive from AvalloyApp and you have DI, logging, a single-instance guard, relaunch, a splash, and the login-shell PATH fix. Every piece is behind an interface you can answer yourself.

Native chrome, measured around

AlloyTitleBar never draws caption buttons. It measures around the OS's own — traffic lights on macOS, the DWM strip on Windows — so the window looks like it belongs on each platform.

Tokens, not styles

Every colour, radius, size and face is a resource key. Copy a template, keep every key, replace the values: that is a brand theme, and it repaints live.

Documented at the seam

The XML doc comments ship in the packages and say what each piece is for and what it deliberately does not do. They are the design notes.

Avalloy.Core

the app shell

The app class, the window and title bar, the sidebar and tab strip, commands and the palette, preferences, the theme cascade, dialogs, toasts, and the control layer.

AvalloyAppShellWindowAlloyTitleBarCommandRegistryPreferencesServiceThemeServiceTabStripCliRunner

Avalloy.Themes

the native theme engine

Hand-authored light and dark templates on a token contract, a type ramp, control themes, and a controller that swaps the palette live and follows the OS.

NativeThemeControllerTokens.axamlTemplate.LightTemplate.DarkType.axamlAlloyControls

Avalloy.Icons

the icon pipeline

One control for every glyph. SVGs bake to XAML geometry at build time, packs swap as a dictionary, and a Lucide baseline ships in the box. The baker is a dotnet tool.

GlyphIconIconResolverIconBakerIconPickerViewavalloy-icontool

Avalloy.Updates

in-app updates

Check, download, then restart into the new build or stage it for the next quit. Velopack underneath, a notifier seam on top, and a no-op in dev runs.

UpdateServiceIUpdateSourceIUpdateNotifierVelopackUpdateSource