“My foreground passes” says little about red error text, a selected line or a block cursor. Measure the colors that appear together. In the session, open Readability pairs to inspect the current palette.
Pair
What to inspect
Default text / background
Ordinary command output with no explicit color request.
ANSI slot / background
Diff lines, errors, path names and other text using that slot.
Selection foreground / selection background
Text while it is selected. Your normal foreground may not be used.
Cursor foreground / cursor background
The character under a block cursor. A beam or underline has a different visual task.
The panel compares all 16 ANSI slots as text against the default background. Some palettes intentionally keep a dark black slot or a light white slot for use as a background. A “below” result needs context; it is not a demand to turn every swatch into white text.
WORKED EXAMPLE
Harbor’s default text is #E3E8E6 on #111C24: approximately 13.95:1. Its muted slot, #75858F, is approximately 4.53:1 against the same background. A small color change can therefore affect muted labels much more than the main text.
same background: #111C24
default text #E3E8E6 13.95:1
bright black #75858F 4.53:1
normal black #17242E 1.09:1
If you want a softer-looking terminal, reduce the prominence of secondary content without hiding essential information. Keep error labels explicit, retain the + and − markers in a diff, and test actual small text. A good ratio cannot distinguish two meanings that rely entirely on hue.
Try changing bright_black in the editor, then compare its line to the default text. If it falls just below the reference, a rounding display is not a pass: classification uses the unrounded value.
FORMULA
HuePrompt uses the W3C sRGB relative-luminance calculation. Convert each 8-bit channel to a value from 0 to 1, linearize it, then combine the channels with the weights below.
linear(c) = c / 12.92 if c ≤ 0.04045
((c + 0.055)/1.055)^2.4 otherwise
L = 0.2126 R + 0.7152 G + 0.0722 B
ratio = (lighter L + 0.05) / (darker L + 0.05)
Black against white gives 21:1; a color against itself gives 1:1. The interface uses 4.5:1 as a reference for normal-size text. This is one measurement, not an accessibility certificate for a terminal, application or entire website.
Why a terminal library might give a different number
WezTerm documents its color:contrast_ratio method as a comparison using HSL lightness. That differs from the relative-luminance formula here. Our pinned stable format check produced about 5.20 for Harbor red against the background with that method, while the W3C formula gives about 7.78. We use native WezTerm to validate the exported colors, not as the WCAG calculator.
A transparent background blends with whatever is behind the window. The solid-color ratio in this editor does not model your wallpaper, blur or background image. Test the actual window over both light and dark areas, or return to an opaque background for a predictable pair.
Bold, faint and reverse video
These are text attributes, not additional colors in this export. A terminal can brighten, dim or swap colors according to its settings. The “bright black” slot is simply a named palette entry, not a simulation of every possible faint-text treatment.
Truecolor applications
An application can choose an RGB foreground or background that is absent from your 16-color palette. Measure that actual pair. The color-layers manual shows why changing an ANSI slot cannot repair every program’s theme.
Font rendering
Thin strokes, small sizes and a bright room can make nominally contrasting text uncomfortable. Inspect your normal font at the size you actually use, including punctuation, underscores and the letter/number pairs O0 Il1.
PUBLISHING YOUR PALETTE
When you publish a palette, include the file, a plain transcript and the terminal/font settings used for the screenshot. A screenshot alone cannot tell a visitor whether a line was ANSI-colored or truecolor.
If you build your own palette download or demo page, a fresh WebTraceCheck browser session can help inspect that web page without your usual session state. It does not render native terminal applications. If your own page optionally emails a download, use a CleanTempMail test inbox for a non-sensitive delivery test. Do not use a disposable inbox for an important account’s recovery.
These optional products share HuePrompt’s operator. Neither is needed to edit or export here. Their separate limits and policies apply.