Toasty.Avalonia 2.0.0

Toasty.Avalonia

A reusable Avalonia 12.x toast notification overlay library for .NET 10.

Features

• Four semantic toast types -- Information, Success, Warning, Error -- plus a fully customisable Custom type.
• Four corner positions: top-left, top-right, bottom-left, and bottom-right.
• Three animation styles: Slide (direction inferred from position), Fade, and None.
• Optional progress bar in Solid (single-colour) or Tricolour (three-phase colour) mode.
• Up to two action buttons per toast, each with an Action callback.
• Persistent mode -- toasts with buttons never auto-dismiss.
• Icon slot that accepts any Avalonia control (path geometry, image, third-party icon, or any other control).
• DI initialisation via AddToasty and non-DI initialisation via UseToasty on AppBuilder.
• Multi-window support -- register a ToastyHost in each window; the service fansout to all of them.
• Accessibility -- polite ARIA live-region and a custom automation peer (AutomationControlType.StatusBar).
• Automatic light/dark theme variants with no dependency on FluentTheme or MaterialTheme.
• Fully theme-agnostic card styling -- every visual value is a DynamicResource key you can override.

Quick start

1. Install

dotnet add package Toasty.Avalonia

Or add the reference directly to your .csproj:

<PackageReference Include="Toasty.Avalonia" Version="2.0.0" />

2. Include the theme

In App.axaml, add the style include after your host application's own theme:

<Application xmlns="https://github.com/avaloniaui"
             xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
             x:Class="MyApp.App"
             RequestedThemeVariant="Default">

  <Application.Styles>
    <FluentTheme />
    <StyleInclude Source="avares://Toasty.Avalonia/Themes/ToastyTheme.axaml" />
  </Application.Styles>

</Application>

3. Add the host control to your window

ToastyHost must be the last child of a Grid so that it renders on top of all other content:

<Window xmlns="https://github.com/avaloniaui"
        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
        xmlns:toasty="using:Toasty.Avalonia.Controls"
        x:Class="MyApp.MainWindow">

  <Grid>

    

    <toasty:ToastyHost ZIndex="9999" />

  </Grid>

</Window>

4. Initialise the service

For applications that do not use Microsoft Dependency Injection, call UseToasty in Program.cs:

using Avalonia;
using Toasty.Avalonia.Extensions;

AppBuilder.Configure<App>()
  .UsePlatformDetect()
  .WithInterFont()
  .UseToasty(config =>
  {
    config.Animation = ToastAnimation.Slide;
  })
  .StartWithClassicDesktopLifetime(args);

For applications that use Microsoft Dependency Injection, call AddToasty on IServiceCollection:

services.AddToasty(config =>
{
  config.Animation = ToastAnimation.Slide;
});

5. Show your first toast

using Toasty.Avalonia;
using Toasty.Avalonia.Models;

// Using the static accessor (works from any class):
Toasty.Current!.Show("File saved successfully.", ToastType.Success);

// Using the injected interface (requires IToastyService injected):
_toastyService.Show("File saved successfully.", ToastType.Success);

Documentation

Compatibility

Licence

Toasty.Avalonia is released under the GNU Affero General Public Licence v3.0 (AGPL-3.0).

Any application that uses this library and is distributed or offered as a network service must make its complete source code available under the same licence.

See the LICENSE file for the full licence text.