Convey

A lightweight, modular toolkit for rapidly building production-ready .NET (Core) microservices.

Documentation & Demo

Read the full docs at mehyaa.github.io/Convey or watch a short demo on YouTube.

You can also find detailed documentation in the docs/ directory.

Key Features

Convey provides building blocks so you can focus on your domain instead of wiring infrastructure:

• Authentication: JWT with secret key & certificate support (+ mTLS helpers)
• CQRS: Simple abstractions for commands, queries & events
• Service Discovery: Consul integration
• API Documentation: Swagger / OpenAPI extensions
• HTTP Clients: RestEase integration
• Load Balancing: Fabio support
• Logging: Extensions for Serilog + sinks (Seq / ELK / Loki)
• Messaging: Broker abstractions, CQRS over messages & RabbitMQ integration
• Reliability: Inbox + Outbox pattern (EF Core / MongoDB implementations)
• Metrics: AppMetrics & Prometheus integration
• Persistence: Extensions for MongoDB, Redis, OpenStack OCS
• Secrets: Vault (KV, dynamic credentials, PKI, etc.)
• Security: Certificates, mTLS helpers, encryption utilities
• Tracing: Jaeger (incl. RabbitMQ propagation)
• Web API: Minimal routing-based API, CQRS endpoint helpers

Core Libraries

Foundation

• Convey - Core framework and dependency injection container
• Convey.WebApi - Web API extensions and minimal routing
• Convey.WebApi.CQRS - CQRS integration for Web API

Authentication & Security

• Convey.Auth - JWT authentication with secret keys and certificates
• Convey.Auth.Distributed - Distributed authentication patterns
• Convey.Security - Security extensions, certificates, mTLS, encryption
• Convey.WebApi.Security - Web API security extensions

CQRS (Command Query Responsibility Segregation)

• Convey.CQRS.Commands - Command handling abstractions
• Convey.CQRS.Events - Event handling abstractions
• Convey.CQRS.Queries - Query handling abstractions

Message Brokers

• Convey.MessageBrokers - Message broker abstractions
• Convey.MessageBrokers.CQRS - CQRS support for message brokers
• Convey.MessageBrokers.RabbitMQ - RabbitMQ integration
• Convey.MessageBrokers.Outbox - Outbox pattern implementation
• Convey.MessageBrokers.Outbox.EntityFramework - EF Core outbox implementation
• Convey.MessageBrokers.Outbox.Mongo - MongoDB outbox implementation

Persistence

• Convey.Persistence.MongoDB - MongoDB extensions and patterns
• Convey.Persistence.Redis - Redis extensions and caching
• Convey.Persistence.OpenStack.OCS - OpenStack OCS support

Service Discovery & Load Balancing

• Convey.Discovery.Consul - Consul service registry integration
• Convey.LoadBalancing.Fabio - Fabio load balancer integration

HTTP & API

• Convey.HTTP - HTTP client extensions
• Convey.HTTP.RestEase - RestEase integration for typed HTTP clients
• Convey.Docs.Swagger - Swagger/OpenAPI documentation
• Convey.WebApi.Swagger - Swagger integration for Web API

Observability

• Convey.Logging - Logging extensions with Serilog integration
• Convey.Logging.CQRS - CQRS logging integration
• Convey.Metrics.AppMetrics - AppMetrics integration
• Convey.Metrics.Prometheus - Prometheus metrics integration
• Convey.Tracing.Jaeger - Jaeger distributed tracing
• Convey.Tracing.Jaeger.RabbitMQ - Jaeger tracing for RabbitMQ

Configuration & Secrets

• Convey.Secrets.Vault - HashiCorp Vault integration for secrets management

Quick Start

dotnet new webapi -n SampleService
cd SampleService
dotnet add package Convey
dotnet add package Convey.WebApi
dotnet add package Convey.CQRS.Commands
dotnet add package Convey.MessageBrokers.RabbitMQ

var builder = WebApplication.CreateBuilder(args);

builder.Services.AddConvey()
	.AddWebApi()
	.AddCommandHandlers()
	.AddInMemoryCommandDispatcher()
	.AddRabbitMq();

var app = builder.Build();
app.UseRouting();
app.UseEndpoints(endpoints => endpoints.Get("/", ctx => ctx.Response.WriteAsync("OK")));
app.Run();

More examples are available under the samples/ directory and the docs site Getting Started guide.

Sample Applications

Explore the samples/ directory for full services demonstrating composition patterns:

• Conveyor.Services.Orders – Order management
• Conveyor.Services.Deliveries – Delivery tracking
• Conveyor.Services.Pricing – Pricing calculations

Contributing

Issues & PRs are welcome. Please follow conventional commit style and keep changes focused.

License

MIT License - see the LICENSE file for details.

Support

Created by devmentors.io. Maintained by mehyaa.