README.md

Blazor.State

Source generator for Minimalistic State Management in Blazor.

Installation

Install Blazor.State with NuGet:

Install-Package Blazor.State

Or via the .NET Core command line interface:

dotnet add package Blazor.State

Usage

Define your schema including state, commands and events

public abstract record DarkMode
{
	public record State
	{
		public bool IsDark { get; init; } = true;
	}

	public abstract record Command
	{
		public record Toggle() : Command;
	}

	public abstract record Event
	{
		public record StateChanged() : Event;
	}
}

Reducers instruct how commands modify states and publish events

[Reducer<DarkMode>(PublishStrategy.Async)]
public static class Reducer
{
	public static ReducerResult<DarkMode.State, DarkMode.Event> Handle(DarkMode.State current, DarkMode.Command.Toggle command)
		=> new()
		{
			State = current with { IsDark = !current.IsDark },
			Events = new[] { new DarkMode.Event.StateChanged() }
		};
}

Wire your components

@implements IEventHandler<DarkMode.Event> // Reacts to events
@implements IDisposable

@inject IState<DarkMode.State> State // Observes state

<button @onclick=@(async () => SendAsync(new DarkMode.Command.Toggle()))>
	Toggle Dark Mode
</button>

<main class="@(State.Value.IsDark ? "dark" : "")">
    @Body
</main>

@code {
    protected override void OnInitialized()
    {
        Subscribe(); // Initiate subscription to store broker
    }

    public async ValueTask HandleAsync(DarkMode.Event.StateChanged @event, CancellationToken token)
    {
		// Called when State changes are pusblished

		// Component can decide whether to re-render
        await InvokeAsync(StateHasChanged);
    }

    public void Dispose()
    {
        Unsubscribe(); // Dispose subscription
    }
}

Register Dependency Injection

builder.Services.AddBlazorState();