Shiny.Mediator.Blazor 4.0.1-beta-0001

Prefix Reserved
This is a prerelease version of Shiny.Mediator.Blazor.
There is a newer version of this package available.
See the version list below for details.
dotnet add package Shiny.Mediator.Blazor --version 4.0.1-beta-0001
                    
NuGet\Install-Package Shiny.Mediator.Blazor -Version 4.0.1-beta-0001
                    
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="Shiny.Mediator.Blazor" Version="4.0.1-beta-0001" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="Shiny.Mediator.Blazor" Version="4.0.1-beta-0001" />
                    
Directory.Packages.props
<PackageReference Include="Shiny.Mediator.Blazor" />
                    
Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.
paket add Shiny.Mediator.Blazor --version 4.0.1-beta-0001
                    
#r "nuget: Shiny.Mediator.Blazor, 4.0.1-beta-0001"
                    
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
#:package Shiny.Mediator.Blazor@4.0.1-beta-0001
                    
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.
#addin nuget:?package=Shiny.Mediator.Blazor&version=4.0.1-beta-0001&prerelease
                    
Install as a Cake Addin
#tool nuget:?package=Shiny.Mediator.Blazor&version=4.0.1-beta-0001&prerelease
                    
Install as a Cake Tool

Shiny Mediator

<a href="https://www.nuget.org/packages/Shiny.Mediator" target="_blank"> <img src="https://img.shields.io/nuget/v/Shiny.Mediator?style=for-the-badge" /> </a>

Mediator is a behavioral design pattern that lets you reduce chaotic dependencies between objects. The pattern restricts direct communications between the objects and forces them to collaborate only via a mediator object.

Shiny Mediator <NugetBadge name="Shiny.Mediator" /> is a mediator pattern implementation, but for built with ALL .NET apps in mind. We provide a TON of middleware out-of-box to get you up and rolling with hardly any effort whatsoever. Checkout our Getting Started guide to see how easy it is. Imagine using 1 line of code to add offline, caching, or validation to your code!

This project is heavily inspired by MediatR with some lesser features that we feel were aimed more at server scenarios, while also adding some features we feel benefit apps

Samples & Documentation

Features

Works With

  • .NET MAUI - all platforms
  • MVVM Frameworks like Prism, ReactiveUI, & .NET MAUI Shell
  • Blazor - Work In Progress
  • Any other .NET platform - but you'll have to come up with your own "event collector" for the out-of-state stuff

What Does It Solve

Problem #1 - Service & Reference Hell

Does this look familiar to you? Look at all of those injections! As your app grows, the list will only grow. I feel sorry for the dude that gets to unit test this bad boy.

public class MyViewModel(
    IConnectivity conn,
    IDataService data,
    IAuthService auth,
    IDialogsService dialogs,
    ILogger<MyViewModel> logger
) {
    // ...
    try {
        if (conn.IsConnected) 
        {
            var myData = await data.GetDataRequest();
        }
        else 
        {
            dialogs.Show("No Connection");
            // cache?
        }
    }
    catch (Exception ex) {
        dialogs.Show(ex.Message);
        logger.LogError(ex);
    }
}

With a bit of our middleware and some events, you can get here:

public class MyViewModel(IMediator mediator) : IEventHandler<ConnectivityChangedEvent>, IEventHandler<AuthChangedEvent> {
    // ...
    var myData = await mediator.Request(new GetDataRequest());

    // logging, exception handling, offline caching can all be bundle into one nice clean call without the need for coupling
}

public class GetDataRequestHandler : IRequestHandler<GetDataRequest, MyData> {

    [OfflineAvailable] // <= boom done
    public async Task<MyData> Handle(GetDataRequest request, CancellationToken cancellationToken) {
        // ...
    }
}

Problem #2 - Messages EVERYWHERE (+ Leaks)

Do you use the MessagingCenter in Xamarin.Forms? It's a great tool, but it can lead to some memory leaks if you're not careful. It also doesn't have a pipeline, so any errors in any of the responders will crash the entire chain. It doesn't have a request/response style setup (not that it was meant for it), but this means you still require other services.

