Shiny.Mediator.AppSupport 4.9.0-beta-0003

Prefix Reserved
This is a prerelease version of Shiny.Mediator.AppSupport.
There is a newer version of this package available.
See the version list below for details.
dotnet add package Shiny.Mediator.AppSupport --version 4.9.0-beta-0003
                    
NuGet\Install-Package Shiny.Mediator.AppSupport -Version 4.9.0-beta-0003
                    
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.AppSupport" Version="4.9.0-beta-0003" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="Shiny.Mediator.AppSupport" Version="4.9.0-beta-0003" />
                    
Directory.Packages.props
<PackageReference Include="Shiny.Mediator.AppSupport" />
                    
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.AppSupport --version 4.9.0-beta-0003
                    
#r "nuget: Shiny.Mediator.AppSupport, 4.9.0-beta-0003"
                    
#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.AppSupport@4.9.0-beta-0003
                    
#: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.AppSupport&version=4.9.0-beta-0003&prerelease
                    
Install as a Cake Addin
#tool nuget:?package=Shiny.Mediator.AppSupport&version=4.9.0-beta-0003&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 (3)

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

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.Uno

Shiny Mediator - A mediator pattern for all .NET Apps

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
4.10.0-beta-0020 182 9/19/2025
4.10.0-beta-0019 251 9/18/2025
4.10.0-beta-0018 246 9/18/2025
4.10.0-beta-0017 247 9/18/2025
4.10.0-beta-0016 251 9/18/2025
4.10.0-beta-0015 248 9/18/2025
4.10.0-beta-0014 252 9/18/2025
4.10.0-beta-0013 251 9/18/2025
4.10.0-beta-0012 254 9/18/2025
4.10.0-beta-0011 284 9/16/2025
4.10.0-beta-0010 279 9/16/2025
4.10.0-beta-0009 148 9/10/2025
4.10.0-beta-0008 133 9/10/2025
4.10.0-beta-0007 139 9/9/2025
4.10.0-beta-0006 184 8/28/2025
4.10.0-beta-0005 101 8/22/2025
4.10.0-beta-0004 132 8/22/2025
4.10.0-beta-0003 139 8/18/2025
4.10.0-beta-0002 134 8/18/2025
4.10.0-beta-0001 102 7/29/2025
4.9.1 296 7/29/2025
4.9.0 218 7/26/2025
4.9.0-beta-0005 548 7/22/2025
4.9.0-beta-0004 536 7/22/2025
4.9.0-beta-0003 535 7/22/2025
4.9.0-beta-0002 496 7/21/2025
4.9.0-beta-0001 424 7/21/2025
4.8.0 120 7/18/2025
4.8.0-beta-0004 103 7/18/2025
4.8.0-beta-0003 173 7/14/2025
4.8.0-beta-0002 157 7/14/2025
4.8.0-beta-0001 147 7/14/2025
4.7.0 291 6/25/2025
4.7.0-beta-0026 153 7/13/2025
4.7.0-beta-0025 154 7/10/2025
4.7.0-beta-0024 141 6/25/2025
4.7.0-beta-0023 157 6/25/2025
4.7.0-beta-0022 152 6/24/2025
4.7.0-beta-0021 161 6/23/2025
4.7.0-beta-0020 155 6/19/2025
4.7.0-beta-0004 156 6/19/2025
4.6.6 174 6/19/2025
4.6.5 158 6/19/2025
4.6.4 158 6/19/2025
4.6.3 169 6/18/2025
4.6.2 168 6/18/2025
4.6.1 181 6/16/2025
4.6.1-beta-0005 163 6/18/2025
4.6.1-beta-0003 159 6/18/2025
4.6.1-beta-0001 155 6/16/2025
4.6.0 160 6/16/2025
4.5.0 310 6/10/2025
4.5.0-beta-0007 298 6/10/2025
4.5.0-beta-0006 284 6/9/2025
4.5.0-beta-0004 121 6/6/2025
4.5.0-beta-0002 153 6/6/2025
4.4.0 284 6/3/2025
4.4.0-beta-0025 169 6/3/2025
4.4.0-beta-0023 159 5/29/2025
4.4.0-beta-0021 162 5/29/2025
4.4.0-beta-0018 173 5/26/2025
4.4.0-beta-0017 162 5/26/2025
4.4.0-beta-0015 169 5/26/2025
4.4.0-beta-0014 168 5/26/2025
4.4.0-beta-0004 123 5/25/2025
4.2.2 241 5/24/2025
4.2.1 263 5/8/2025
4.2.0 253 4/25/2025
4.2.0-beta-0010 169 5/8/2025
4.2.0-beta-0009 158 5/8/2025
4.2.0-beta-0008 122 4/25/2025
4.2.0-beta-0001 226 4/16/2025
4.1.0 245 3/28/2025
4.1.0-beta-0001 154 3/28/2025
4.0.4 445 3/24/2025
4.0.4-beta-0001 417 3/24/2025
4.0.3 298 3/23/2025
4.0.3-beta-0007 287 3/23/2025
4.0.2 176 3/15/2025
4.0.1 265 3/5/2025
4.0.1-beta-0010 178 3/19/2025
4.0.1-beta-0009 93 3/15/2025
4.0.1-beta-0001 230 3/5/2025
4.0.0 249 3/4/2025
4.0.0-beta-0021 240 3/4/2025
4.0.0-beta-0017 220 3/4/2025
4.0.0-beta-0016 228 3/4/2025
4.0.0-beta-0010 115 3/2/2025
4.0.0-beta-0009 122 3/2/2025
4.0.0-beta-0002 117 3/1/2025
3.3.1 244 2/20/2025
3.3.0 131 2/20/2025
3.3.0-beta-0028 111 2/20/2025
3.3.0-beta-0025 134 2/19/2025
3.3.0-beta-0024 126 2/19/2025
3.3.0-beta-0004 109 2/8/2025
3.2.0 219 1/29/2025
3.2.0-beta-0027 102 1/29/2025
3.2.0-beta-0023 96 1/29/2025
3.2.0-beta-0020 97 1/29/2025
3.1.3 135 1/29/2025
3.1.2 116 1/28/2025
3.1.1 115 1/25/2025
3.1.0 131 1/25/2025
3.1.0-beta-0013 104 1/25/2025
3.1.0-beta-0006 107 1/25/2025
3.1.0-beta-0004 114 1/25/2025
3.0.0 117 1/24/2025
3.0.0-beta-0055 111 1/24/2025
3.0.0-beta-0046 110 1/23/2025
3.0.0-beta-0045 109 1/23/2025
3.0.0-beta-0043 110 1/23/2025
3.0.0-beta-0038 112 1/21/2025
3.0.0-beta-0037 104 1/21/2025
3.0.0-beta-0029 102 1/21/2025
3.0.0-beta-0028 116 1/21/2025
3.0.0-beta-0018 107 1/19/2025
3.0.0-beta-0016 81 1/14/2025
3.0.0-beta-0012 99 1/12/2025
3.0.0-beta-0008 108 1/2/2025
3.0.0-beta-0007 115 12/28/2024
3.0.0-beta-0004 111 12/22/2024
2.2.0-beta-0001 313 10/28/2024
2.1.1 549 10/28/2024
2.1.0 275 10/19/2024
2.1.0-beta-0016 115 10/19/2024
2.1.0-beta-0015 121 10/19/2024
2.1.0-beta-0014 139 10/19/2024
2.1.0-beta-0013 123 10/19/2024
2.1.0-beta-0011 144 10/18/2024
2.1.0-beta-0010 143 10/18/2024
2.1.0-beta-0004 112 10/8/2024
2.1.0-beta-0002 109 10/6/2024
2.0.2 159 10/6/2024
2.0.1 126 10/6/2024
2.0.0 200 10/4/2024
2.0.0-beta-0060 114 10/6/2024
2.0.0-beta-0059 108 10/6/2024
2.0.0-beta-0056 106 10/4/2024
2.0.0-beta-0054 123 10/3/2024
2.0.0-beta-0053 107 10/2/2024
2.0.0-beta-0052 124 10/2/2024
2.0.0-beta-0050 111 10/2/2024
2.0.0-beta-0049 119 10/2/2024
2.0.0-beta-0046 122 10/1/2024
2.0.0-beta-0044 127 9/30/2024
2.0.0-beta-0026 129 9/24/2024
2.0.0-beta-0023 116 9/23/2024
2.0.0-beta-0022 104 9/23/2024
2.0.0-beta-0020 134 9/22/2024
2.0.0-beta-0004 118 9/20/2024
2.0.0-beta-0003 119 9/20/2024