Shiny.Mediator 3.0.0-beta-0055

Prefix Reserved
This is a prerelease version of Shiny.Mediator.
There is a newer version of this package available.
See the version list below for details.
dotnet add package Shiny.Mediator --version 3.0.0-beta-0055
                    
NuGet\Install-Package Shiny.Mediator -Version 3.0.0-beta-0055
                    
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" Version="3.0.0-beta-0055" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="Shiny.Mediator" Version="3.0.0-beta-0055" />
                    
Directory.Packages.props
<PackageReference Include="Shiny.Mediator" />
                    
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 --version 3.0.0-beta-0055
                    
#r "nuget: Shiny.Mediator, 3.0.0-beta-0055"
                    
#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@3.0.0-beta-0055
                    
#: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&version=3.0.0-beta-0055&prerelease
                    
Install as a Cake Addin
#tool nuget:?package=Shiny.Mediator&version=3.0.0-beta-0055&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 net8.0 is compatible.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed.  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 (12)

Showing the top 5 NuGet packages that depend on Shiny.Mediator:

Package Downloads
Shiny.Mediator.Maui

Shiny Mediator - A mediator pattern for all .NET Apps

Shiny.Mediator.Blazor

Shiny Mediator - A mediator pattern for all .NET Apps

Shiny.Mediator.Resilience

Shiny Mediator - A mediator pattern for all .NET Apps

Shiny.Mediator.Prism

Shiny Mediator - A mediator pattern for all .NET Apps

Shiny.Mediator.AspNet

Shiny Mediator - A mediator pattern for all .NET Apps

GitHub repositories (1)

Showing the top 1 popular GitHub repositories that depend on Shiny.Mediator:

