Fix nerd-font icons rendering as empty boxes or tofu in the bar and menus
Symptom
Menu and bar entries show a broken-character box instead of an icon, while other entries in the same menu render fine. Classic case: the Update > Omarchy row shows tofu where every other row (Channel, Config, Extra Themes) has a proper glyph. The glyph really is present in the font file (fc-scan and fontTools both find it), so it looks like a missing-glyph bug that isn't.
Cause
Stale fontconfig caches. Old cache-format directories (cache-7, cache-9, cache-10, ...) left behind by previous fontconfig upgrades cause the cache builder to produce an incomplete charset bitmap for a font. In the canonical report, omarchy.ttf indexed only its ASCII codepoints and silently dropped the U+E900 private-use entry, so pango fell back to a non-nerd font and drew tofu. A related but distinct cause is a codepoint from the old Nerd Font v2 private-use range that the v2-to-v3 remap relocated. Those genuinely do not resolve on current Nerd Font builds.
Fix
Inspect the cached charset. A missing page means a stale cache, not a missing glyph:
fc-list -v omarchy | grep -A5 charset
# a healthy result has a line starting 00e9: for U+E900
Nuke every cache generation and rebuild:
rm -rf ~/.cache/fontconfig/*
fc-cache -fv
Then restart whatever draws the glyph:
omarchy restart shell # Omarchy 4
# omarchy restart walker # Omarchy 3.x
If a system-wide cache is also stale:
sudo fc-cache -fv
And confirm the Nerd Font is actually installed:
fc-list | grep -i 'nerd font' | head
Verify
fc-list :charset=e900 family prints omarchy, fc-list -v omarchy | grep -A5 charset now includes the 00e9: page, and pango-view --text=$'' renders a glyph instead of a box.