Skip to content
CQELight is a CQRS, DDD & Event Sourcing extensible and customisable base framework
Branch: master
Clone or download
Latest commit 16b7c45 Aug 23, 2019


Build Status Documentation Status


CQELight is a DDD, Command Query & Event Sourcing extensible and customisable base framework

DDD, CQRS and Event-sourcing are great topics, but it's not always easy to get started with them. Here's where CQELight is.

CQELight allows you to do clean loosely coupled architecture for your software developpments. Like this, you won't have to worry about technical stuff, just focus on business stuff and rely on CQELight system to help you build and run your system.

Based on Domain Driven Design, you can create your objects within boundaries, as aggregates, entities or value objects. With this clean object architecture, you can perform simple, flexible and extensible CQRS operations for interact with the system.

Available packages :

Extension name Stable
CQELight base NuGet
InMemory Buses NuGet
RabbitMQ Bus NuGet
MSMQ Bus NuGet
Azure Service Bus NuGet
Autofac IoC NuGet
MongoDb EventStore NuGet
EF Core EventStore NuGet
EF Core DAL NuGet
TestFramework NuGet
MVVM - MahApps implementation NuGet

Quick getting started - The 'Hello World!' example

To get really quick started, create a new console application

dotnet new console

Edit your csproj to use latest C# version

<Project Sdk="Microsoft.NET.Sdk">



Add CQELight & CQELight.Buses.InMemory packages

dotnet add package CQELight | dotnet add package CQELight.Buses.InMemory

Create a new class GreetingsEvent.cs and add the following content

using CQELight.Abstractions.Events;
namespace HelloWorld.Events
    class GreetingsEvent : BaseDomainEvent

Create a new class GreetingsEventHandler.cs and add the following content

using CQELight.Abstractions.Events.Interfaces;
using CQELight.Abstractions.DDD;
using HelloWorld.Events;
using System;
using System.Threading.Tasks;

namespace HelloWorld.Handlers
    class GreetingsEventHandler : IDomainEventHandler<GreetingsEvent>
        public Task<Result> HandleAsync(GreetingsEvent domainEvent, IEventContext context = null)
            Console.WriteLine("Hello world!");
            return Result.Ok();

Modify Program.cs as following

using CQELight;
using CQELight.Dispatcher;
using HelloWorld.Events;
using System;
using System.Threading.Tasks;

namespace HelloWorld
    class Program
        static async Task Main(string[] args)
            new Bootstrapper()

            await CoreDispatcher.PublishEventAsync(new GreetingsEvent()).ConfigureAwait(false);


Then, execute dotnet run, Hello World! should be visible on console

You can’t perform that action at this time.