public class MyViewModel
{
    public MyViewModel()
    {
        MessagingCenter.Subscribe<SomeEvent1>(this, @event => {
            // do something
        });
        MessagingCenter.Subscribe<SomeEvent2>(this, @event => {
            // do something
        });

        MessagingCenter.Send(new SomeEvent1());
        MessagingCenter.Send(new SomeEvent2());

        // and don't forget to unsubscribe
        MessagingCenter.Unsubscribe<SomeEvent1>(this);
        MessagingCenter.Unsubscribe<SomeEvent2>(this);
    }
}

Let's take a look at our mediator in action for this scenarios

public class MyViewModel : IEventHandler<SomeEvent1>, IEventHandler<SomeEvent2>
{
    public MyViewModel(IMediator mediator)
    {
        // no need to unsubscribe
        mediator.Publish(new SomeEvent1());
        mediator.Publish(new SomeEvent2());
    }
}

Problem #3 - Strongly Typed Navigation with Strongly Typed Arguments

Our amazing friends over in Prism offer the "best in class" MVVM framework. We'll them upsell you beyond that, but one of their amazing features is 'Modules'. Modules help break up your navigation registration, services, etc.

What they don't solve is providing a strongly typed nature for this stuff (not their job though). We think we can help addon to their beautiful solution.

A normal call to a navigation service might look like this:

_navigationService.NavigateAsync("MyPage", new NavigationParameters { { "MyArg", "MyValue" } });

This is great. It works, but I don't know the type OR argument requirements of "MyPage" without going to look it up. In a small project with a small dev team, this is fine. In a large project with a large dev team, this can be difficult.

Through our Shiny.Framework library we offer a GlobalNavigationService that can be used to navigate to any page in your app from anywhere, however, for the nature of this example, we'll pass our navigation service FROM our viewmodel through the mediator request to ensure proper scope.

public record MyPageNavigatonRequest(INavigationService navigator, string MyArg) : IRequest;
public class MyPageNavigationHandler : IRequestHandler<MyPageNavigatonRequest>
{
    public async Task Handle(MyPageNavigatonRequest request, CancellationToken cancellationToken)
    {
        await request.navigator.NavigateAsync("MyPage", new NavigationParameters { { "MyArg", request.MyArg } });
    }
}

Now, in your viewmodel, you can do this:

public class MyViewModel
{
    public MyViewModel(IMediator mediator)
    {
        mediator.Request(new MyPageNavigationCommand(_navigationService, "MyValue"));
    }
}

Strongly typed. No page required page knowledge from the module upfront. The other dev team of the module can define HOW things work.

