Shiny.Mediator 4.10.0-beta-0017

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

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
5.0.0-beta-0011 0 10/22/2025
5.0.0-beta-0010 0 10/22/2025
5.0.0-beta-0009 67 10/21/2025
5.0.0-beta-0008 117 10/19/2025
5.0.0-beta-0007 99 10/18/2025
5.0.0-beta-0006 125 10/17/2025
5.0.0-beta-0005 181 10/17/2025
5.0.0-beta-0004 293 10/10/2025
5.0.0-beta-0003 301 10/9/2025
5.0.0-beta-0002 290 10/8/2025
5.0.0-beta-0001 302 10/7/2025
4.10.0-beta-0020 364 9/19/2025
4.10.0-beta-0019 427 9/18/2025
4.10.0-beta-0018 417 9/18/2025
4.10.0-beta-0017 421 9/18/2025
4.10.0-beta-0016 421 9/18/2025
4.10.0-beta-0015 412 9/18/2025
4.10.0-beta-0014 416 9/18/2025
4.10.0-beta-0013 415 9/18/2025
4.10.0-beta-0012 414 9/18/2025
4.10.0-beta-0011 388 9/16/2025
4.10.0-beta-0010 398 9/16/2025
4.10.0-beta-0009 276 9/10/2025
4.10.0-beta-0008 246 9/10/2025
4.10.0-beta-0007 259 9/9/2025
4.10.0-beta-0006 341 8/28/2025
4.10.0-beta-0005 227 8/22/2025
4.10.0-beta-0004 236 8/22/2025
4.10.0-beta-0003 264 8/18/2025
4.10.0-beta-0002 238 8/18/2025
4.10.0-beta-0001 216 7/29/2025
4.9.1 978 7/29/2025
4.9.0 329 7/26/2025
4.9.0-beta-0005 662 7/22/2025
4.9.0-beta-0004 663 7/22/2025
4.9.0-beta-0003 658 7/22/2025
4.9.0-beta-0002 617 7/21/2025
4.9.0-beta-0001 549 7/21/2025
4.8.0 458 7/18/2025
4.8.0-beta-0004 213 7/18/2025
4.8.0-beta-0003 287 7/14/2025
4.8.0-beta-0002 274 7/14/2025
4.8.0-beta-0001 269 7/14/2025
4.7.0 538 6/25/2025
4.7.0-beta-0026 262 7/13/2025
4.7.0-beta-0025 263 7/10/2025
4.7.0-beta-0024 171 6/25/2025
4.7.0-beta-0023 264 6/25/2025
4.7.0-beta-0022 271 6/24/2025
4.7.0-beta-0021 282 6/23/2025
4.7.0-beta-0020 276 6/19/2025
4.7.0-beta-0004 281 6/19/2025
4.6.6 310 6/19/2025
4.6.5 279 6/19/2025
4.6.4 280 6/19/2025
4.6.3 599 6/18/2025
4.6.2 296 6/18/2025
4.6.1 318 6/16/2025
4.6.1-beta-0005 287 6/18/2025
4.6.1-beta-0003 262 6/18/2025
4.6.1-beta-0001 283 6/16/2025
4.6.0 294 6/16/2025
4.5.0 481 6/10/2025
4.5.0-beta-0007 419 6/10/2025
4.5.0-beta-0006 387 6/9/2025
4.5.0-beta-0004 246 6/6/2025
4.5.0-beta-0002 274 6/6/2025
4.4.0 525 6/3/2025
4.4.0-beta-0025 280 6/3/2025
4.4.0-beta-0023 274 5/29/2025
4.4.0-beta-0021 284 5/29/2025
4.4.0-beta-0018 292 5/26/2025
4.4.0-beta-0017 295 5/26/2025
4.4.0-beta-0015 278 5/26/2025
4.4.0-beta-0014 268 5/26/2025
4.4.0-beta-0004 253 5/25/2025
4.2.2 585 5/24/2025
4.2.1 475 5/8/2025
4.2.0 437 4/25/2025
4.2.0-beta-0010 310 5/8/2025
4.2.0-beta-0009 299 5/8/2025
4.2.0-beta-0008 275 4/25/2025
4.2.0-beta-0001 359 4/16/2025
4.1.0 623 3/28/2025
4.1.0-beta-0001 296 3/28/2025
4.0.4 601 3/24/2025
4.0.4-beta-0001 581 3/24/2025
4.0.3 401 3/23/2025
4.0.3-beta-0007 410 3/23/2025
4.0.2 398 3/15/2025
4.0.1 531 3/5/2025
4.0.1-beta-0010 322 3/19/2025
4.0.1-beta-0009 222 3/15/2025
4.0.1-beta-0001 372 3/5/2025
4.0.0 374 3/4/2025
4.0.0-beta-0021 373 3/4/2025
4.0.0-beta-0017 368 3/4/2025
4.0.0-beta-0016 376 3/4/2025
4.0.0-beta-0010 238 3/2/2025
4.0.0-beta-0009 248 3/2/2025
4.0.0-beta-0002 279 3/1/2025
3.3.1 423 2/20/2025
3.3.0 260 2/20/2025
3.3.0-beta-0028 238 2/20/2025
3.3.0-beta-0025 275 2/19/2025
3.3.0-beta-0024 304 2/19/2025
3.3.0-beta-0004 244 2/8/2025
3.2.0 532 1/29/2025
3.2.0-beta-0027 235 1/29/2025
3.2.0-beta-0023 222 1/29/2025
3.2.0-beta-0020 245 1/29/2025
3.1.3 232 1/29/2025
3.1.2 253 1/28/2025
3.1.1 264 1/25/2025
3.1.0 231 1/25/2025
3.1.0-beta-0013 245 1/25/2025
3.1.0-beta-0006 226 1/25/2025
3.1.0-beta-0004 201 1/25/2025
3.0.0 228 1/24/2025
3.0.0-beta-0055 244 1/24/2025
3.0.0-beta-0046 235 1/23/2025
3.0.0-beta-0045 226 1/23/2025
3.0.0-beta-0043 255 1/23/2025
3.0.0-beta-0038 254 1/21/2025
3.0.0-beta-0037 227 1/21/2025
3.0.0-beta-0029 243 1/21/2025
3.0.0-beta-0028 245 1/21/2025
3.0.0-beta-0018 221 1/19/2025
3.0.0-beta-0016 215 1/14/2025
3.0.0-beta-0012 224 1/12/2025
3.0.0-beta-0008 257 1/2/2025
3.0.0-beta-0007 221 12/28/2024
3.0.0-beta-0004 203 12/22/2024
2.2.0-beta-0001 456 10/28/2024
2.1.1 893 10/28/2024
2.1.0 375 10/19/2024
2.1.0-beta-0016 233 10/19/2024
2.1.0-beta-0015 252 10/19/2024
2.1.0-beta-0014 263 10/19/2024
2.1.0-beta-0013 265 10/19/2024
2.1.0-beta-0011 263 10/18/2024
2.1.0-beta-0010 251 10/18/2024
2.1.0-beta-0004 254 10/8/2024
2.1.0-beta-0002 222 10/6/2024
2.0.2 509 10/6/2024
2.0.1 249 10/6/2024
2.0.0 360 10/4/2024
2.0.0-beta-0060 241 10/6/2024
2.0.0-beta-0059 212 10/6/2024
2.0.0-beta-0056 235 10/4/2024
2.0.0-beta-0054 252 10/3/2024
2.0.0-beta-0053 246 10/2/2024
2.0.0-beta-0052 253 10/2/2024
2.0.0-beta-0050 232 10/2/2024
2.0.0-beta-0049 247 10/2/2024
2.0.0-beta-0046 257 10/1/2024
2.0.0-beta-0044 245 9/30/2024
2.0.0-beta-0026 258 9/24/2024
2.0.0-beta-0023 254 9/23/2024
2.0.0-beta-0022 211 9/23/2024
2.0.0-beta-0020 213 9/22/2024
2.0.0-beta-0004 212 9/20/2024
2.0.0-beta-0003 246 9/20/2024
1.9.0-beta-0003 249 9/16/2024
1.9.0-beta-0001 252 9/15/2024
1.9.0-beta 255 9/15/2024
1.8.1 422 9/14/2024
1.8.1-beta-0006 249 9/14/2024
1.8.1-beta-0005 218 9/14/2024
1.8.1-beta-0004 252 9/14/2024
1.8.1-beta-0003 225 9/14/2024
1.8.1-beta-0002 236 9/14/2024
1.8.1-beta-0001 223 9/14/2024
1.8.0 302 9/12/2024
1.8.0-beta-0064 246 9/12/2024
1.8.0-beta-0063 253 9/12/2024
1.8.0-beta-0059 246 9/8/2024
1.8.0-beta-0058 234 9/8/2024
1.8.0-beta-0057 274 9/8/2024
1.8.0-beta-0054 258 9/7/2024
1.8.0-beta-0053 268 9/6/2024
1.8.0-beta-0052 259 9/6/2024
1.8.0-beta-0051 246 9/6/2024
1.8.0-beta-0044 271 9/5/2024
1.8.0-beta-0042 271 9/4/2024
1.8.0-beta-0041 249 9/4/2024
1.8.0-beta-0027 274 8/25/2024
1.8.0-beta-0022 261 8/23/2024
1.8.0-beta-0017 249 8/7/2024
1.8.0-beta-0012 209 7/28/2024
1.8.0-beta-0010 174 7/28/2024
1.7.5 320 8/23/2024
1.7.4 412 8/9/2024
1.7.3 261 8/7/2024
1.7.2 246 7/28/2024
1.7.1 201 7/28/2024
1.7.0 284 7/20/2024
1.7.0-beta-0005 206 7/20/2024
1.7.0-beta-0001 228 7/8/2024
1.6.0 273 7/8/2024
1.6.0-beta-0004 218 7/7/2024
1.5.0 241 7/6/2024
1.5.0-beta-0010 226 7/6/2024
1.5.0-beta-0006 223 7/4/2024
1.4.5 218 7/4/2024
1.4.2 255 6/30/2024
1.4.1 256 6/30/2024
1.4.0 241 6/30/2024
1.4.0-beta-0010 236 6/30/2024
1.3.1 247 6/29/2024
1.3.0 223 6/29/2024
1.3.0-beta-0014 213 6/29/2024
1.3.0-beta-0007 198 6/26/2024
1.2.0 225 6/20/2024
1.2.0-beta-0001 189 6/20/2024
1.1.0 232 6/17/2024
1.1.0-beta-0019 203 6/20/2024
1.1.0-beta-0016 207 6/19/2024
1.1.0-beta-0014 180 6/17/2024
1.1.0-beta-0013 205 6/17/2024
1.0.0 256 6/15/2024
1.0.0-alpha-0054 177 6/15/2024
1.0.0-alpha-0053 208 6/12/2024
1.0.0-alpha-0051 175 6/12/2024
1.0.0-alpha-0048 194 6/10/2024
1.0.0-alpha-0047 183 6/10/2024
1.0.0-alpha-0043 164 6/9/2024
1.0.0-alpha-0042 236 6/7/2024
1.0.0-alpha-0040 197 6/6/2024
1.0.0-alpha-0038 187 6/6/2024
1.0.0-alpha-0036 185 6/5/2024
1.0.0-alpha-0034 188 6/4/2024
1.0.0-alpha-0031 167 6/4/2024
1.0.0-alpha-0025 165 6/3/2024
1.0.0-alpha-0023 204 6/2/2024
1.0.0-alpha-0022 187 6/1/2024
1.0.0-alpha-0019 193 6/1/2024
1.0.0-alpha-0018 179 6/1/2024
1.0.0-alpha-0014 182 6/1/2024
1.0.0-alpha-0013 169 6/1/2024
1.0.0-alpha-0012 176 5/31/2024
1.0.0-alpha-0011 166 5/31/2024
1.0.0-alpha-0010 148 5/31/2024