### Install ShadUI NuGet Package (CLI)

Source: https://github.com/accntech/shad-ui/blob/main/README.md

Installs the latest version of the ShadUI NuGet package using the .NET CLI. This is the primary method for adding ShadUI to your Avalonia project.

```powershell
dotnet add package ShadUI
```

--------------------------------

### ShadUI Dialog System Setup and Usage (C#)

Source: https://context7.com/accntech/shad-ui/llms.txt

Demonstrates how to set up and use the DialogManager for creating simple alerts, custom dialogs with view models, and managing dialog dismissal. Requires DI setup and registration of custom dialog views.

```csharp
// Setup: Register DialogManager as singleton in DI
services.AddSingleton<DialogManager>();

// Register custom dialog views with their DataContext types
var dialogManager = serviceProvider.GetRequiredService<DialogManager>();
dialogManager.Register<LoginContent, LoginViewModel>();
dialogManager.Register<SettingsContent, SettingsViewModel>();

// Add DialogHost to your window's Hosts collection
// <controls:Window.Hosts>
//     <dialogs:DialogHost Manager="{Binding DialogManager}"
//                         Owner="{Binding RelativeSource={RelativeSource AncestorType=controls:Window}}" />
// </controls:Window.Hosts>

// Simple alert dialog
_dialogManager
    .CreateDialog(
        "Are you absolutely sure?",
        "This action cannot be undone. This will permanently delete your account.")
    .WithPrimaryButton("Continue", () => DeleteAccount())
    .WithCancelButton("Cancel")
    .WithMaxWidth(512)
    .Dismissible()
    .Show();

// Destructive style dialog
_dialogManager
    .CreateDialog(
        "Delete all data?",
        "This will permanently remove all your data from our servers.")
    .WithPrimaryButton("Delete", () => DeleteAllData(), DialogButtonStyle.Destructive)
    .WithCancelButton("Cancel")
    .WithMaxWidth(512)
    .Dismissible()
    .Show();

// Dialog with multiple buttons
_dialogManager
    .CreateDialog("Save changes?", "You have unsaved changes.")
    .WithPrimaryButton("Save", async () => await SaveAsync())
    .WithSecondaryButton("Don't Save", () => DiscardChanges())
    .WithCancelButton("Cancel")
    .Show();

// Custom dialog with view model
var loginViewModel = new LoginViewModel();
_dialogManager.CreateDialog(loginViewModel)
    .Dismissible()
    .WithSuccessCallback(vm =>
        _toastManager.CreateToast("Sign in successful")
            .WithContent($"Welcome back, {vm.Email}!")
            .ShowSuccess())
    .WithCancelCallback(() =>
        _toastManager.CreateToast("Sign in cancelled")
            .ShowWarning())
    .Show();

// Close dialog from within the view model
public void OnLoginSuccess()
{
    _dialogManager.Close(this, new CloseDialogOptions { Success = true });
}

public void OnCancel()
{
    _dialogManager.Close(this, new CloseDialogOptions { Success = false });
}

// Prevent/allow dialog dismissal programmatically
_dialogManager.PreventDismissal(); // Disable clicking outside to close
_dialogManager.AllowDismissal();   // Re-enable dismissal

```

--------------------------------

### Install Specific ShadUI NuGet Package Version (CLI)

Source: https://github.com/accntech/shad-ui/blob/main/README.md

Installs a specific version or a preview version of the ShadUI NuGet package using the .NET CLI. This allows for controlled updates or testing of specific releases.

```powershell
dotnet add package ShadUI --version [version]
```

--------------------------------

### ShadUI Window Control Example

Source: https://context7.com/accntech/shad-ui/llms.txt

This XAML defines a customizable ShadUI Window with options for title bar customization, logo, menu, and macOS traffic light positioning. It also includes a DialogHost for managing dialogs within the window.

