HatTrick.Configuration 3.1.1

Prefix Reserved
.NET 9.0 This package targets .NET 9.0. The package is compatible with this framework or higher. 
dotnet add package HatTrick.Configuration --version 3.1.1
                    


                    

                
NuGet\Install-Package HatTrick.Configuration -Version 3.1.1
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="HatTrick.Configuration" Version="3.1.1" />
For projects that support PackageReference, copy this XML node into the project file to reference the package. 
<PackageVersion Include="HatTrick.Configuration" Version="3.1.1" />
                    


                            Directory.Packages.props
                        

                    

                
<PackageReference Include="HatTrick.Configuration" />
                    


                            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 HatTrick.Configuration --version 3.1.1
                    


                    

                
#r "nuget: HatTrick.Configuration, 3.1.1"
#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 HatTrick.Configuration@3.1.1
#: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=HatTrick.Configuration&version=3.1.1
                    


                            Install as a Cake Addin
                        

                    

                
#tool nuget:?package=HatTrick.Configuration&version=3.1.1
                    


                            Install as a Cake Tool

HatTrick.Configuration

NuGet License: Apache-2.0

A .NET 9 library for application configuration backed by JSON files and environment variables.

Full documentation | hattricklabs.com

Installation

dotnet add package HatTrick.Configuration

Namespace: HatTrick.Configuration

Quick Start

using HatTrick.Configuration;

public class AppSettings
{
    public string ApiBaseUrl { get; set; }
    public int TimeoutSeconds { get; set; }
}

var configMgr = JsonConfigManager.BuildInstance("default")
    .Register<AppSettings>("app-settings.json")
    .Build();

AppSettings settings = configMgr.Get<AppSettings>();
Console.WriteLine(settings.ApiBaseUrl);

Why HatTrick.Configuration

  • One source per registration, no provider chain — Register<T>("app-settings.json") reads exactly one file; no merge or override precedence to trace.
  • No DI container required — BuildInstance/GetInstance work the same in a console app, a class library, or a service.
  • One builder shape, two sources — JSON files and environment variables share the same BuildInstance → register → Build() pattern.
  • Authenticated encryption, opt-in per registration — AES-256-GCM with PBKDF2-derived keys. A wrong key and tampered ciphertext both throw CryptographicException.
  • Optimistic concurrency on writes — Put<T> refuses a write if the on-disk content changed since the last read, rather than silently overwriting a concurrent edit.
  • Validated at startup — every registered type or variable is validated once at Build(); failures aggregate into a single ConfigValidationException.

See the full documentation for core concepts, JSON configuration, environment variables, encryption, validation, hot reload, and the CLI tool.

License

Apache-2.0 — see LICENSE.

Product Compatible and additional computed target framework versions.
.NET net9.0 is compatible.  net9.0-android was computed.  net9.0-browser was computed.  net9.0-ios was computed.  net9.0-maccatalyst was computed.  net9.0-macos was computed.  net9.0-tvos was computed.  net9.0-windows was computed.  net10.0 was computed.  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.

  • net9.0

    • No dependencies.

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
3.1.1 77 7/26/2026

Initial public release. Versioned and used internally since Jan, 2025. This release continues that version history rather than resetting to 1.0.