Fusion Framework logo by Cipher UnitFusion

Config

fusion.<env>.json and SettingsStore in C# (FusionFramework)

Overview

Settings load through FFI from the same fusion.<env>.json files as other languages (FUSION_ENV, default dev). Types live in the FusionFramework namespace (NuGet package Fusion-Framework).

Shared discovery, placeholders, consumed keys, and full CLI-generated schemas:

→ Settings and configuration

SettingsStore.Current.EnsureLoaded(Directory.GetCurrentDirectory());
var host = SettingsStore.Current.Host;
var port = SettingsStore.Current.Port;
var secret = SettingsStore.Current.Get("secret_key");

Startup

SettingsStore.Current.EnsureLoaded(Directory.GetCurrentDirectory());
using var app = new FusionApp(SettingsStore.GetSettings());
app.Listen(); // host/port from settings

Scaffolded apps also get a static CoreSettings helper that reads from SettingsStore — it does not replace JSON.

API

APIRole
EnsureLoaded(extraRoots…)Discover JSON
LoadJson(path, env, roots…)Explicit load
Get(key, default?)JSON node / value
Merge(object)Overlay
Host / Port / Debug / EnvCommon fields
SettingsStore.Configure(values)Merge into singleton

Switch environment

FUSION_ENV=prod dotnet run
fusion command run:prod

commands in JSON are for Fusion Tool only.

On this page