1. Home
  2. Docs
  3. Getting Started
  4. Samples and Feature Tour

Samples and Feature Tour

AXSG ships sample applications that exercise the compiler, runtime, hot reload paths, and editor tooling. Use the samples first when you want a working baseline instead of assembling features from scratch.

Main samples

Sample Path Use it for
Source-generated catalog samples/SourceGenXamlCatalogSample language features, bindings, inline C#, templates, styles, runtime loader, and hot reload
Control catalog samples/ControlCatalog larger Avalonia app integration, theme overrides, selector-heavy styling, and broad control coverage
iOS hot reload host samples/ControlCatalog.iOS AXSG + dotnet watch simulator/device validation for the control catalog
NoUi framework pilot samples/NoUiFrameworkPilotSample framework-host reuse outside Avalonia
CRUD sample samples/SourceGenCrudSample app-facing install path and generated runtime behavior

All sample paths are shown relative to the repository root.

Feature tour

Start in samples/SourceGenXamlCatalogSample when you need to see a feature in isolation:

  • bindings and compiled bindings
  • C# expressions and shorthand expressions
  • inline C# and <![CDATA[ ... ]]>
  • event bindings and inline lambdas
  • resource includes, StyleInclude, ControlTheme, and TemplateBinding
  • global XML namespace mappings
  • runtime loader fallback behavior
  • language-service navigation and inline editor features

Suggested reading flow

  1. Quickstart
  2. C# Expressions
  3. Inline C# Code
  4. Styles, Templates, and Themes
  5. Runtime Loader and Fallback
  6. VS Code and Language Service

Why sample-first matters here

AXSG has several surfaces that interact:

  • compiler host configuration
  • generated runtime helpers
  • hot reload transport/runtime coordination
  • editor projections and cross-language navigation

The samples give you a known-good integration point for those layers before you start stripping the setup down for your own project.