Where to start?
Blazor in the context of EyeAuras
Start with a C# Overlay v3 controlled by its aura, or a window created from a C# Script action.
C# Overlay
Until recently (Oct 2024) this was the only option. It's simple: create an aura, add a C# Overlay and… that's it. EA takes care of drawing a window on the screen with your code inside. Otherwise it's a regular overlay: you can specify display conditions via triggers, adjust color, background, etc.
Here are a couple of overlay examples:

Example
Let's make a tiny overlay with a button and counter.
- Create an aura
- Add C# Overlay

- That's it—the overlay with a clickable button is rendered

For new examples choose C# Overlay v3; its files are explained in the overlay series.
C# Script Action
Now the main course. You can create not just one or two overlays controlled by triggers, but an entire window system driven by scripts. They appear wherever and whenever you want, look however you like. EA relieves you from much of the headache typical of WPF or WinForms, especially around multithreading.
Example
Let's see how scripts can work with windows.
- Create an aura
- Add OnEnter C# Script action

- Create a new Razor Component, keep the default name UserComponent

- In Script.csx add:
using EyeAuras.Shared.Scripting;
using PoeShared.Scaffolding;
var window = GetService<IDialogWindowUnstableScriptingApi>() // get DialogWindow API
.CreateWindow<UserComponent>() //create new window with UserComponent inside
.AddTo(ExecutionAnchors); //destroy when script is stopped
window.WindowStartupLocation = System.Windows.WindowStartupLocation.CenterScreen;
window.ShowDialog(cancellationToken);
- Put this counter in
UserComponent.razor; remove duplicate members fromUserComponent.csif present:
@using Microsoft.AspNetCore.Components.Web
@using PoeShared.Blazor
@inherits BlazorReactiveComponent
<button class="btn btn-primary" @onclick="Increment">Click Me</button>
<p>Clicks: @count</p>
@code {
private int count;
private void Increment() => count++;
}
- Press Run—here's your first dialog window using the Blazor Windows API! Note that the script keeps running while the window is open, but stopping the script closes the window.

What is IDialogWindowUnstableScriptingApi?
This is the main interface intended for interacting with dialog windows. There are alternatives, but currently it's the highest-level and safest option—it takes care of unloading windows when an aura unloads, cleaning up resources, etc. It's called Unstable not because it's bad but because, being new, it may have breaking changes. The name does not guarantee future compatibility.
Pass data from the script into the component
Add an ordinary WindowModel.cs to the same project:
public sealed class WindowModel
{
public string Title { get; set; } = "Settings";
}
In Script.csx, pass new WindowModel { Title = "My window" } to CreateWindow<UserComponent>(...). In Razor use @inherits BlazorReactiveComponent<WindowModel> and render @DataContext.Title. The host passes that object; Script.csx variables and its cancellation token do not become component members. Changing a plain model property externally does not create an automatic UI subscription; add an appropriate refresh mechanism.
See window operations and the Blazor map.