DotNetBrowser in Avalonia UI 12
This guide shows how to embed DotNetBrowser into a cross-platform desktop application created with Avalonia 12.
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
For .NET 8.0, use a slightly different command:
dotnet new --install DotNetBrowser.Templates
After installation, the template projects will be available in both .NET 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 Avalonia app with DotNetBrowser
Create a new application:
dotnet new dotnetbrowser.avalonia12.app -o Embedding.AvaloniaUi -li <your_license_key>
dotnet new dotnetbrowser.avalonia12.app -o Embedding.AvaloniaUi -lang VisualBasic -li <license_key>
The project will be created in the folder Embedding.AvaloniaUi.
By default, this project will target net8.0. Use -f option to specify net10.0 or net9.0.
The DotNetBrowser agent skill tells AI coding agents how to write code with
DotNetBrowser. To add it to the project, use the --agent option with
ClaudeCode, Codex, Cursor, or Copilot. Building the project copies the
skill to the agent’s skills directory in the project folder. For other ways to
install the skill, see Installing the agent skill.
4. Run your application
Finally, launch the application by running the following command in the terminal:
dotnet run --project Embedding.AvaloniaUi
Here’s how the result will look on different platforms:

DotNetBrowser + Avalonia 12 on Windows

DotNetBrowser + Avalonia 12 on macOS

DotNetBrowser + Avalonia 12 on Linux