Skip to content

Default bottom keybindings line text to white for dark terminals#5598

Open
zhenrenbumeng wants to merge 1 commit into
jesseduffield:masterfrom
zhenrenbumeng:master
Open

Default bottom keybindings line text to white for dark terminals#5598
zhenrenbumeng wants to merge 1 commit into
jesseduffield:masterfrom
zhenrenbumeng:master

Conversation

@zhenrenbumeng
Copy link
Copy Markdown

Change the default gui.theme.optionsTextColor from blue to white.

The bottom bar shows keybinding hints; previously it defaulted to ANSI blue (optionsTextColor: ["blue"]). On the most common setup—palette-based dark/black terminal background plus no special tweaking—this is effectively dark/low-luminance saturated blue glyphs on black, which performs very poorly for legibility compared to lighter neutrals like white.

From a perceptual/contrast standpoint: readable text relies on sufficient luminance contrast between foreground and background, not hue alone. On a nearly black background, blue has intrinsically low luminance relative to colours like yellow, cyan, or white: the perceived brightness stays low unless the palette uses a consciously “bright/high-luminance blue”. Many default 16‑colour palettes do not strongly boost blue’s luminance, so the foreground sits close to the background in lightness. That sharply reduces discriminability—especially at a glance, in peripheral vision, on smaller fonts, or for users whose colour vision skews differentiation between saturated blues (not rare), where hue difference does not reliably rescue readability when lightness contrast is marginal.

ANSI “blue-on-black” is a well‑known readability pain point in TUIs compared to pale grey/white; defaulting keybinding help to white matches the expectation that ancillary UI chrome should remain legible across stock terminals without forcing every user into custom theme overrides.

Behaviour when users explicitly set optionsTextColor in config is unchanged; only defaults and docs/schema are updated accordingly.

image

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant