Quick start for Blazor Hybrid Avalonia application

This guide shows how to create a Blazor Hybrid cross-platform desktop application with Avalonia 11 and DotNetBrowser.

Before you begin make sure that your system meets software and hardware requirements.

1. Install DotNetBrowser templates

Open the Terminal or Command Line prompt, and install DotNetBrowser templates if not installed yet:

dotnet new install DotNetBrowser.Templates

After installation, the template projects will be available in both dotnet CLI and Visual Studio.

2. Get trial license

To get a free 30-day trial license, fill in the web form and click the Get my free trial button. You will receive an email with the license key.

3. Create Blazor Hybrid Avalonia application from template

Create a new application:

dotnet new dotnetbrowser.blazor.avalonia.app -o BlazorHybrid.AvaloniaUi -li <license_key>

The project will be created in the folder BlazorHybrid.AvaloniaUi.

By default, this project will target net8.0. Use -f option to specify net9.0, net7.0 or net6.0 instead.

4. Run your application

Finally, launch the application by running the following command in the terminal:

dotnet run --project BlazorHybrid.AvaloniaUi

Here’s how the result will look on different platforms:

DotNetBrowser + Avalonia + Blazor on Windows

DotNetBrowser + Avalonia + Blazor on macOS

DotNetBrowser + Avalonia + Blazor on Linux