Introduction

You can use this section to get started right away with Avalonia. This will take you through a simple tutorial example, step-by-step, and introduce you to some of the Avalonia concepts and techniques.

You do not need any prior knowledge of Avalonia or other XAML-based frameworks to learn from this section.

Click the Next button to get started.

info

If you are a developer experienced with using XAML and Avalonia project creation, you may want to skip ahead to our Basics section here or one of the How-To Guides here.

Prerequisites

Install Templates

Before starting, ensure that you have installed the Avalonia templates:

Bash

dotnet new install Avalonia.Templates

Rider

JetBrains Rider provides native support for Avalonia XAML, offering a rich development experience without requiring additional extensions.

For real-time XAML preview capabilities, you can enhance your workflow by installing the optional Avalonia Rider plugin.

Visual Studio

Visual Studio 2022 users can enhance their Avalonia development experience by installing our official extension from the Visual Studio Marketplace.

The extension provides XAML code completion and an integrated live previewer, allowing you to see your UI updates in real-time.

Visual Studio Code

While we maintain a Visual Studio Code extension that provides basic XAML support and a live previewer, we recommend using JetBrains Rider for the best possible development experience with Avalonia.

However, if you prefer to continue with Visual Studio Code, you can install our extension from the marketplace.