Repository Stars
shinyorg/templates
dotnet CLI & Visual Studio Templates
Version Downloads Last Updated
4.10.0-beta-0001 85 7/29/2025
4.9.1 125 7/29/2025
4.9.0 202 7/26/2025
4.9.0-beta-0005 484 7/22/2025
4.9.0-beta-0004 486 7/22/2025
4.9.0-beta-0003 485 7/22/2025
4.9.0-beta-0002 430 7/21/2025
4.9.0-beta-0001 357 7/21/2025
4.8.0 48 7/18/2025
4.8.0-beta-0004 38 7/18/2025
4.8.0-beta-0003 188 7/14/2025
4.8.0-beta-0002 175 7/14/2025
4.8.0-beta-0001 173 7/14/2025
4.7.0 422 6/25/2025
4.7.0-beta-0026 171 7/13/2025
4.7.0-beta-0025 175 7/10/2025
4.7.0-beta-0024 133 6/25/2025
4.7.0-beta-0023 180 6/25/2025
4.7.0-beta-0022 182 6/24/2025
4.7.0-beta-0021 183 6/23/2025
4.7.0-beta-0020 183 6/19/2025
4.7.0-beta-0004 182 6/19/2025
4.6.6 191 6/19/2025
4.6.5 185 6/19/2025
4.6.4 182 6/19/2025
4.6.3 428 6/18/2025
4.6.2 195 6/18/2025
4.6.1 217 6/16/2025
4.6.1-beta-0005 185 6/18/2025
4.6.1-beta-0003 185 6/18/2025
4.6.1-beta-0001 179 6/16/2025
4.6.0 190 6/16/2025
4.5.0 397 6/10/2025
4.5.0-beta-0007 331 6/10/2025
4.5.0-beta-0006 304 6/9/2025
4.5.0-beta-0004 141 6/6/2025
4.5.0-beta-0002 175 6/6/2025
4.4.0 428 6/3/2025
4.4.0-beta-0025 179 6/3/2025
4.4.0-beta-0023 185 5/29/2025
4.4.0-beta-0021 183 5/29/2025
4.4.0-beta-0018 191 5/26/2025
4.4.0-beta-0017 193 5/26/2025
4.4.0-beta-0015 182 5/26/2025
4.4.0-beta-0014 190 5/26/2025
4.4.0-beta-0004 147 5/25/2025
4.2.2 467 5/24/2025
4.2.1 355 5/8/2025
4.2.0 325 4/25/2025
4.2.0-beta-0010 202 5/8/2025
4.2.0-beta-0009 197 5/8/2025
4.2.0-beta-0008 162 4/25/2025
4.2.0-beta-0001 256 4/16/2025
4.1.0 510 3/28/2025
4.1.0-beta-0001 182 3/28/2025
4.0.4 491 3/24/2025
4.0.4-beta-0001 457 3/24/2025
4.0.3 319 3/23/2025
4.0.3-beta-0007 311 3/23/2025
4.0.2 289 3/15/2025
4.0.1 432 3/5/2025
4.0.1-beta-0010 205 3/19/2025
4.0.1-beta-0009 124 3/15/2025
4.0.1-beta-0001 280 3/5/2025
4.0.0 278 3/4/2025
4.0.0-beta-0021 265 3/4/2025
4.0.0-beta-0017 263 3/4/2025
4.0.0-beta-0016 270 3/4/2025
4.0.0-beta-0010 149 3/2/2025
4.0.0-beta-0009 146 3/2/2025
4.0.0-beta-0002 159 3/1/2025
3.3.1 333 2/20/2025
3.3.0 161 2/20/2025
3.3.0-beta-0028 148 2/20/2025
3.3.0-beta-0025 171 2/19/2025
3.3.0-beta-0024 194 2/19/2025
3.3.0-beta-0004 144 2/8/2025
3.2.0 429 1/29/2025
3.2.0-beta-0027 136 1/29/2025
3.2.0-beta-0023 144 1/29/2025
3.2.0-beta-0020 142 1/29/2025
3.1.3 145 1/29/2025
3.1.2 154 1/28/2025
3.1.1 169 1/25/2025
3.1.0 145 1/25/2025
3.1.0-beta-0013 139 1/25/2025
3.1.0-beta-0006 130 1/25/2025
3.1.0-beta-0004 131 1/25/2025
3.0.0 138 1/24/2025
3.0.0-beta-0055 139 1/24/2025
3.0.0-beta-0046 136 1/23/2025
3.0.0-beta-0045 135 1/23/2025
3.0.0-beta-0043 154 1/23/2025
3.0.0-beta-0038 156 1/21/2025
3.0.0-beta-0037 137 1/21/2025
3.0.0-beta-0029 139 1/21/2025
3.0.0-beta-0028 143 1/21/2025
3.0.0-beta-0018 130 1/19/2025
3.0.0-beta-0016 108 1/14/2025
3.0.0-beta-0012 128 1/12/2025
3.0.0-beta-0008 154 1/2/2025
3.0.0-beta-0007 143 12/28/2024
3.0.0-beta-0004 132 12/22/2024
2.2.0-beta-0001 350 10/28/2024
2.1.1 765 10/28/2024
2.1.0 300 10/19/2024
2.1.0-beta-0016 148 10/19/2024
2.1.0-beta-0015 147 10/19/2024
2.1.0-beta-0014 168 10/19/2024
2.1.0-beta-0013 164 10/19/2024
2.1.0-beta-0011 172 10/18/2024
2.1.0-beta-0010 167 10/18/2024
2.1.0-beta-0004 151 10/8/2024
2.1.0-beta-0002 146 10/6/2024
2.0.2 422 10/6/2024
2.0.1 168 10/6/2024
2.0.0 252 10/4/2024
2.0.0-beta-0060 145 10/6/2024
2.0.0-beta-0059 139 10/6/2024
2.0.0-beta-0056 145 10/4/2024
2.0.0-beta-0054 146 10/3/2024
2.0.0-beta-0053 149 10/2/2024
2.0.0-beta-0052 153 10/2/2024
2.0.0-beta-0050 151 10/2/2024
2.0.0-beta-0049 154 10/2/2024
2.0.0-beta-0046 162 10/1/2024
2.0.0-beta-0044 151 9/30/2024
2.0.0-beta-0026 158 9/24/2024
2.0.0-beta-0023 148 9/23/2024
2.0.0-beta-0022 131 9/23/2024
2.0.0-beta-0020 137 9/22/2024
2.0.0-beta-0004 141 9/20/2024
2.0.0-beta-0003 154 9/20/2024
1.9.0-beta-0003 159 9/16/2024
1.9.0-beta-0001 158 9/15/2024
1.9.0-beta 160 9/15/2024
1.8.1 351 9/14/2024
1.8.1-beta-0006 154 9/14/2024
1.8.1-beta-0005 158 9/14/2024
1.8.1-beta-0004 155 9/14/2024
1.8.1-beta-0003 150 9/14/2024
1.8.1-beta-0002 151 9/14/2024
1.8.1-beta-0001 157 9/14/2024
1.8.0 221 9/12/2024
1.8.0-beta-0064 158 9/12/2024
1.8.0-beta-0063 173 9/12/2024
1.8.0-beta-0059 171 9/8/2024
1.8.0-beta-0058 153 9/8/2024
1.8.0-beta-0057 171 9/8/2024
1.8.0-beta-0054 180 9/7/2024
1.8.0-beta-0053 178 9/6/2024
1.8.0-beta-0052 169 9/6/2024
1.8.0-beta-0051 169 9/6/2024
1.8.0-beta-0044 186 9/5/2024
1.8.0-beta-0042 173 9/4/2024
1.8.0-beta-0041 169 9/4/2024
1.8.0-beta-0027 188 8/25/2024
1.8.0-beta-0022 180 8/23/2024
1.8.0-beta-0017 169 8/7/2024
1.8.0-beta-0012 119 7/28/2024
1.8.0-beta-0010 107 7/28/2024
1.7.5 235 8/23/2024
1.7.4 338 8/9/2024
1.7.3 188 8/7/2024
1.7.2 160 7/28/2024
1.7.1 127 7/28/2024
1.7.0 199 7/20/2024
1.7.0-beta-0005 132 7/20/2024
1.7.0-beta-0001 153 7/8/2024
1.6.0 194 7/8/2024
1.6.0-beta-0004 142 7/7/2024
1.5.0 176 7/6/2024
1.5.0-beta-0010 154 7/6/2024
1.5.0-beta-0006 151 7/4/2024
1.4.5 165 7/4/2024
1.4.2 177 6/30/2024
1.4.1 179 6/30/2024
1.4.0 174 6/30/2024
1.4.0-beta-0010 163 6/30/2024
1.3.1 184 6/29/2024
1.3.0 167 6/29/2024
1.3.0-beta-0014 149 6/29/2024
1.3.0-beta-0007 138 6/26/2024
1.2.0 169 6/20/2024
1.2.0-beta-0001 133 6/20/2024
1.1.0 172 6/17/2024
1.1.0-beta-0019 136 6/20/2024
1.1.0-beta-0016 149 6/19/2024
1.1.0-beta-0014 145 6/17/2024
1.1.0-beta-0013 147 6/17/2024
1.0.0 203 6/15/2024
1.0.0-alpha-0054 140 6/15/2024
1.0.0-alpha-0053 148 6/12/2024
1.0.0-alpha-0051 128 6/12/2024
1.0.0-alpha-0048 146 6/10/2024
1.0.0-alpha-0047 141 6/10/2024
1.0.0-alpha-0043 124 6/9/2024
1.0.0-alpha-0042 173 6/7/2024
1.0.0-alpha-0040 145 6/6/2024
1.0.0-alpha-0038 141 6/6/2024
1.0.0-alpha-0036 132 6/5/2024
1.0.0-alpha-0034 150 6/4/2024
1.0.0-alpha-0031 134 6/4/2024
1.0.0-alpha-0025 131 6/3/2024
1.0.0-alpha-0023 148 6/2/2024
1.0.0-alpha-0022 144 6/1/2024
1.0.0-alpha-0019 142 6/1/2024
1.0.0-alpha-0018 134 6/1/2024
1.0.0-alpha-0014 137 6/1/2024
1.0.0-alpha-0013 127 6/1/2024
1.0.0-alpha-0012 136 5/31/2024
1.0.0-alpha-0011 124 5/31/2024
1.0.0-alpha-0010 128 5/31/2024