Foundatio MediatorBlazingly Fast C# Mediator

Convention-based mediator powered by source generators and interceptors

Get Started

View on GitHub

⚡

Near-Direct Call Performance

Zero runtime reflection with source generators and C# interceptors for blazing fast execution.

🎯

Convention-Based Discovery

No interfaces or base classes required. Just name your classes and methods following simple conventions.

🔧

Full Dependency Injection

Built-in support for Microsoft.Extensions.DependencyInjection with constructor and method injection.

🧩

Plain Handler Classes

Use regular classes or static methods. No framework coupling or special interfaces required.

🎪

Middleware Pipeline

Before/After/Finally hooks with state passing and short-circuiting capabilities.

🎯

Rich Result Types

Built-in Result and Result types for handling success, validation errors, and various failure states.

🔄

Automatic Message Cascading

Return tuples to automatically publish additional messages in sequence.

🔒

Compile-Time Safety

Comprehensive compile-time diagnostics and validation to catch errors early.

🧪

Easy Testing

Handlers are plain objects, making unit testing straightforward without framework mocking.

🐛

Superior Debugging

Short, simple call stacks with minimal indirection for excellent debugging experience.

Quick Example

Create a simple handler by following naming conventions:

csharp

public record Ping(string Text);

public static class PingHandler
{
    public static string Handle(Ping msg) => $"Pong: {msg.Text}";
}