Product Compatible and additional computed target framework versions.
.NET net9.0 is compatible.  net9.0-android was computed.  net9.0-browser was computed.  net9.0-ios was computed.  net9.0-maccatalyst was computed.  net9.0-macos was computed.  net9.0-tvos was computed.  net9.0-windows was computed.  net10.0 was computed.  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.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
4.10.0-beta-0001 84 7/29/2025
4.9.1 87 7/29/2025
4.9.0 197 7/26/2025
4.9.0-beta-0005 486 7/22/2025
4.9.0-beta-0004 486 7/22/2025
4.9.0-beta-0003 484 7/22/2025
4.9.0-beta-0002 432 7/21/2025
4.9.0-beta-0001 357 7/21/2025
4.8.0 38 7/18/2025
4.8.0-beta-0004 38 7/18/2025
4.8.0-beta-0003 137 7/14/2025
4.8.0-beta-0002 130 7/14/2025
4.8.0-beta-0001 128 7/14/2025
4.7.0 145 6/25/2025
4.7.0-beta-0026 124 7/13/2025
4.7.0-beta-0025 127 7/10/2025
4.7.0-beta-0023 139 6/25/2025
4.7.0-beta-0022 132 6/24/2025
4.7.0-beta-0021 140 6/23/2025
4.7.0-beta-0020 137 6/19/2025
4.7.0-beta-0004 128 6/19/2025
4.6.6 141 6/19/2025
4.6.5 133 6/19/2025
4.6.4 134 6/19/2025
4.6.3 137 6/18/2025
4.6.2 134 6/18/2025
4.6.1 148 6/16/2025
4.6.1-beta-0005 134 6/18/2025
4.6.1-beta-0003 133 6/18/2025
4.6.1-beta-0001 131 6/16/2025
4.6.0 139 6/16/2025
4.5.0 293 6/10/2025
4.5.0-beta-0007 277 6/10/2025
4.5.0-beta-0006 263 6/9/2025
4.5.0-beta-0004 92 6/6/2025
4.5.0-beta-0002 126 6/6/2025
4.4.0 148 6/3/2025
4.4.0-beta-0025 145 6/3/2025
4.4.0-beta-0023 146 5/29/2025
4.4.0-beta-0021 141 5/29/2025
4.4.0-beta-0018 143 5/26/2025
4.4.0-beta-0017 142 5/26/2025
4.4.0-beta-0015 137 5/26/2025
4.4.0-beta-0014 139 5/26/2025
4.4.0-beta-0004 95 5/25/2025
4.2.2 77 5/24/2025
4.2.1 176 5/8/2025
4.2.0 106 4/25/2025
4.2.0-beta-0010 151 5/8/2025
4.2.0-beta-0009 139 5/8/2025
4.2.0-beta-0008 100 4/25/2025
4.2.0-beta-0001 183 4/16/2025
4.1.0 160 3/28/2025
4.1.0-beta-0001 139 3/28/2025
4.0.4 417 3/24/2025
4.0.4-beta-0001 395 3/24/2025
4.0.3 275 3/23/2025
4.0.3-beta-0007 262 3/23/2025
4.0.2 84 3/15/2025
4.0.1 218 3/5/2025
4.0.1-beta-0010 151 3/19/2025
4.0.1-beta-0009 68 3/15/2025
4.0.1-beta-0001 204 3/5/2025
4.0.0 213 3/4/2025
4.0.0-beta-0021 202 3/4/2025
4.0.0-beta-0017 208 3/4/2025
4.0.0-beta-0016 201 3/4/2025
4.0.0-beta-0010 92 3/2/2025
4.0.0-beta-0009 89 3/2/2025
4.0.0-beta-0002 91 3/1/2025
3.3.1 120 2/20/2025
3.3.0 109 2/20/2025
3.3.0-beta-0028 97 2/20/2025
3.3.0-beta-0025 92 2/19/2025
3.3.0-beta-0024 95 2/19/2025
3.3.0-beta-0004 97 2/8/2025
3.2.0 102 1/29/2025
3.2.0-beta-0027 84 1/29/2025
3.2.0-beta-0023 85 1/29/2025
3.2.0-beta-0020 90 1/29/2025
3.1.3 97 1/29/2025
3.1.2 97 1/28/2025
3.1.1 105 1/25/2025
3.1.0 98 1/25/2025
3.1.0-beta-0013 85 1/25/2025
3.1.0-beta-0006 88 1/25/2025
3.1.0-beta-0004 85 1/25/2025
3.0.0 99 1/24/2025
3.0.0-beta-0055 90 1/24/2025
3.0.0-beta-0046 85 1/23/2025
3.0.0-beta-0045 81 1/23/2025
3.0.0-beta-0043 87 1/23/2025
3.0.0-beta-0038 89 1/21/2025
3.0.0-beta-0037 99 1/21/2025
3.0.0-beta-0029 99 1/21/2025
3.0.0-beta-0028 89 1/21/2025
3.0.0-beta-0018 79 1/19/2025
3.0.0-beta-0016 69 1/14/2025
3.0.0-beta-0012 97 1/12/2025
3.0.0-beta-0008 91 1/2/2025
3.0.0-beta-0007 92 12/28/2024
3.0.0-beta-0004 102 12/22/2024
2.2.0-beta-0001 94 10/28/2024
2.1.1 128 10/28/2024
2.1.0 126 10/19/2024
2.1.0-beta-0016 92 10/19/2024
2.1.0-beta-0015 88 10/19/2024
2.1.0-beta-0014 103 10/19/2024
2.1.0-beta-0013 113 10/19/2024
2.1.0-beta-0011 125 10/18/2024
2.1.0-beta-0010 124 10/18/2024
2.1.0-beta-0004 93 10/8/2024
2.1.0-beta-0002 90 10/6/2024
2.0.2 125 10/6/2024
2.0.1 117 10/6/2024
2.0.0 118 10/4/2024
2.0.0-beta-0060 91 10/6/2024
2.0.0-beta-0059 94 10/6/2024
2.0.0-beta-0056 91 10/4/2024
2.0.0-beta-0054 105 10/3/2024
2.0.0-beta-0053 98 10/2/2024
2.0.0-beta-0052 108 10/2/2024
2.0.0-beta-0050 100 10/2/2024
2.0.0-beta-0049 97 10/2/2024
2.0.0-beta-0046 99 10/1/2024
2.0.0-beta-0044 101 9/30/2024
2.0.0-beta-0026 101 9/24/2024
2.0.0-beta-0023 89 9/23/2024
2.0.0-beta-0022 79 9/23/2024
2.0.0-beta-0020 91 9/22/2024
2.0.0-beta-0004 83 9/20/2024
2.0.0-beta-0003 99 9/20/2024
1.9.0-beta-0003 97 9/16/2024
1.9.0-beta-0001 94 9/15/2024
1.9.0-beta 92 9/15/2024
1.8.1 125 9/14/2024
1.8.1-beta-0006 90 9/14/2024
1.8.1-beta-0005 107 9/14/2024
1.8.1-beta-0004 90 9/14/2024
1.8.1-beta-0003 89 9/14/2024
1.8.1-beta-0002 118 9/14/2024
1.8.1-beta-0001 88 9/14/2024
1.8.0 158 9/12/2024
1.8.0-beta-0064 101 9/12/2024
1.8.0-beta-0063 115 9/12/2024
1.8.0-beta-0059 88 9/8/2024
1.8.0-beta-0058 101 9/8/2024
1.8.0-beta-0057 108 9/8/2024
1.8.0-beta-0054 109 9/7/2024
1.8.0-beta-0053 108 9/6/2024
1.8.0-beta-0052 101 9/6/2024
1.8.0-beta-0051 113 9/6/2024
1.8.0-beta-0044 118 9/5/2024
1.8.0-beta-0042 98 9/4/2024
1.8.0-beta-0041 92 9/4/2024
1.8.0-beta-0027 128 8/25/2024
1.8.0-beta-0022 116 8/23/2024
1.8.0-beta-0017 100 8/7/2024
1.8.0-beta-0012 86 7/28/2024
1.8.0-beta-0010 97 7/28/2024
1.7.5 150 8/23/2024
1.7.4 140 8/9/2024
1.7.3 127 8/7/2024
1.7.2 101 7/28/2024
1.7.1 95 7/28/2024
1.7.0 143 7/20/2024
1.7.0-beta-0005 116 7/20/2024
1.7.0-beta-0001 105 7/8/2024
1.6.0 135 7/8/2024
1.6.0-beta-0004 108 7/7/2024
1.5.0 123 7/6/2024
1.5.0-beta-0010 119 7/6/2024
1.5.0-beta-0006 107 7/4/2024
1.4.5 138 7/4/2024
1.4.2 138 6/30/2024
1.4.1 139 6/30/2024
1.4.0 124 6/30/2024
1.4.0-beta-0010 120 6/30/2024
1.3.1 132 6/29/2024
1.3.0 133 6/29/2024
1.3.0-beta-0014 114 6/29/2024
1.3.0-beta-0007 102 6/26/2024
1.2.0 141 6/20/2024
1.2.0-beta-0001 110 6/20/2024
1.1.0 128 6/17/2024
1.1.0-beta-0019 108 6/20/2024
1.1.0-beta-0016 111 6/19/2024
1.1.0-beta-0014 120 6/17/2024
1.1.0-beta-0013 108 6/17/2024
1.0.0 143 6/15/2024
1.0.0-alpha-0054 116 6/15/2024
1.0.0-alpha-0053 111 6/12/2024
1.0.0-alpha-0051 109 6/12/2024
1.0.0-alpha-0048 116 6/10/2024
1.0.0-alpha-0047 109 6/10/2024
1.0.0-alpha-0043 118 6/9/2024
1.0.0-alpha-0042 120 6/7/2024
1.0.0-alpha-0040 121 6/6/2024
1.0.0-alpha-0038 118 6/6/2024
1.0.0-alpha-0036 117 6/5/2024
1.0.0-alpha-0034 129 6/4/2024
1.0.0-alpha-0031 112 6/4/2024
1.0.0-alpha-0025 116 6/3/2024
1.0.0-alpha-0023 117 6/2/2024
1.0.0-alpha-0022 114 6/1/2024
1.0.0-alpha-0019 121 6/1/2024
1.0.0-alpha-0018 115 6/1/2024
1.0.0-alpha-0014 127 6/1/2024
1.0.0-alpha-0013 109 6/1/2024
1.0.0-alpha-0012 113 5/31/2024
1.0.0-alpha-0011 115 5/31/2024
1.0.0-alpha-0010 119 5/31/2024