Shiny.Mediator.Blazor 4.0.0-beta-0021

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.0-beta-0021
                    
NuGet\Install-Package Shiny.Mediator.Blazor -Version 4.0.0-beta-0021
                    
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.0-beta-0021" />
                    
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.0-beta-0021" />
                    
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.0-beta-0021
                    
#r "nuget: Shiny.Mediator.Blazor, 4.0.0-beta-0021"
                    
#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.0-beta-0021
                    
#: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.0-beta-0021&prerelease
                    
Install as a Cake Addin
#tool nuget:?package=Shiny.Mediator.Blazor&version=4.0.0-beta-0021&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-0020 173 9/19/2025
4.10.0-beta-0019 239 9/18/2025
4.10.0-beta-0018 239 9/18/2025
4.10.0-beta-0017 235 9/18/2025
4.10.0-beta-0016 242 9/18/2025
4.10.0-beta-0015 242 9/18/2025
4.10.0-beta-0014 243 9/18/2025
4.10.0-beta-0013 242 9/18/2025
4.10.0-beta-0012 253 9/18/2025
4.10.0-beta-0011 261 9/16/2025
4.10.0-beta-0010 259 9/16/2025
4.10.0-beta-0009 125 9/10/2025
4.10.0-beta-0008 123 9/10/2025
4.10.0-beta-0007 128 9/9/2025
4.10.0-beta-0006 175 8/28/2025
4.10.0-beta-0005 86 8/22/2025
4.10.0-beta-0004 119 8/22/2025
4.10.0-beta-0003 123 8/18/2025
4.10.0-beta-0002 122 8/18/2025
4.10.0-beta-0001 95 7/29/2025
4.9.1 109 7/29/2025
4.9.0 209 7/26/2025
4.9.0-beta-0005 534 7/22/2025
4.9.0-beta-0004 532 7/22/2025
4.9.0-beta-0003 528 7/22/2025
4.9.0-beta-0002 478 7/21/2025
4.9.0-beta-0001 405 7/21/2025
4.8.0 90 7/18/2025
4.8.0-beta-0004 83 7/18/2025
4.8.0-beta-0003 150 7/14/2025
4.8.0-beta-0002 139 7/14/2025
4.8.0-beta-0001 137 7/14/2025
4.7.0 158 6/25/2025
4.7.0-beta-0026 133 7/13/2025
4.7.0-beta-0025 137 7/10/2025
4.7.0-beta-0023 146 6/25/2025
4.7.0-beta-0022 139 6/24/2025
4.7.0-beta-0021 152 6/23/2025
4.7.0-beta-0020 148 6/19/2025
4.7.0-beta-0004 140 6/19/2025
4.6.6 150 6/19/2025
4.6.5 141 6/19/2025
4.6.4 142 6/19/2025
4.6.3 145 6/18/2025
4.6.2 142 6/18/2025
4.6.1 160 6/16/2025
4.6.1-beta-0005 148 6/18/2025
4.6.1-beta-0003 145 6/18/2025
4.6.1-beta-0001 145 6/16/2025
4.6.0 151 6/16/2025
4.5.0 303 6/10/2025
4.5.0-beta-0007 290 6/10/2025
4.5.0-beta-0006 275 6/9/2025
4.5.0-beta-0004 98 6/6/2025
4.5.0-beta-0002 137 6/6/2025
4.4.0 160 6/3/2025
4.4.0-beta-0025 153 6/3/2025
4.4.0-beta-0023 160 5/29/2025
4.4.0-beta-0021 153 5/29/2025
4.4.0-beta-0018 153 5/26/2025
4.4.0-beta-0017 156 5/26/2025
4.4.0-beta-0015 147 5/26/2025
4.4.0-beta-0014 146 5/26/2025
4.4.0-beta-0004 105 5/25/2025
4.2.2 89 5/24/2025
4.2.1 188 5/8/2025
4.2.0 119 4/25/2025
4.2.0-beta-0010 160 5/8/2025
4.2.0-beta-0009 145 5/8/2025
4.2.0-beta-0008 117 4/25/2025
4.2.0-beta-0001 196 4/16/2025
4.1.0 178 3/28/2025
4.1.0-beta-0001 150 3/28/2025
4.0.4 427 3/24/2025
4.0.4-beta-0001 401 3/24/2025
4.0.3 285 3/23/2025
4.0.3-beta-0007 275 3/23/2025
4.0.2 96 3/15/2025
4.0.1 223 3/5/2025
4.0.1-beta-0010 163 3/19/2025
4.0.1-beta-0009 79 3/15/2025
4.0.1-beta-0001 213 3/5/2025
4.0.0 219 3/4/2025
4.0.0-beta-0021 212 3/4/2025
4.0.0-beta-0017 219 3/4/2025
4.0.0-beta-0016 207 3/4/2025
4.0.0-beta-0010 104 3/2/2025
4.0.0-beta-0009 100 3/2/2025
4.0.0-beta-0002 97 3/1/2025
3.3.1 132 2/20/2025
3.3.0 118 2/20/2025
3.3.0-beta-0028 104 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 109 2/8/2025
3.2.0 112 1/29/2025
3.2.0-beta-0027 95 1/29/2025
3.2.0-beta-0023 92 1/29/2025
3.2.0-beta-0020 100 1/29/2025
3.1.3 108 1/29/2025
3.1.2 112 1/28/2025
3.1.1 117 1/25/2025
3.1.0 106 1/25/2025
3.1.0-beta-0013 91 1/25/2025
3.1.0-beta-0006 95 1/25/2025
3.1.0-beta-0004 97 1/25/2025
3.0.0 111 1/24/2025
3.0.0-beta-0055 102 1/24/2025
3.0.0-beta-0046 97 1/23/2025
3.0.0-beta-0045 87 1/23/2025
3.0.0-beta-0043 102 1/23/2025
3.0.0-beta-0038 96 1/21/2025
3.0.0-beta-0037 110 1/21/2025
3.0.0-beta-0029 108 1/21/2025
3.0.0-beta-0028 106 1/21/2025
3.0.0-beta-0018 85 1/19/2025
3.0.0-beta-0016 84 1/14/2025
3.0.0-beta-0012 109 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 113 12/22/2024
2.2.0-beta-0001 101 10/28/2024
2.1.1 140 10/28/2024
2.1.0 132 10/19/2024
2.1.0-beta-0016 98 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 144 10/18/2024
2.1.0-beta-0010 131 10/18/2024
2.1.0-beta-0004 101 10/8/2024
2.1.0-beta-0002 95 10/6/2024
2.0.2 133 10/6/2024
2.0.1 129 10/6/2024
2.0.0 128 10/4/2024
2.0.0-beta-0060 97 10/6/2024
2.0.0-beta-0059 103 10/6/2024
2.0.0-beta-0056 102 10/4/2024
2.0.0-beta-0054 115 10/3/2024
2.0.0-beta-0053 111 10/2/2024
2.0.0-beta-0052 116 10/2/2024
2.0.0-beta-0050 104 10/2/2024
2.0.0-beta-0049 109 10/2/2024
2.0.0-beta-0046 107 10/1/2024
2.0.0-beta-0044 113 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 90 9/23/2024
2.0.0-beta-0020 106 9/22/2024
2.0.0-beta-0004 94 9/20/2024
2.0.0-beta-0003 104 9/20/2024
1.9.0-beta-0003 105 9/16/2024
1.9.0-beta-0001 102 9/15/2024
1.9.0-beta 97 9/15/2024
1.8.1 136 9/14/2024
1.8.1-beta-0006 96 9/14/2024
1.8.1-beta-0005 116 9/14/2024
1.8.1-beta-0004 96 9/14/2024
1.8.1-beta-0003 97 9/14/2024
1.8.1-beta-0002 132 9/14/2024
1.8.1-beta-0001 100 9/14/2024
1.8.0 166 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 111 9/8/2024
1.8.0-beta-0057 113 9/8/2024
1.8.0-beta-0054 113 9/7/2024
1.8.0-beta-0053 115 9/6/2024
1.8.0-beta-0052 106 9/6/2024
1.8.0-beta-0051 125 9/6/2024
1.8.0-beta-0044 127 9/5/2024
1.8.0-beta-0042 103 9/4/2024
1.8.0-beta-0041 102 9/4/2024
1.8.0-beta-0027 136 8/25/2024
1.8.0-beta-0022 129 8/23/2024
1.8.0-beta-0017 108 8/7/2024
1.8.0-beta-0012 92 7/28/2024
1.8.0-beta-0010 111 7/28/2024
1.7.5 158 8/23/2024
1.7.4 151 8/9/2024
1.7.3 143 8/7/2024
1.7.2 105 7/28/2024
1.7.1 106 7/28/2024
1.7.0 155 7/20/2024
1.7.0-beta-0005 128 7/20/2024
1.7.0-beta-0001 110 7/8/2024
1.6.0 143 7/8/2024
1.6.0-beta-0004 120 7/7/2024
1.5.0 129 7/6/2024
1.5.0-beta-0010 130 7/6/2024
1.5.0-beta-0006 114 7/4/2024
1.4.5 144 7/4/2024
1.4.2 148 6/30/2024
1.4.1 149 6/30/2024
1.4.0 129 6/30/2024
1.4.0-beta-0010 129 6/30/2024
1.3.1 136 6/29/2024
1.3.0 138 6/29/2024
1.3.0-beta-0014 118 6/29/2024
1.3.0-beta-0007 113 6/26/2024
1.2.0 147 6/20/2024
1.2.0-beta-0001 115 6/20/2024
1.1.0 138 6/17/2024
1.1.0-beta-0019 119 6/20/2024
1.1.0-beta-0016 116 6/19/2024
1.1.0-beta-0014 134 6/17/2024
1.1.0-beta-0013 120 6/17/2024
1.0.0 150 6/15/2024
1.0.0-alpha-0054 124 6/15/2024
1.0.0-alpha-0053 119 6/12/2024
1.0.0-alpha-0051 115 6/12/2024
1.0.0-alpha-0048 122 6/10/2024
1.0.0-alpha-0047 121 6/10/2024
1.0.0-alpha-0043 129 6/9/2024
1.0.0-alpha-0042 131 6/7/2024
1.0.0-alpha-0040 133 6/6/2024
1.0.0-alpha-0038 131 6/6/2024
1.0.0-alpha-0036 124 6/5/2024
1.0.0-alpha-0034 142 6/4/2024
1.0.0-alpha-0031 117 6/4/2024
1.0.0-alpha-0025 127 6/3/2024
1.0.0-alpha-0023 130 6/2/2024
1.0.0-alpha-0022 129 6/1/2024
1.0.0-alpha-0019 134 6/1/2024
1.0.0-alpha-0018 124 6/1/2024
1.0.0-alpha-0014 139 6/1/2024
1.0.0-alpha-0013 117 6/1/2024
1.0.0-alpha-0012 119 5/31/2024
1.0.0-alpha-0011 121 5/31/2024
1.0.0-alpha-0010 124 5/31/2024