Configuration
Fern Shell is configured through a combination of TOML files and Home-Manager/NixOS options.
Configuration Sources
- Home-Manager/NixOS options - Primary configuration method
~/.config/fern/config.toml- Runtime configuration file- Environment variables - Override specific settings
Quick Example
[appearance]
theme = "dark"
accent = "#89b4fa"
font_family = "Inter"
[bar]
position = "left"
width = 48
persistent = false
modules = ["workspaces", "spacer", "clock"]
[modules.workspaces]
count = 10
show_empty = true
[modules.clock]
format_time = "%H\n%M"
format_date = "%a\n%d"
Sections
- Config File Format - Complete TOML schema
- Theming - Colors, fonts, and design tokens
- Modules - Configure individual modules