PouryaKit

A reusable .NET 10 foundation for modular monoliths built from vertical slices.

Docs · Install

All the Kit's packages are on nuget.org as previews, and the docs site shows how to use them. The packages (every entry of scripts/packaging/inventory.json), each usable on its own, make up these Capabilities, plus two features (Paging, Request idempotency) that span several of them:

• Domain primitives (PouryaKit.Domain)
• Commands, queries and validation (PouryaKit.Cqrs, PouryaKit.Validation)
• Modules (PouryaKit.Modularity, with the Host's composition checks in PouryaKit.Cqrs)
• Persistence and the Unit of Work (PouryaKit.Persistence, PouryaKit.Persistence.EFCore, PouryaKit.Persistence.Postgres)
• Dapper reads (PouryaKit.Persistence.Dapper)
• Messaging, delayed and recurring commands included (PouryaKit.Messaging, PouryaKit.Messaging.Wolverine, PouryaKit.Messaging.Wolverine.EFCore)
• Web (PouryaKit.Web)
• Testing (PouryaKit.Testing)
• Core helpers (PouryaKit.Core)
• Security (PouryaKit.Security, PouryaKit.Security.JwtBearer)
• Observability (PouryaKit.Observability)
• Caching (PouryaKit.Caching)
• Paging (PouryaKit.Cqrs, PouryaKit.Persistence.Dapper, PouryaKit.Persistence.EFCore, PouryaKit.Web)
• Request idempotency (PouryaKit.Cqrs, PouryaKit.Persistence.EFCore, PouryaKit.Web)
• API versions and OpenAPI (PouryaKit.Web.OpenApi)
• Project templates (PouryaKit.Templates: the monolith, modular monolith and service templates)
• RabbitMQ between Hosts (PouryaKit.Messaging.Wolverine.RabbitMq)
• Email (PouryaKit.Email, PouryaKit.Email.MailKit)
• Multi-tenancy (PouryaKit.Domain, PouryaKit.Cqrs, PouryaKit.Persistence.EFCore, PouryaKit.Messaging.Wolverine: tenant-scoped Modules and the checks that keep one tenant's data from another)
• File storage (PouryaKit.Storage, PouryaKit.Storage.S3, PouryaKit.Storage.AzureBlob: the contract and its S3 and Azure Blob providers)
• Localization (PouryaKit.Localization; optional: English and Persian)
• Reverse proxy (PouryaKit.ReverseProxy: a YARP Host of its own process in front of the Hosts)
• gRPC (PouryaKit.Grpc: services and clients on Web's conventions)
• Aspire resources (PouryaKit.Aspire; AppHost-only: PostgreSQL, Redis, RabbitMQ and Ollama on pinned images, and the Proving Sample's AppHost)
• Realtime (PouryaKit.Realtime; optional: server-sent events from Notification Handlers, heard on every instance through PostgreSQL's notifications)
• Reporting (PouryaKit.Reporting; optional: a Module's report layout rendered to PDF, CSV and a spreadsheet)
• Report Module (PouryaKit.Reporting.Module; optional: the first Module the Kit ships as a package, report jobs generated in the background, fenced, served to their requester and removed after their retention)
• AI (PouryaKit.AI, PouryaKit.AI.Postgres: the chat client, the Gateway tool, MCP clients, agents and workflows, embeddings and semantic search)
• Streams (PouryaKit.Persistence.Marten, PouryaKit.Messaging.Wolverine.Marten: the Stream write model on Marten, committed with its Notifications and Integration Events through Wolverine's Marten outbox)
• Sagas (PouryaKit.Messaging.Wolverine.Sagas; optional: a Module's Saga on Wolverine, routed, claimed, tenant-guarded and emitting through the Kit, outside every Operation)

The skill's Capability table lists them with their packages and says when to read each reference.

This is the beginning of the README. Read the rest at the original. Read the full README ↗