FullStackHero.Modules.Identity 10.0.0-rc.2

.NET 10.0 This package targets .NET 10.0. The package is compatible with this framework or higher.
This is a prerelease version of FullStackHero.Modules.Identity. 
dotnet add package FullStackHero.Modules.Identity --version 10.0.0-rc.2
                    


                    

                
NuGet\Install-Package FullStackHero.Modules.Identity -Version 10.0.0-rc.2
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package. 
<PackageReference Include="FullStackHero.Modules.Identity" Version="10.0.0-rc.2" />
For projects that support PackageReference, copy this XML node into the project file to reference the package. 
<PackageVersion Include="FullStackHero.Modules.Identity" Version="10.0.0-rc.2" />
                    


                            Directory.Packages.props
                        

                    

                
<PackageReference Include="FullStackHero.Modules.Identity" />
                    


                            Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package. 
paket add FullStackHero.Modules.Identity --version 10.0.0-rc.2
                    


                    

                
#r "nuget: FullStackHero.Modules.Identity, 10.0.0-rc.2"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package. 
#:package FullStackHero.Modules.Identity@10.0.0-rc.2
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package. 
#addin nuget:?package=FullStackHero.Modules.Identity&version=10.0.0-rc.2&prerelease
                    


                            Install as a Cake Addin
                        

                    

                
#tool nuget:?package=FullStackHero.Modules.Identity&version=10.0.0-rc.2&prerelease
                    


                            Install as a Cake Tool

FullStackHero .NET 10 Starter Kit

An opinionated, production-first starter for building multi-tenant SaaS and enterprise APIs on .NET 10. You get ready-to-ship Identity, Multitenancy, Auditing, caching, mailing, jobs, storage, health, OpenAPI, and OpenTelemetry—wired through Minimal APIs, Mediator, and EF Core.

Why teams pick this

  • Modular vertical slices: drop Modules.Identity, Modules.Multitenancy, Modules.Auditing into any API and let the module loader wire endpoints.
  • Battle-tested building blocks: persistence + specifications, distributed caching, mailing, jobs via Hangfire, storage abstractions, and web host primitives (auth, rate limiting, versioning, CORS, exception handling).
  • Cloud-ready out of the box: Aspire AppHost spins up Postgres + Redis + the Playground API/Blazor with OTLP tracing enabled.
  • Multi-tenant from day one: Finbuckle-powered tenancy across Identity and your module DbContexts; helpers to migrate and seed tenant databases on startup.
  • Observability baked in: OpenTelemetry traces/metrics/logs, structured logging, health checks, and security/exception auditing.

Stack highlights

  • .NET 10, C# latest, Minimal APIs, Mediator for commands/queries, FluentValidation.
  • EF Core 10 with domain events + specifications; Postgres by default, SQL Server ready.
  • ASP.NET Identity with JWT issuance/refresh, roles/permissions, rate-limited auth endpoints.
  • Hangfire for background jobs; Redis-backed distributed cache; pluggable storage.
  • API versioning, rate limiting, CORS, security headers, OpenAPI (Swagger) + Scalar docs.

Repository map

  • src/BuildingBlocks — Core abstractions (DDD primitives, exceptions), Persistence, Caching, Mailing, Jobs, Storage, Web host wiring.
  • src/Modules — Identity, Multitenancy, Auditing runtime + contracts projects.
  • src/Playground — Reference host (Playground.Api), Aspire app host (FSH.Playground.AppHost), Blazor UI, Postgres migrations.
  • src/Tests — Architecture tests that enforce layering and module boundaries.
  • docs/framework — Deep dives on architecture, modules, and developer recipes.
  • terraform — Infra as code scaffolding (optional starting point).

Run it now (Aspire)

Prereqs: .NET 10 SDK, Aspire workload, Docker running (for Postgres/Redis).

  1. Restore: dotnet restore src/FSH.Framework.slnx
  2. Start everything: dotnet run --project src/Playground/FSH.Playground.AppHost
    • Aspire brings up Postgres + Redis containers, wires env vars, launches the Playground API and Blazor front end, and enables OTLP export on https://localhost:4317.
  3. Hit the API: https://localhost:5285 (Swagger/Scalar and module endpoints under /api/v1/...).

Run the API only

  • Set env vars or appsettings for DatabaseOptions__Provider, DatabaseOptions__ConnectionString, DatabaseOptions__MigrationsAssembly, CachingOptions__Redis, and JWT options.
  • Run: dotnet run --project src/Playground/Playground.Api
  • The host applies migrations/seeding via UseHeroMultiTenantDatabases() and maps module endpoints via UseHeroPlatform.

Bring the framework into your API

  • Reference the building block and module projects you need.
  • In Program.cs:
    • Register Mediator with assemblies containing your commands/queries and module handlers.
    • Call builder.AddHeroPlatform(...) to enable auth, OpenAPI, caching, mailing, jobs, health, OTel, rate limiting.
    • Call builder.AddModules(moduleAssemblies) and app.UseHeroPlatform(p => p.MapModules = true);.
  • Configure connection strings, Redis, JWT, CORS, and OTel endpoints via configuration. Example wiring lives in src/Playground/Playground.Api/Program.cs.

Included modules

  • Identity — ASP.NET Identity + JWT issuance/refresh, user/role/permission management, profile image storage, login/refresh auditing, health checks.
  • Multitenancy — Tenant provisioning, migrations, status/upgrade APIs, tenant-aware EF Core contexts, health checks.
  • Auditing — Security/exception/activity auditing with queryable endpoints; plugs into global exception handling and Identity events.

Development notes

  • Target framework: net10.0; nullable enabled; analyzers on.
  • Tests: dotnet test src/FSH.Framework.slnx (includes architecture guardrails).
  • Want the deeper story? Start with docs/framework/architecture.md and the developer cookbook in docs/framework/developer-cookbook.md.

Built and maintained by Mukesh Murugan for teams that want to ship faster without sacrificing architecture discipline.

Product Compatible and additional computed target framework versions.
.NET net10.0 is compatible.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
10.0.0-rc.2 215 12/18/2025
10.0.0-rc.1 217 12/18/2025