```xml
<controls:Window
    xmlns:controls="clr-namespace:ShadUI;assembly=ShadUI"
    Title="My Application"
    TitleFontSize="14"
    TitleFontWeight="Medium"
    IsTitleBarVisible="True"
    ShowBottomBorder="True"
    ShowTitlebarBackground="True"
    CanMove="True"
    SaveWindowState="True"
    RootCornerRadius="10"
    TitleBarAnimationEnabled="True"
    EnableTrafficLightPositioning="True"
    TrafficLightOffset="10,10">

    <controls:Window.LogoContent>
        <Image Source="/Assets/logo.png" Width="24" Height="24" />
    </controls:Window.LogoContent>

    <controls:Window.MenuBarContent>
        <Menu>
            <MenuItem Header="File">
                <MenuItem Header="New" />
                <MenuItem Header="Open" />
                <Separator />
                <MenuItem Header="Exit" />
            </MenuItem>
        </Menu>
    </controls:Window.MenuBarContent>

    <controls:Window.RightWindowTitleBarContent>
        <Button Classes="Ghost" Content="Settings" />
    </controls:Window.RightWindowTitleBarContent>

    <controls:Window.Hosts>
        <DialogHost Manager="{Binding DialogManager}"
                    Owner="{Binding RelativeSource={RelativeSource AncestorType=controls:Window}}" />
    </controls:Window.Hosts>

    <!-- Main content here -->
</controls:Window>
```

--------------------------------

### Use ShadUI Window (XAML)

Source: https://github.com/accntech/shad-ui/blob/main/README.md

Recommends using the ShadUI.Controls.Window instead of the default Avalonia.Controls.Window to leverage the full ShadUI experience, including custom styling and behavior.

```xml
<Window xmlns="https://github.com/avaloniaui" 
        xmlns:ui="using:ShadUI.Controls"
        ...> 
    <!-- Content -->
</Window>
```

--------------------------------

### Fluent Animation API in C#

Source: https://context7.com/accntech/shad-ui/llms.txt

Demonstrates the Fluent Animation API in C# for creating animations on Avalonia controls. It supports chaining animation properties like duration, easing, and cancellation via `CancellationTokenSource`.

```csharp
// Animate opacity
_myButton.Animate(OpacityProperty)
    .From(0)
    .To(1)
    .WithDuration(TimeSpan.FromMilliseconds(300))
    .WithEasing(new CubicEaseOut())
    .Start();

// Animate width with async completion
await _sidebar.Animate(WidthProperty)
    .From(56)
    .To(255)
    .WithDuration(TimeSpan.FromMilliseconds(300))
    .WithEasing(new EaseInOut())
    .RunAsync();

// Animate with cancellation support
var cts = new CancellationTokenSource();
_panel.Animate(HeightProperty)
    .From(0)
    .To(200)
    .WithDuration(TimeSpan.FromSeconds(1))
    .WithCancellationToken(cts.Token)
    .Start();

// Cancel animation
cts.Cancel();
```

--------------------------------

### Shad-UI Button Styles

Source: https://context7.com/accntech/shad-ui/llms.txt

Demonstrates various button styles like Primary, Secondary, Destructive, Outline, Ghost, and Icon, with support for a loading state using `shadui:ButtonAssist.ShowProgress`. These are defined using XAML.

```xml
<!-- Primary Button -->
<Button Classes="Primary" Content="Submit"
        shadui:ButtonAssist.ShowProgress="{Binding IsBusy}" />

<!-- Primary Button with Icon -->
<Button Classes="Primary" Content="Edit"
        shadui:ButtonAssist.ShowProgress="{Binding IsBusy}">
    <shadui:ButtonAssist.Icon>
        <TextBlock Classes="LucideIcon" Margin="0,0,6,0" Text="&#57849;" />
    </shadui:ButtonAssist.Icon>
</Button>

<!-- Secondary Button -->
<Button Classes="Secondary" Content="Secondary" />

<!-- Destructive Button -->
<Button Classes="Destructive" Content="Delete">
    <shadui:ButtonAssist.Icon>
        <TextBlock Classes="LucideIcon" Margin="0,0,6,0" Text="&#57741;" />
    </shadui:ButtonAssist.Icon>
</Button>

<!-- Outline Button -->
<Button Classes="Outline" Content="Outline" />

<!-- Ghost Button -->
<Button Classes="Ghost" Content="Ghost" />

<!-- Icon Button -->
<Button Classes="Icon" BorderBrush="{DynamicResource BorderColor}">
    <shadui:ButtonAssist.Icon>
        <TextBlock Classes="LucideIcon" Margin="0,8" Text="&#57849;" />
    </shadui:ButtonAssist.Icon>
</Button>

<!-- Destructive Icon Button -->
<Button Classes="DestructiveIcon">
    <shadui:ButtonAssist.Icon>
        <TextBlock Classes="LucideIcon" Margin="0,8" Text="&#57741;" />
    </shadui:ButtonAssist.Icon>
</Button>
```

