MASA Framework is a production-ready .NET framework that accelerates microservice development by providing composable building blocks for event-driven communication, caching, DDD patterns, and cloud-native integration with Dapr. Install only the packages you need and wire them together with clean abstractions.Documentation Index
Fetch the complete documentation index at: https://mintlify.com/masastack/MASA.Framework/llms.txt
Use this file to discover all available pages before exploring further.
Quickstart
Create your first MASA Framework project and get a working microservice running in minutes.
Architecture
Understand the Building Blocks and Contrib package structure that powers the framework.
Event Bus
Dispatch and handle domain events in-process with a full middleware pipeline.
DDD Building Blocks
Model your domain with AggregateRoot, Entity, ValueObject, and DomainService abstractions.
What is MASA Framework?
MASA Framework is organized around two layers:- BuildingBlocks — Abstract interfaces and base classes defining the contracts for each capability (caching, events, configuration, etc.)
- Contrib — Concrete implementations using popular libraries like EF Core, Redis, Dapr, and Hangfire
Key Capabilities
Event Bus
In-process event dispatching with middleware and FluentValidation support
Integration Events
Cross-service pub/sub messaging via Dapr with outbox pattern support
Minimal APIs
Automatic route mapping from service classes with convention-based HTTP method resolution
Caching
Distributed and multi-level caching with Redis, pub/sub, and key pattern queries
DDD Patterns
Aggregate roots, domain events, repositories, and domain services
EF Core Extensions
Soft-delete, auditing, multi-tenancy filters, and Unit of Work built into MasaDbContext
Isolation
Multi-tenant and multi-environment data isolation with automatic query filtering
Configuration
Local and remote configuration management with hot-reload support
Background Jobs
Scheduled and queued background jobs via Hangfire or in-memory providers
Getting Started
Install .NET SDK
MASA Framework requires .NET 6.0 SDK or later.
For a full walkthrough including package installation and a working event handler, see the Quickstart guide.