Settings
A standalone settings window for applications that use TOML configuration files. It runs as a separate process from the main app and is responsible only for reading and writing the configuration file.
Getting Started
A standalone settings window for applications that use TOML configuration files. It runs as a separate process from the main app and is responsible only for rea…
Schema Reference
The schema is written in TOML and is embedded into the binary at build time. To assemble a settings UI, schema authors only need to know what each field means a…
Building
The Windows .exe is cross-built on macOS using mingw-w64 and the x86_64-pc-windows-gnu target. Linux binaries are difficult to cross-compile from macOS, so they…
Embedding
At most one Settings process may have a given config.toml open at a time. If you launch a second instance pointed at the same config file path, the newly launch…
Localization
Settings ships with built-in UI strings for 16 languages, and strings within the schema can be localized using the same mechanism. lang controls the display lan…
Theming
When "os" is set, the app follows the OS theme in real time, even if it changes while the app is running. OS-drawn native chrome, such as the title bar, also sw…
Validation
Added in v0.2. Field values can be validated using CEL (Common Expression Language) expressions. You can define reusable, named validation rules at the top leve…
Widget Reference
For each widget, the canonical TOML examples come from repos/settings/demo/schema.toml, a test schema covering every widget. A single-line text input. Use min_w…