AvaloniaUI.DeveloperTools 2.1.0

Prefix Reserved
.NET 10.0 This package targets .NET 10.0. The package is compatible with this framework or higher.
There is a newer version of this package available.
See the version list below for details. 
dotnet tool install --global AvaloniaUI.DeveloperTools --version 2.1.0
This package contains a .NET tool you can call from the shell/command line. 
dotnet new tool-manifest
                    


                            if you are setting up this repo
                        

                    

                
dotnet tool install --local AvaloniaUI.DeveloperTools --version 2.1.0
This package contains a .NET tool you can call from the shell/command line. 
#tool dotnet:?package=AvaloniaUI.DeveloperTools&version=2.1.0
                    


                    

                
nuke :add-package AvaloniaUI.DeveloperTools --version 2.1.0

Avalonia Developer Tools

The Avalonia Developer Tools is a standalone application that provides debugging and inspection capabilities for Avalonia applications. It connects to applications that have the Diagnostics Support package installed.

Prerequisites

Developer Tools requires .NET 6.0 or newer runtime to be installed on your system.

Installation

Install as .NET Global Tool

Install the Developer Tools globally using the .NET CLI:

  • For .NET 10+

    dotnet tool install --global AvaloniaUI.DeveloperTools

  • For .NET 6 to .NET 9

    You need to install platform-specific package:

    Windows:

    dotnet tool install --global AvaloniaUI.DeveloperTools.Windows

    macOS:

    dotnet tool install --global AvaloniaUI.DeveloperTools.macOS

    Linux:

    dotnet tool install --global AvaloniaUI.DeveloperTools.Linux

After installation, you can launch it from terminal using:

avdt

Getting Started

For a complete setup guide including how to configure your application with the Diagnostics Support package, see the Developer Tools Getting Started Guide.

Usage

  1. Configure your Avalonia application with the AvaloniaUI.DiagnosticsSupport package
  2. Launch the Developer Tools application
  3. Run your configured Avalonia application
  4. In your application, press F12 to establish connection
  5. Activate the tool with your AvaloniaUI Portal credentials (first time only)

Troubleshooting

If you encounter connection issues or other problems, check the Developer Tools FAQ for common solutions and troubleshooting steps.

Product Compatible and additional computed target framework versions.
.NET net10.0 is compatible.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

This package has no dependencies.

Version Downloads Last Updated
2.2.0-beta2 95 1/23/2026
2.2.0-beta1 111 1/19/2026
2.1.1 2,086 11/13/2025
2.1.0 1,967 10/13/2025

# 2.1.0

Don't forget to update both the .NET tool and the `DiagnosticsSupport` package in your project.

## Enhancements

* Layout Visualizer has returned.
* The `Sign In` experience is now shared between the Parcel and VS extensions, with updated dialog visuals.
* .NET 10-compatible NuGet package — the tool can now be installed as `AvaloniaUI.DeveloperTools` without a platform suffix.
* The Profiler tool is no longer experimental and is now always enabled.
* Improved TitleBar integration on Windows.
* On Windows and macOS, the tool creates a shortcut in the Start Menu / Applications folder. This can be disabled with the `AVALONIA_TOOLRUNNER_DISABLE_SHORTCUT` environment variable.

## Fixes

* Fixed flashing console window when opening on Windows.
* Fixed bug popups that appeared before DevTools connected.
* Fixed file logger sometimes creating a file in the drive root directory.
* Fixed "Update is available" notification showing when the tool is up to date.

# 2.0.4

## Enhancements

* New "Freeze Popups" context menu on the Window element node and a hotkey, allowing you to keep all popups open until unchecked.
* DevTools window is now the active window when an element is inspected from the connected app.
* The Apple build is now a universal (fat) package, including arm64 and x64 (previously Rosetta was required).

## Fixes

* Variable PropertyGrid row columns across different pages, making settings and resources more accessible.
* Fixed bug with DevTools not being able to connect to Android/iOS apps.
* Fixed bug with popups not properly displayed in the elements tree.
* Fixed bug with `OverlayLayer` being ignored in the elements tree.
* `MetricsSupport` should be enabled in the user project in Debug mode.

# 2.0.3

## Enhancements

* Automatic scroll for Logs and Events data grid pages. (#22)
* Previewer no longer opens DevTools when `ConnectOnStartup` is enabled. Instead, an `AutoConnectFromDesignMode` option was added for the previewer scenario. (#20)
* When the application cannot reach Developer Tools via `F12` or `ConnectOnStartup`, it will throw an exception on the dispatcher thread instead of silently ignoring it. This exception can be suppressed via `Dispatcher.UIThread.UnhandledException` if necessary.
* The `Inspect mode` hotkey/button now automatically enables highlighting with tooltips on the connected app when hovering.

# 2.0.2

## Enhancements

* New application icon.
* By default, the application now uses the system theme instead of forcing the dark variant.
* Experimental Compact mode was added.