--------------------------------

### Apply Theme Colors via Dynamic Resources

Source: https://context7.com/accntech/shad-ui/llms.txt

Access the ShadUI color system using DynamicResource references in XAML. This allows for consistent application of background, foreground, and semantic theme colors across various UI components.

```xml
<!-- Basic Colors -->
<Border Background="{DynamicResource BackgroundColor}" />
<TextBlock Foreground="{DynamicResource ForegroundColor}" />
<Border BorderBrush="{DynamicResource BorderColor}" />
<TextBlock Foreground="{DynamicResource MutedColor}" />

<!-- Theme Colors -->
<Button Background="{DynamicResource PrimaryColor}"
        Foreground="{DynamicResource PrimaryForegroundColor}" />
<Button Background="{DynamicResource SecondaryColor}" />
<Button Background="{DynamicResource DestructiveColor}" />

<!-- Notification Colors -->
<Border Background="{DynamicResource InfoColor}" />
<Border Background="{DynamicResource SuccessColor}" />
<Border Background="{DynamicResource WarningColor}" />
<Border Background="{DynamicResource ErrorColor}" />

<!-- Component-specific Colors -->
<Border Background="{DynamicResource CardBackgroundColor}" />
<Border Background="{DynamicResource DialogBackgroundColor}" />
<Border Background="{DynamicResource SidebarBackgroundColor}" />
<Border Background="{DynamicResource TitleBarBackgroundColor}" />
```

--------------------------------

### Shad-UI Loading and Skeleton Controls

Source: https://context7.com/accntech/shad-ui/llms.txt

Provides loading spinner and skeleton placeholder controls for indicating active loading states in XAML. The `BusyArea` wrapper can overlay content when a busy state is active.

```xml
<!-- Loading spinner -->
<shadui:Loading Width="24" Height="24" />

<!-- Skeleton placeholder -->
<shadui:Skeleton Width="200" Height="20" />

<!-- BusyArea wrapper for content -->
<shadui:BusyArea IsBusy="{Binding IsLoading}" LoadingSize="48">
    <StackPanel>
        <!-- Content that will be overlaid when busy -->
        <TextBlock Text="Your content here" />
    </StackPanel>
</shadui:BusyArea>
```

--------------------------------

### ShadUI Sidebar Control Configuration (XAML)

Source: https://context7.com/accntech/shad-ui/llms.txt

Defines a customizable sidebar component using XAML, including properties for width, minimum width, expansion state, animation durations, and content for header, items, and footer. Supports navigation routing.

```xml
<shadui:Sidebar
    xmlns:shadui="clr-namespace:ShadUI;assembly=ShadUI"
    Width="255"
    MinWidth="56"
    Expanded="{Binding IsSidebarExpanded}"
    ItemIconContentSpacing="12"
    CurrentRoute="{Binding CurrentRoute}"
    ExpandAnimationDuration="300"
    CollapseAnimationDuration="200"
    Background="{DynamicResource CardBackgroundColor}"
    Padding="8">

    <shadui:Sidebar.Header>
        <StackPanel Margin="8">
            <TextBlock Classes="h4" Text="My App" />
        </StackPanel>
    </shadui:Sidebar.Header>

    <StackPanel Spacing="4">
        <TextBlock Classes="Caption Muted"
                   IsVisible="{Binding $parent[shadui:Sidebar].Expanded}"
                   Margin="8" Text="Navigation" />

        <shadui:SidebarItem Content="Dashboard" Route="dashboard" IsChecked="True">
            <shadui:SidebarItem.Icon>
                <Viewbox>
                    <TextBlock Classes="LucideIcon" Text="&#58001;" />
                </Viewbox>
            </shadui:SidebarItem.Icon>
        </shadui:SidebarItem>

        <shadui:SidebarItem Content="Analytics" Route="analytics">
            <shadui:SidebarItem.Icon>
                <Viewbox>
                    <TextBlock Classes="LucideIcon" Text="&#57455;" />
                </Viewbox>
            </shadui:SidebarItem.Icon>
        </shadui:SidebarItem>

        <shadui:SidebarItem Content="Settings" Route="settings">
            <shadui:SidebarItem.Icon>
                <Viewbox>
                    <TextBlock Classes="LucideIcon" Text="&#57607;" />
                </Viewbox>
            </shadui:SidebarItem.Icon>
        </shadui:SidebarItem>
    </StackPanel>

    <shadui:Sidebar.Footer>
        <shadui:SidebarItem Content="Help &amp; Support">
            <shadui:SidebarItem.Icon>
                <Viewbox>
                    <TextBlock Classes="LucideIcon" Text="&#57686;" />
                </Viewbox>
            </shadui:SidebarItem.Icon>
        </shadui:SidebarItem>
    </shadui:Sidebar.Footer>
</shadui:Sidebar>

```

