RCommon

Open-source .NET infrastructure library providing battle-tested abstractions for persistence, CQRS, event handling, messaging, caching, and more. Swap providers (EF Core, Dapper, MediatR, MassTransit, Wolverine, Redis) without touching your domain code.

Overview

RCommon is a cohesive set of libraries with abstractions for widely used design patterns and architectural patterns which are common to many .NET applications. The primary goals are:

1. Future-proof applications against changing infrastructure needs — swap providers without rewriting domain code.
2. Solve common problems below the presentation layer: persistence, transaction management, event handling, messaging, caching, and cross-cutting concerns.
3. Code testability — straightforward dependency injection, minimal magic, high test coverage.
4. Open source — Apache 2.0 licensed, forever.

Targets: .NET 8, .NET 9, .NET 10

We track bugs, enhancement requests, and feature requests on GitHub Issues and are very responsive. Community support is available on Stack Overflow.

Abstractions & Implementations

Abstraction	What It Provides	Implementations
Persistence	Repository pattern (ILinqRepository, IGraphRepository, ISqlMapperRepository, IAggregateRepository), Unit of Work, Specifications, Transactional Outbox/Inbox, Sagas	Entity Framework Core, Dapper, Linq2Db
CQRS & Mediator	Command/Query Bus (ICommandBus, IQueryBus), Mediator (IMediatorService), pipeline behaviors	MediatR, Wolverine
Event Handling	In-memory event bus, distributed events, transactional outbox pattern	MediatR, MassTransit, Wolverine
Messaging	Message bus for distributed systems, send/publish semantics	MassTransit, Wolverine
Caching	Unified read-through cache (ICacheService), query-level cache-aside for repositories	MemoryCache, Redis (StackExchange)
Blob Storage	Container and blob CRUD, upload/download, presigned URLs, metadata, copy/move	Azure Blob Storage, Amazon S3
Domain-Driven Design	Entities, Aggregate Roots (with optimistic concurrency), Domain Events, Value Objects, Auditing, Soft Delete	Built into RCommon.Entities
Multi-Tenancy	Tenant resolution and isolation, per-entity tenant markers	Finbuckle.MultiTenant
State Machines	Finite state machines (IStateMachine), saga state machines	Stateless, MassTransit (Automatonymous)
Serialization	Provider-agnostic JSON serialization (IJsonSerializer)	Newtonsoft.Json, System.Text.Json
Validation	Pluggable validation pipeline (IValidationService)	FluentValidation
Email	Unified email service (IEmailService)	SMTP, SendGrid
Security	Current user/tenant context, principal accessors, claims-based tenant resolution	ASP.NET Core, Swagger/Swashbuckle

Getting Started

All configuration flows through a single fluent builder chain:

services.AddRCommon()
    .WithPersistence<EFCorePerisistenceBuilder>(ef => ef
        .AddDbContext<MyDbContext>("MyDb", options => ...))
    .WithMediator<MediatRBuilder>(mediator => mediator
        .AddCommand<MyCommand, MyCommandHandler>())
    .WithEventHandling<MassTransitEventHandlingBuilder>(events => events
        .AddProducer<PublishWithMassTransitEventProducer>())
    .WithCaching<MemoryCachingBuilder>()
    .WithSerialization<SystemTextJsonBuilder>();

Install only the packages you need:

dotnet add package RCommon.Core
dotnet add package RCommon.EfCore
dotnet add package RCommon.Mediatr
# ... and so on

Documentation

Full documentation is available at https://rcommon.com

Stats