EasyMessages Documentation

Centralized message management for .NET applications

Get Started View on GitHub

NuGet License: MIT

For New Users

For Developers

For Contributors

Installation

One package. Works everywhere — console apps, web APIs, background workers, class libraries.

dotnet add package RecurPixel.EasyMessages --version 1.0.0

Quick Example

Console / Worker / Any .NET App 

using RecurPixel.EasyMessages;

// Works immediately — no setup needed
Msg.Auth.LoginFailed().ToConsole(useColors: true);

var json = Msg.Crud.Created("User").ToJson();
Console.WriteLine(json);

ASP.NET Core Web API 

using RecurPixel.EasyMessages;

[HttpPost]
public IActionResult Create(CreateUserDto dto)
{
    var user = _userService.Create(dto);
    var msg = Msg.Crud.Created("User").WithData(user);
    return StatusCode(msg.HttpStatusCode ?? 201, msg.ToJsonObject());
}

Logging — chain anywhere 

using Microsoft.Extensions.Logging;
using RecurPixel.EasyMessages;

var msg = Msg.Auth.LoginFailed()
    .Log(logger)      // logs at the right level automatically
    .ToJson();        // then format — same instance, fully chainable

Features

  • [✓] 100+ Pre-built Messages — Authentication, CRUD, Validation, System errors, and more
  • [✓] Type-Safe — IntelliSense-driven API, compile-time safety
  • [✓] Multiple Formats — JSON, XML, Console, Plain Text
  • [✓] Zero Configuration — Works immediately out of the box
  • [✓] Fluent API — Chainable methods including .Log(logger)
  • [✓] Cross-Platform — Console apps, web APIs, workers, class libraries
  • [✓] IOptions Pattern — Full configuration support with presets
  • [✓] Extensible — Custom messages, formatters, interceptors
  • [✓] High Performance — Targets .NET 8, 9, and 10

Documentation Structure

Getting Started

Step-by-step tutorials to get you up and running quickly.

  • Installation
  • Your First Message
  • Next Steps

Core Concepts

Understand the fundamental concepts behind EasyMessages.

  • Messages and Message Types
  • Message Registry and Stores
  • Facades (Msg.Auth, Msg.Crud, etc.)
  • Formatters and Outputs
  • Interceptors
  • Architecture Overview

License

EasyMessages is licensed under the MIT License.

Built with ❤️ by RecurPixel

*Last Updated: 2026-05-10 Current Version: 1.0.0*