--------------------------------

### ShadUI Toast Notifications in C#

Source: https://context7.com/accntech/shad-ui/llms.txt

This C# code demonstrates how to use the ShadUI ToastManager to display various types of toast notifications. It covers basic messages, content, actions, custom delays, different toast types (info, success, warning, error), and custom positioning. Remember to register ToastManager as a singleton in your DI container and add the ToastHost to your window.

```csharp
// Setup: Register ToastManager as singleton in DI
services.AddSingleton<ToastManager>();

// Add ToastHost to your window
// <toasts:ToastHost Manager="{Binding ToastManager}" />

// Simple toast
_toastManager.CreateToast("Your message has been sent.").Show();

// Toast with title and content
_toastManager.CreateToast("Uh oh! Something went wrong.")
    .WithContent("There was a problem with your request.")
    .Show();

// Toast with action button
_toastManager.CreateToast("Uh oh! Something went wrong.")
    .WithContent("There was a problem with your request.")
    .WithAction("Try again", () => RetryOperation())
    .Show();

// Toast with custom delay (in seconds)
_toastManager.CreateToast("This toast will disappear in 5 seconds.")
    .WithContent("You can hover over it to prevent it from disappearing.")
    .WithDelay(5)
    .Show();

// Info toast with dismiss on click
_toastManager.CreateToast("Event has been created")
    .WithContent($"{DateTime.Now:dddd, MMMM d 'at' h:mm tt}")
    .DismissOnClick()
    .ShowInfo();

// Success toast
_toastManager.CreateToast("Operation completed successfully")
    .WithContent("Your changes have been saved.")
    .ShowSuccess();

// Warning toast
_toastManager.CreateToast("Event has been created with warnings")
    .WithContent("Some fields were auto-corrected.")
    .ShowWarning();

// Error toast with retry action
_toastManager.CreateToast("Failed to create event")
    .WithContent("Unable to connect to the server.")
    .WithAction("Retry", () => RetryOperation())
    .ShowError();

// Toast with custom position
_toastManager.CreateToast("Notification")
    .WithContent("This appears in the top right corner.")
    .OnTopRight()
    .ShowInfo();

// Available positions: OnTopLeft(), OnTopCenter(), OnTopRight(),
//                      OnBottomLeft(), OnBottomCenter(), OnBottomRight()

// Dismiss all toasts
_toastManager.DismissAll();
```

--------------------------------

### Apply ShadTheme in App.xaml (XAML)

Source: https://github.com/accntech/shad-ui/blob/main/README.md

Integrates the ShadUI theme into your Avalonia application by including the ShadTheme style in the Application.Styles section of your App.xaml file. This applies the default ShadUI styling across your application.

```xml
<Application
    xmlns:themes="clr-namespace:ShadUI;assembly=ShadUI">

    <!-- other code -->

    <Application.Styles>
        <themes:ShadTheme />
        <!-- other styles -->
    </Application.Styles>
</Application>
```

--------------------------------

### Extend Avalonia Controls with Attached Properties

Source: https://context7.com/accntech/shad-ui/llms.txt

Utilize ShadUI attached properties to enhance standard controls. This includes adding labels to form inputs, managing button icons and loading states, and configuring menu popup positioning.

