Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/Orbis25/FoundationKit/llms.txt

Use this file to discover all available pages before exploring further.

FoundationKit is a set of four focused NuGet packages that eliminate the repetitive scaffolding every ASP.NET Core application needs — generic CRUD repositories, base entity models, pagination, encryption utilities, and a RabbitMQ event bus — so your team can focus on business logic from day one.

Quickstart

Install FoundationKit and have a working repository, model, and controller in minutes.

Packages

Explore the four NuGet packages and choose what your project needs.

Core Concepts

Understand base models, repositories, DTOs, and pagination patterns.

API Reference

Full type signatures for every public interface and class.

​
What’s included

Repositories

Generic EF Core repositories with CRUD, soft-delete, pagination, and partial updates built in.

Base Models

Abstract entity base classes with Id, timestamps, soft-delete flag, and audit fields.

DTOs & Pagination

BaseInput, BaseEdit, BaseOutput, and a standard paginated result wrapper.

EF Core Setup

DbContext bases that auto-set CreatedAt/UpdatedAt and apply a global soft-delete query filter.

Encryption

AES and TweetNaCl/Curve25519 encryption helpers plus a request-decryption middleware.

Event Bus

RabbitMQ publisher and typed background consumer with automatic handler discovery.

​
Get started in four steps

1

Install the packages

Add the FoundationKit NuGet packages to your ASP.NET Core project.
dotnet add package FoundationKit
dotnet add package FoundationKit.EntityFrameworkCore
dotnet add package FoundationKit.Repository
dotnet add package FoundationKit.Extensions
2

Register FoundationKit

Call AddFoundationKit in your Program.cs to register AutoMapper from your assembly.
Program.cs
builder.Services.AddFoundationKit(Assembly.GetExecutingAssembly());
3

Inherit base classes

Extend BaseModel for your entities, BaseRepository for your services, and ApiCoreController or ApiMapController for your controllers.
4

Run your app

You now have paginated list, get-by-id, create, update, and soft-delete endpoints wired up without writing a single line of CRUD logic.
FoundationKit targets net8.0. All four packages are published on NuGet under the Orbis25 profile.

Build docs developers (and LLMs) love

Get started for freeTalk to us