GitHub Stars

headless-framework is a modern, open-source headless framework for .NET developers who want full control with zero constraints.

• Unopinionated Design — Use your own patterns and architectures; the framework stays out of your way.
• Supports Most Flows — Built to integrate seamlessly with real-world use cases: CRUD, CQRS, messaging, file uploads, and more.
• Composable & Modular — Pick only what you need. Each piece is a standalone NuGet package.
• Zero Lock-in — Use with any storage, any frontend, any transport (REST, gRPC, GraphQL, etc.).
• Developer-Centric — Designed with clean architecture support, vertical slice support, CQRS, extensibility, and performance in mind.
• No Magic, Just Code — Everything is explicit. No hidden conventions or forced scaffolding.

• Prefer flexibility to convention
• Want to bootstrap quickly but scale cleanly
• Care about performance, testability, and maintainability

All packages are available on NuGet. Install only what you need:

dotnet add package Headless.Api
dotnet add package Headless.Orm.EntityFramework
dotnet add package Headless.Caching.Redis
# ... and many more

• LLM Context (compact)
• LLM Context (full)

var builder = WebApplication.CreateBuilder(args);
// Add API infrastructure
builder.Services.AddHeadlessApi();
// Add caching
builder.Services.AddHeadlessRedisCache(options =>
{
 options.ConnectionString = "localhost:6379";
});
// Add blob storage
builder.Services.AddAzureBlobStorage(options =>
{
 options.ConnectionString = "your-connection-string";
 options.ContainerName = "uploads";
});
// Add email
builder.Services.AddAwsSesEmail(options =>
{
 options.FromEmail = "noreply@example.com";
});
var app = builder.Build();
app.UseHeadlessApi();
app.Run();

Each feature follows the abstraction + provider pattern:

• Headless.*.Abstractions — Interfaces and contracts
• Headless.*.<Provider> — Concrete implementation

This enables easy swapping of implementations and testing with mocks.

Feel free to submit issues, feature requests, or PRs. Let's build the ultimate headless .NET foundation together!