```xml
<!-- ControlAssist: Add labels to form controls -->
<TextBox shadui:ControlAssist.Label="Email Address"
         Watermark="Enter your email" />

<ComboBox shadui:ControlAssist.Label="Country"
          SelectedIndex="0">
    <ComboBoxItem>United States</ComboBoxItem>
    <ComboBoxItem>Canada</ComboBoxItem>
</ComboBox>

<!-- ButtonAssist: Add icons and loading state to buttons -->
<Button Classes="Primary" Content="Save"
        shadui:ButtonAssist.ShowProgress="{Binding IsSaving}">
    <shadui:ButtonAssist.Icon>
        <TextBlock Classes="LucideIcon" Text="&#57849;" />
    </shadui:ButtonAssist.Icon>
</Button>

<!-- MenuItemAssist: Customize menu popup placement -->
<MenuItem shadui:MenuItemAssist.PopupPlacement="RightEdgeAlignedTop"
          shadui:MenuItemAssist.PopupHorizontalOffset="4"
          shadui:MenuItemAssist.PopupVerticalOffset="0">
    <shadui:MenuItemAssist.Label>
        <TextBlock Text="Custom Label" />
    </shadui:MenuItemAssist.Label>
</MenuItem>
```

--------------------------------

### Shad-UI Badge Control

Source: https://context7.com/accntech/shad-ui/llms.txt

A badge component for displaying status indicators, counts, or labels, available in multiple variants (Default, Secondary, Destructive, Outline) as shown in XAML. It's useful for highlighting information.

```xml
<!-- Default badge -->
<shadui:Badge Content="New" />

<!-- Secondary badge -->
<shadui:Badge Variant="Secondary" Content="Beta" />

<!-- Destructive badge -->
<shadui:Badge Variant="Destructive" Content="Error" />

<!-- Outline badge -->
<shadui:Badge Variant="Outline" Content="v1.0.0" />
```

--------------------------------

### Shad-UI Avatar Control

Source: https://context7.com/accntech/shad-ui/llms.txt

An avatar component implemented in XAML, capable of displaying user images from a source URL or falling back to initials if the image fails to load. It supports customizable size and corner radius.

```xml
<!-- Avatar with image -->
<shadui:Avatar Source="/Assets/user.png"
               Width="40" Height="40"
               CornerRadius="{DynamicResource XlCornerRadius}"
               Fallback="JD" />

<!-- Avatar with fallback (when image fails to load) -->
<shadui:Avatar Fallback="CN"
               Width="36" Height="36"
               CornerRadius="{DynamicResource LgCornerRadius}" />
```

--------------------------------

### Shad-UI Card Control

Source: https://context7.com/accntech/shad-ui/llms.txt

A versatile card component in XAML with distinct header, content, and footer sections. It supports shadow effects and integrates various input controls like TextBoxes and ComboBoxes.

```xml
<shadui:Card HasShadow="True" HorizontalAlignment="Center">
    <shadui:Card.Header>
        <StackPanel>
            <shadui:CardTitle>Create project</shadui:CardTitle>
            <shadui:CardDescription>Deploy your new project in one-click.</shadui:CardDescription>
        </StackPanel>
    </shadui:Card.Header>

    <StackPanel Spacing="16">
        <TextBox Watermark="Name of your project"
                 shadui:ControlAssist.Label="Name" />
        <ComboBox SelectedIndex="0" Width="300"
                  shadui:ControlAssist.Label="Framework">
            <ComboBoxItem>Next.js</ComboBoxItem>
            <ComboBoxItem>React</ComboBoxItem>
            <ComboBoxItem>Vue.js</ComboBoxItem>
        </ComboBox>
    </StackPanel>

    <shadui:Card.Footer>
        <DockPanel>
            <Button Classes="Outline" HorizontalAlignment="Left"
                    Margin="0,20,0,0">Cancel</Button>
            <Button Classes="Primary" HorizontalAlignment="Right"
                    Margin="0,20,0,0">Deploy</Button>
        </DockPanel>
    </shadui:Card.Footer>
</shadui:Card>
```

=== COMPLETE CONTENT === This response contains all available snippets from this library. No additional content exists. Do not make further requests.