LuciferCore
A zero-allocation, event-driven .NET ecosystem for modulith architecture.
What is LuciferCore?
LuciferCore is a high-performance .NET framework built for modulith architecture: build clean, independent modules inside one application today, then split them into microservices later — without rewriting your core logic.
It combines two design principles that usually pull in opposite directions:
- OOP for clear, maintainable structure at the API surface (
Session,Request,Response,Handler,Middleware) - DOD (Data-Oriented Design) for raw speed and memory efficiency on the hot path (buffers, pooling, dispatch)
The result is a Buffer-Model architecture: network payloads flow through contiguous, pooled buffers instead of scattered heap allocations, keeping data close together in CPU cache and keeping the GC out of the way.
Core principles
Buffer-Model & pooling. ObjectPool and ArrayPool-backed buffers minimize allocations, maximize throughput, and keep memory usage flat and predictable under load.
Event-driven networking. The transport layer is built on event-driven I/O — TCP, UDP, SSL, UDS, and HTTP/WS/WSS on top — not Task/async-await chains. That means a fast, low-overhead event pipeline with stable memory behavior under concurrency.
Attributes, not boilerplate. Servers, handlers, middleware, and background workers are plain classes decorated with attributes ([Server], [Handler], [Middleware], [Manager]). You write business logic; the framework discovers and wires the rest — with the request-handling hot path compiled ahead of time by a Roslyn source generator, so there's no reflection at dispatch time.
Decorate → Implement → Run
The ecosystem, at a glance
| Package | Role |
|---|---|
| LuciferCore | The kernel — Buffer-Model (DOD), ObjectPool, lightweight DI, raw event-driven network transports. No discovery, no codegen. |
| LuciferCore.Platforms | The runtime — [Server], [Handler], [Middleware], [Manager] with auto-discovery and the Lucifer.CMD console host. |
| LuciferCore.Generators | The Roslyn source generator behind Platforms — compiles routing/dispatch tables at build time, zero reflection on the hot path. |
| LuciferCore.Templates | dotnet new lucifer-app — a working server, session, handler, and middleware, scaffolded in one command. |
| LuciferCore.Labs (coming soon) | From-zero-to-hero: .NET fundamentals through advanced LuciferCore architecture, one guided path. |
Two ways to build
Raw performance, manual wiring
dotnet add package LuciferCore
Just the kernel: buffers, pooling, DI, transports. You wire everything by hand.
Attributes, auto-discovery, full runtime
dotnet add package LuciferCore.Platforms
Decorate → Implement → Run. Servers, handlers, and middleware are discovered and wired for you.
Use the navigation bar above to browse the Docs and API Reference.
Dual-licensed under AGPL-3.0 (open-source). A commercial license is required for closed-source, SaaS, or enterprise use — see bufmod.lemonsqueezy.com.