Shiny.Mediator.Blazor 4.4.0-beta-0017

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.4.0-beta-0017
                    
NuGet\Install-Package Shiny.Mediator.Blazor -Version 4.4.0-beta-0017
                    
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.4.0-beta-0017" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="Shiny.Mediator.Blazor" Version="4.4.0-beta-0017" />
                    
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.4.0-beta-0017
                    
#r "nuget: Shiny.Mediator.Blazor, 4.4.0-beta-0017"
                    
#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.4.0-beta-0017
                    
#: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.4.0-beta-0017&prerelease
                    
Install as a Cake Addin
#tool nuget:?package=Shiny.Mediator.Blazor&version=4.4.0-beta-0017&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-0006 163 8/28/2025
4.10.0-beta-0005 83 8/22/2025
4.10.0-beta-0004 115 8/22/2025
4.10.0-beta-0003 121 8/18/2025
4.10.0-beta-0002 120 8/18/2025
4.10.0-beta-0001 94 7/29/2025
4.9.1 104 7/29/2025
4.9.0 208 7/26/2025
4.9.0-beta-0005 493 7/22/2025
4.9.0-beta-0004 494 7/22/2025
4.9.0-beta-0003 490 7/22/2025
4.9.0-beta-0002 438 7/21/2025
4.9.0-beta-0001 363 7/21/2025
4.8.0 45 7/18/2025
4.8.0-beta-0004 44 7/18/2025
4.8.0-beta-0003 143 7/14/2025
4.8.0-beta-0002 136 7/14/2025
4.8.0-beta-0001 134 7/14/2025
4.7.0 154 6/25/2025
4.7.0-beta-0026 130 7/13/2025
4.7.0-beta-0025 134 7/10/2025
4.7.0-beta-0023 144 6/25/2025
4.7.0-beta-0022 137 6/24/2025
4.7.0-beta-0021 145 6/23/2025
4.7.0-beta-0020 143 6/19/2025
4.7.0-beta-0004 134 6/19/2025
4.6.6 147 6/19/2025
4.6.5 139 6/19/2025
4.6.4 140 6/19/2025
4.6.3 143 6/18/2025
4.6.2 140 6/18/2025
4.6.1 153 6/16/2025
4.6.1-beta-0005 142 6/18/2025
4.6.1-beta-0003 141 6/18/2025
4.6.1-beta-0001 137 6/16/2025
4.6.0 145 6/16/2025
4.5.0 300 6/10/2025
4.5.0-beta-0007 283 6/10/2025
4.5.0-beta-0006 270 6/9/2025
4.5.0-beta-0004 97 6/6/2025
4.5.0-beta-0002 133 6/6/2025
4.4.0 153 6/3/2025
4.4.0-beta-0025 151 6/3/2025
4.4.0-beta-0023 152 5/29/2025
4.4.0-beta-0021 147 5/29/2025
4.4.0-beta-0018 149 5/26/2025
4.4.0-beta-0017 147 5/26/2025
4.4.0-beta-0015 142 5/26/2025
4.4.0-beta-0014 144 5/26/2025
4.4.0-beta-0004 100 5/25/2025
4.2.2 83 5/24/2025
4.2.1 183 5/8/2025
4.2.0 112 4/25/2025
4.2.0-beta-0010 156 5/8/2025
4.2.0-beta-0009 144 5/8/2025
4.2.0-beta-0008 106 4/25/2025
4.2.0-beta-0001 188 4/16/2025
4.1.0 167 3/28/2025
4.1.0-beta-0001 145 3/28/2025
4.0.4 424 3/24/2025
4.0.4-beta-0001 400 3/24/2025
4.0.3 282 3/23/2025
4.0.3-beta-0007 271 3/23/2025
4.0.2 90 3/15/2025
4.0.1 223 3/5/2025
4.0.1-beta-0010 158 3/19/2025
4.0.1-beta-0009 75 3/15/2025
4.0.1-beta-0001 210 3/5/2025
4.0.0 218 3/4/2025
4.0.0-beta-0021 209 3/4/2025
4.0.0-beta-0017 214 3/4/2025
4.0.0-beta-0016 207 3/4/2025
4.0.0-beta-0010 101 3/2/2025
4.0.0-beta-0009 95 3/2/2025
4.0.0-beta-0002 97 3/1/2025
3.3.1 127 2/20/2025
3.3.0 114 2/20/2025
3.3.0-beta-0028 102 2/20/2025
3.3.0-beta-0025 98 2/19/2025
3.3.0-beta-0024 101 2/19/2025
3.3.0-beta-0004 103 2/8/2025
3.2.0 107 1/29/2025
3.2.0-beta-0027 90 1/29/2025
3.2.0-beta-0023 90 1/29/2025
3.2.0-beta-0020 95 1/29/2025
3.1.3 104 1/29/2025
3.1.2 105 1/28/2025
3.1.1 112 1/25/2025
3.1.0 103 1/25/2025
3.1.0-beta-0013 91 1/25/2025
3.1.0-beta-0006 94 1/25/2025
3.1.0-beta-0004 90 1/25/2025
3.0.0 106 1/24/2025
3.0.0-beta-0055 95 1/24/2025
3.0.0-beta-0046 92 1/23/2025
3.0.0-beta-0045 87 1/23/2025
3.0.0-beta-0043 95 1/23/2025
3.0.0-beta-0038 95 1/21/2025
3.0.0-beta-0037 105 1/21/2025
3.0.0-beta-0029 104 1/21/2025
3.0.0-beta-0028 95 1/21/2025
3.0.0-beta-0018 85 1/19/2025
3.0.0-beta-0016 76 1/14/2025
3.0.0-beta-0012 105 1/12/2025
3.0.0-beta-0008 97 1/2/2025
3.0.0-beta-0007 101 12/28/2024
3.0.0-beta-0004 108 12/22/2024
2.2.0-beta-0001 101 10/28/2024
2.1.1 134 10/28/2024
2.1.0 131 10/19/2024
2.1.0-beta-0016 97 10/19/2024
2.1.0-beta-0015 93 10/19/2024
2.1.0-beta-0014 107 10/19/2024
2.1.0-beta-0013 117 10/19/2024
2.1.0-beta-0011 135 10/18/2024
2.1.0-beta-0010 128 10/18/2024
2.1.0-beta-0004 98 10/8/2024
2.1.0-beta-0002 95 10/6/2024
2.0.2 130 10/6/2024
2.0.1 122 10/6/2024
2.0.0 122 10/4/2024
2.0.0-beta-0060 97 10/6/2024
2.0.0-beta-0059 98 10/6/2024
2.0.0-beta-0056 95 10/4/2024
2.0.0-beta-0054 110 10/3/2024
2.0.0-beta-0053 106 10/2/2024
2.0.0-beta-0052 114 10/2/2024
2.0.0-beta-0050 104 10/2/2024
2.0.0-beta-0049 104 10/2/2024
2.0.0-beta-0046 104 10/1/2024
2.0.0-beta-0044 106 9/30/2024
2.0.0-beta-0026 106 9/24/2024
2.0.0-beta-0023 94 9/23/2024
2.0.0-beta-0022 84 9/23/2024
2.0.0-beta-0020 97 9/22/2024
2.0.0-beta-0004 88 9/20/2024
2.0.0-beta-0003 104 9/20/2024
1.9.0-beta-0003 101 9/16/2024
1.9.0-beta-0001 98 9/15/2024
1.9.0-beta 97 9/15/2024
1.8.1 130 9/14/2024
1.8.1-beta-0006 94 9/14/2024
1.8.1-beta-0005 112 9/14/2024
1.8.1-beta-0004 96 9/14/2024
1.8.1-beta-0003 94 9/14/2024
1.8.1-beta-0002 125 9/14/2024
1.8.1-beta-0001 93 9/14/2024
1.8.0 162 9/12/2024
1.8.0-beta-0064 107 9/12/2024
1.8.0-beta-0063 120 9/12/2024
1.8.0-beta-0059 93 9/8/2024
1.8.0-beta-0058 106 9/8/2024
1.8.0-beta-0057 112 9/8/2024
1.8.0-beta-0054 113 9/7/2024
1.8.0-beta-0053 114 9/6/2024
1.8.0-beta-0052 106 9/6/2024
1.8.0-beta-0051 118 9/6/2024
1.8.0-beta-0044 126 9/5/2024
1.8.0-beta-0042 103 9/4/2024
1.8.0-beta-0041 97 9/4/2024
1.8.0-beta-0027 133 8/25/2024
1.8.0-beta-0022 120 8/23/2024
1.8.0-beta-0017 105 8/7/2024
1.8.0-beta-0012 91 7/28/2024
1.8.0-beta-0010 102 7/28/2024
1.7.5 154 8/23/2024
1.7.4 145 8/9/2024
1.7.3 132 8/7/2024
1.7.2 105 7/28/2024
1.7.1 102 7/28/2024
1.7.0 150 7/20/2024
1.7.0-beta-0005 122 7/20/2024
1.7.0-beta-0001 109 7/8/2024
1.6.0 141 7/8/2024
1.6.0-beta-0004 113 7/7/2024
1.5.0 129 7/6/2024
1.5.0-beta-0010 124 7/6/2024
1.5.0-beta-0006 114 7/4/2024
1.4.5 143 7/4/2024
1.4.2 143 6/30/2024
1.4.1 145 6/30/2024
1.4.0 128 6/30/2024
1.4.0-beta-0010 124 6/30/2024
1.3.1 136 6/29/2024
1.3.0 137 6/29/2024
1.3.0-beta-0014 118 6/29/2024
1.3.0-beta-0007 108 6/26/2024
1.2.0 145 6/20/2024
1.2.0-beta-0001 115 6/20/2024
1.1.0 133 6/17/2024
1.1.0-beta-0019 113 6/20/2024
1.1.0-beta-0016 116 6/19/2024
1.1.0-beta-0014 127 6/17/2024
1.1.0-beta-0013 115 6/17/2024
1.0.0 148 6/15/2024
1.0.0-alpha-0054 121 6/15/2024
1.0.0-alpha-0053 115 6/12/2024
1.0.0-alpha-0051 115 6/12/2024
1.0.0-alpha-0048 121 6/10/2024
1.0.0-alpha-0047 113 6/10/2024
1.0.0-alpha-0043 124 6/9/2024
1.0.0-alpha-0042 126 6/7/2024
1.0.0-alpha-0040 125 6/6/2024
1.0.0-alpha-0038 124 6/6/2024
1.0.0-alpha-0036 123 6/5/2024
1.0.0-alpha-0034 135 6/4/2024
1.0.0-alpha-0031 117 6/4/2024
1.0.0-alpha-0025 124 6/3/2024
1.0.0-alpha-0023 123 6/2/2024
1.0.0-alpha-0022 120 6/1/2024
1.0.0-alpha-0019 127 6/1/2024
1.0.0-alpha-0018 120 6/1/2024
1.0.0-alpha-0014 133 6/1/2024
1.0.0-alpha-0013 114 6/1/2024
1.0.0-alpha-0012 117 5/31/2024
1.0.0-alpha-0011 121 5/31/2024
1.0.0-alpha-0010 124 5/31/2024