Avalonia XAML Compiler and Tooling

XamlToCSharpGenerator

AXSG compiles Avalonia XAML into generated C#, adds compiled bindings, x:Bind, inline C#, and hot reload. Most users start with one of two install surfaces: the XamlToCSharpGenerator NuGet package for app integration, or the AXSG XAML Language Service VSIX for VS Code editing.

Start Getting Started NuGet Package VSIX Extension

Primary Install Surfaces

Most AXSG users only need one of these starting points.

NuGet: XamlToCSharpGenerator

The main source-generator package for Avalonia applications. Use it when you want the default build, generator, and runtime path in one package.

 VSIX: AXSG XAML Language Service

The packaged VS Code extension. Use it when you want completion, diagnostics, navigation, preview, and inline C# tooling inside VS Code.

Start Here

Overview

Choose the right install surface and understand the compiler/runtime split before you wire AXSG into an app.

 Quickstart

Install the standard package, enable source-generated views, and validate the first generated build.

 C# Expressions

Use shorthand expressions, interpolation, typed sources, and expression-aware tooling inside valid XAML.

 x:Bind

Use source-generated typed bindings with root access, template-item binding, bind-back, and x:Bind-aware editor tooling.

 Inline C#

Author `CSharp` markup, CDATA blocks, and inline event code while keeping the document valid XAML.

Documentation Sections

Getting Started

Installation, first integration, and quickstart paths for the standard AXSG app workflow.

 Concepts

Compiler host, configuration precedence, generated artifacts, binding semantics, and tooling surface.

 Guides

Task-oriented walkthroughs for packaging, release, hot reload, runtime operation, and deployment.

 VS Code

Extension setup, configuration, preview, AXSG Inspector panels, and editor-specific workflows for the packaged VS Code experience.

 XAML Usage

Compiled bindings, x:Bind, shorthand expressions, inline C#, templates, styles, control themes, and theme resources.

 Architecture

Compiler pipeline internals, runtime/bootstrap behavior, and the language-service/editor stack.

 Advanced

Performance work, testing strategy, docs/release plumbing, and custom framework-profile extension points.

 Reference

Package guides, namespace entry points, configuration reference, artifact matrix, and API coverage maps.

 API Reference

Generated .NET API pages for the shipped compiler, runtime, language service, and editor assemblies.

Deeper Package Families

App and Build Breakdown

See how `XamlToCSharpGenerator`, `Build`, and the default app-facing integration layers fit together when you need more than the one-package path.

 Compiler Packages

`Compiler`, `Core`, `Framework.Abstractions`, `Avalonia`, `NoUi`, and `Generator` for compiler composition.

 Runtime Packages

`Runtime`, `Runtime.Core`, and `Runtime.Avalonia` for generated view bootstrap, registries, and hot reload.

 Tooling Packages

`LanguageService`, `LanguageServer.Tool`, `Editor.Avalonia`, and the bundled VS Code extension.