Shiny.Mediator 4.0.0-beta-0009

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 4.0.0-beta-0009
                    
NuGet\Install-Package Shiny.Mediator -Version 4.0.0-beta-0009
                    
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="4.0.0-beta-0009" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="Shiny.Mediator" Version="4.0.0-beta-0009" />
                    
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 4.0.0-beta-0009
                    
#r "nuget: Shiny.Mediator, 4.0.0-beta-0009"
                    
#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@4.0.0-beta-0009
                    
#: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=4.0.0-beta-0009&prerelease
                    
Install as a Cake Addin
#tool nuget:?package=Shiny.Mediator&version=4.0.0-beta-0009&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

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
4.10.0-beta-0020 328 9/19/2025
4.10.0-beta-0019 394 9/18/2025
4.10.0-beta-0018 388 9/18/2025
4.10.0-beta-0017 390 9/18/2025
4.10.0-beta-0016 387 9/18/2025
4.10.0-beta-0015 378 9/18/2025
4.10.0-beta-0014 382 9/18/2025
4.10.0-beta-0013 388 9/18/2025
4.10.0-beta-0012 384 9/18/2025
4.10.0-beta-0011 367 9/16/2025
4.10.0-beta-0010 381 9/16/2025
4.10.0-beta-0009 245 9/10/2025
4.10.0-beta-0008 225 9/10/2025
4.10.0-beta-0007 228 9/9/2025
4.10.0-beta-0006 310 8/28/2025
4.10.0-beta-0005 194 8/22/2025
4.10.0-beta-0004 215 8/22/2025
4.10.0-beta-0003 233 8/18/2025
4.10.0-beta-0002 227 8/18/2025
4.10.0-beta-0001 188 7/29/2025
4.9.1 755 7/29/2025
4.9.0 301 7/26/2025
4.9.0-beta-0005 634 7/22/2025
4.9.0-beta-0004 638 7/22/2025
4.9.0-beta-0003 630 7/22/2025
4.9.0-beta-0002 593 7/21/2025
4.9.0-beta-0001 521 7/21/2025
4.8.0 369 7/18/2025
4.8.0-beta-0004 187 7/18/2025
4.8.0-beta-0003 259 7/14/2025
4.8.0-beta-0002 246 7/14/2025
4.8.0-beta-0001 243 7/14/2025
4.7.0 506 6/25/2025
4.7.0-beta-0026 238 7/13/2025
4.7.0-beta-0025 238 7/10/2025
4.7.0-beta-0024 160 6/25/2025
4.7.0-beta-0023 248 6/25/2025
4.7.0-beta-0022 246 6/24/2025
4.7.0-beta-0021 254 6/23/2025
4.7.0-beta-0020 253 6/19/2025
4.7.0-beta-0004 260 6/19/2025
4.6.6 283 6/19/2025
4.6.5 252 6/19/2025
4.6.4 253 6/19/2025
4.6.3 569 6/18/2025
4.6.2 268 6/18/2025
4.6.1 292 6/16/2025
4.6.1-beta-0005 255 6/18/2025
4.6.1-beta-0003 235 6/18/2025
4.6.1-beta-0001 252 6/16/2025
4.6.0 268 6/16/2025
4.5.0 460 6/10/2025
4.5.0-beta-0007 391 6/10/2025
4.5.0-beta-0006 362 6/9/2025
4.5.0-beta-0004 214 6/6/2025
4.5.0-beta-0002 245 6/6/2025
4.4.0 512 6/3/2025
4.4.0-beta-0025 249 6/3/2025
4.4.0-beta-0023 249 5/29/2025
4.4.0-beta-0021 253 5/29/2025
4.4.0-beta-0018 263 5/26/2025
4.4.0-beta-0017 266 5/26/2025
4.4.0-beta-0015 247 5/26/2025
4.4.0-beta-0014 242 5/26/2025
4.4.0-beta-0004 224 5/25/2025
4.2.2 551 5/24/2025
4.2.1 442 5/8/2025
4.2.0 401 4/25/2025
4.2.0-beta-0010 276 5/8/2025
4.2.0-beta-0009 268 5/8/2025
4.2.0-beta-0008 245 4/25/2025
4.2.0-beta-0001 326 4/16/2025
4.1.0 588 3/28/2025
4.1.0-beta-0001 263 3/28/2025
4.0.4 567 3/24/2025
4.0.4-beta-0001 542 3/24/2025
4.0.3 385 3/23/2025
4.0.3-beta-0007 380 3/23/2025
4.0.2 366 3/15/2025
4.0.1 511 3/5/2025
4.0.1-beta-0010 288 3/19/2025
4.0.1-beta-0009 188 3/15/2025
4.0.1-beta-0001 345 3/5/2025
4.0.0 354 3/4/2025
4.0.0-beta-0021 339 3/4/2025
4.0.0-beta-0017 337 3/4/2025
4.0.0-beta-0016 341 3/4/2025
4.0.0-beta-0010 218 3/2/2025
4.0.0-beta-0009 223 3/2/2025
4.0.0-beta-0002 245 3/1/2025
3.3.1 407 2/20/2025
3.3.0 238 2/20/2025
3.3.0-beta-0028 209 2/20/2025
3.3.0-beta-0025 244 2/19/2025
3.3.0-beta-0024 274 2/19/2025
3.3.0-beta-0004 215 2/8/2025
3.2.0 501 1/29/2025
3.2.0-beta-0027 208 1/29/2025
3.2.0-beta-0023 204 1/29/2025
3.2.0-beta-0020 214 1/29/2025
3.1.3 206 1/29/2025
3.1.2 224 1/28/2025
3.1.1 239 1/25/2025
3.1.0 205 1/25/2025
3.1.0-beta-0013 211 1/25/2025
3.1.0-beta-0006 192 1/25/2025
3.1.0-beta-0004 188 1/25/2025
3.0.0 208 1/24/2025
3.0.0-beta-0055 212 1/24/2025
3.0.0-beta-0046 203 1/23/2025
3.0.0-beta-0045 199 1/23/2025
3.0.0-beta-0043 223 1/23/2025
3.0.0-beta-0038 225 1/21/2025
3.0.0-beta-0037 199 1/21/2025
3.0.0-beta-0029 212 1/21/2025
3.0.0-beta-0028 215 1/21/2025
3.0.0-beta-0018 199 1/19/2025
3.0.0-beta-0016 194 1/14/2025
3.0.0-beta-0012 196 1/12/2025
3.0.0-beta-0008 227 1/2/2025
3.0.0-beta-0007 195 12/28/2024
3.0.0-beta-0004 177 12/22/2024
2.2.0-beta-0001 429 10/28/2024
2.1.1 862 10/28/2024
2.1.0 362 10/19/2024
2.1.0-beta-0016 207 10/19/2024
2.1.0-beta-0015 224 10/19/2024
2.1.0-beta-0014 233 10/19/2024
2.1.0-beta-0013 235 10/19/2024
2.1.0-beta-0011 239 10/18/2024
2.1.0-beta-0010 224 10/18/2024
2.1.0-beta-0004 227 10/8/2024
2.1.0-beta-0002 209 10/6/2024
2.0.2 487 10/6/2024
2.0.1 230 10/6/2024
2.0.0 325 10/4/2024
2.0.0-beta-0060 214 10/6/2024
2.0.0-beta-0059 199 10/6/2024
2.0.0-beta-0056 213 10/4/2024
2.0.0-beta-0054 224 10/3/2024
2.0.0-beta-0053 216 10/2/2024
2.0.0-beta-0052 222 10/2/2024
2.0.0-beta-0050 208 10/2/2024
2.0.0-beta-0049 225 10/2/2024
2.0.0-beta-0046 230 10/1/2024
2.0.0-beta-0044 226 9/30/2024
2.0.0-beta-0026 224 9/24/2024
2.0.0-beta-0023 225 9/23/2024
2.0.0-beta-0022 190 9/23/2024
2.0.0-beta-0020 190 9/22/2024
2.0.0-beta-0004 188 9/20/2024
2.0.0-beta-0003 220 9/20/2024
1.9.0-beta-0003 220 9/16/2024
1.9.0-beta-0001 224 9/15/2024
1.9.0-beta 223 9/15/2024
1.8.1 403 9/14/2024
1.8.1-beta-0006 221 9/14/2024
1.8.1-beta-0005 191 9/14/2024
1.8.1-beta-0004 221 9/14/2024
1.8.1-beta-0003 206 9/14/2024
1.8.1-beta-0002 209 9/14/2024
1.8.1-beta-0001 204 9/14/2024
1.8.0 275 9/12/2024
1.8.0-beta-0064 218 9/12/2024
1.8.0-beta-0063 230 9/12/2024
1.8.0-beta-0059 221 9/8/2024
1.8.0-beta-0058 209 9/8/2024
1.8.0-beta-0057 237 9/8/2024
1.8.0-beta-0054 233 9/7/2024
1.8.0-beta-0053 242 9/6/2024
1.8.0-beta-0052 228 9/6/2024
1.8.0-beta-0051 227 9/6/2024
1.8.0-beta-0044 244 9/5/2024
1.8.0-beta-0042 245 9/4/2024
1.8.0-beta-0041 225 9/4/2024
1.8.0-beta-0027 248 8/25/2024
1.8.0-beta-0022 234 8/23/2024
1.8.0-beta-0017 222 8/7/2024
1.8.0-beta-0012 186 7/28/2024
1.8.0-beta-0010 151 7/28/2024
1.7.5 289 8/23/2024
1.7.4 387 8/9/2024
1.7.3 241 8/7/2024
1.7.2 219 7/28/2024
1.7.1 177 7/28/2024
1.7.0 257 7/20/2024
1.7.0-beta-0005 183 7/20/2024
1.7.0-beta-0001 202 7/8/2024
1.6.0 251 7/8/2024
1.6.0-beta-0004 198 7/7/2024
1.5.0 221 7/6/2024
1.5.0-beta-0010 202 7/6/2024
1.5.0-beta-0006 200 7/4/2024
1.4.5 197 7/4/2024
1.4.2 232 6/30/2024
1.4.1 231 6/30/2024
1.4.0 220 6/30/2024
1.4.0-beta-0010 219 6/30/2024
1.3.1 229 6/29/2024
1.3.0 204 6/29/2024
1.3.0-beta-0014 189 6/29/2024
1.3.0-beta-0007 176 6/26/2024
1.2.0 214 6/20/2024
1.2.0-beta-0001 171 6/20/2024
1.1.0 210 6/17/2024
1.1.0-beta-0019 183 6/20/2024
1.1.0-beta-0016 188 6/19/2024
1.1.0-beta-0014 166 6/17/2024
1.1.0-beta-0013 182 6/17/2024
1.0.0 237 6/15/2024
1.0.0-alpha-0054 162 6/15/2024
1.0.0-alpha-0053 186 6/12/2024
1.0.0-alpha-0051 151 6/12/2024
1.0.0-alpha-0048 174 6/10/2024
1.0.0-alpha-0047 162 6/10/2024
1.0.0-alpha-0043 148 6/9/2024
1.0.0-alpha-0042 212 6/7/2024
1.0.0-alpha-0040 180 6/6/2024
1.0.0-alpha-0038 169 6/6/2024
1.0.0-alpha-0036 168 6/5/2024
1.0.0-alpha-0034 172 6/4/2024
1.0.0-alpha-0031 149 6/4/2024
1.0.0-alpha-0025 147 6/3/2024
1.0.0-alpha-0023 184 6/2/2024
1.0.0-alpha-0022 172 6/1/2024
1.0.0-alpha-0019 175 6/1/2024
1.0.0-alpha-0018 160 6/1/2024
1.0.0-alpha-0014 166 6/1/2024
1.0.0-alpha-0013 153 6/1/2024
1.0.0-alpha-0012 159 5/31/2024
1.0.0-alpha-0011 147 5/31/2024
1.0.0-alpha-0010 135 5/31/2024