Method AddTuiUserFiles

Namespace

Terminal.Gui.Configuration

Assembly

Terminal.Gui.dll

AddTuiUserFiles(IConfigurationBuilder, string?, string?)

Adds user-level configuration files from the standard locations:

• ~/.tui/config.json (GlobalHome)
• ./.tui/config.json (GlobalCurrent)
• ~/.tui/{appName}.config.json (AppHome)
• ./.tui/{appName}.config.json (AppCurrent)

Files are optional — missing files are silently skipped. Later files override earlier ones. Files that fail to read or parse are collected in TuiJsonErrors and skipped; legacy-shaped files are warned about and skipped.

public static IConfigurationBuilder AddTuiUserFiles(this IConfigurationBuilder builder, string? appName = null, string? currentDirectory = null)

Parameters

builder IConfigurationBuilder

The configuration builder.

appName string

The application name for app-specific config files. If null, app-specific files are skipped.

currentDirectory string

The directory the ./.tui/ paths are resolved against. If null, uses CurrentDirectory (never the app's install directory).

Returns

IConfigurationBuilder

The builder for chaining.