Fix black/fuchsia checkerboard placeholders instead of icons on Vantablack/White themes
The bug is real and confirmed verbatim: themes/vantablack/icons.theme contains exactly Yaru-gray, and bin/omarchy-theme-set-gnome does if [[ -f $GNOME_ICONS_THEME ]]; then gsettings set ... "$(<$GNOME_ICONS_THEME)"; else ... "Yaru-blue"; fi. The fallback fires only on a MISSING file and never validates the name, exactly as stated. But the prescribed replacements are wrong: Yaru ships color variants (Yaru, Yaru-blue, Yaru-purple, ...), not Yaru-dark/Yaru-light, so the fix swaps one non-existent name for another. Also themes/white/icons.theme is Yaru-grey (different spelling), and yaru-icon-theme is already in install/omarchy-base.packages so the install step is redundant, and pacman -S there should be -Syu.
Yaru-dark restores working icons but brings back app brand colors, losing the intentional monochrome look of Vantablack/White. It is a reliability fix, not a design fix.
Symptom
On the Vantablack or White theme, notification icons and some tray/app icons render as a black-and-fuchsia checkerboard placeholder instead of a real icon. The shell log shows WARN: Could not load icon "battery-caution" at size QSize(40, 40) from request, or the same for names like nordvpn-tray-blue.
Cause
vantablack/icons.theme sets the GNOME icon theme to Yaru-gray, but no such icon theme exists on disk. Ubuntu dropped it upstream and neither yaru-icon-theme nor omarchy ships it. The fallback in omarchy-theme-set-gnome only fires when the icons.theme state file is *missing*. It never validates the name it finds. So gsettings ends up pointing at an unresolvable theme and every themed icon lookup fails.
Fix
Confirm the bad value and see what icon themes actually exist:
gsettings get org.gnome.desktop.interface icon-theme # -> 'Yaru-gray'
ls /usr/share/icons # the real list
Both affected themes name a Yaru grey variant that does not exist, with different spellings:
themes/vantablack/icons.theme -> Yaru-gray
themes/white/icons.theme -> Yaru-grey
Yaru-dark and Yaru-light do not exist either. Yaru ships colour variants. Use a name that is really installed. Omarchy's own built-in fallback is Yaru-blue, so it is the safe choice:
cp -a "$(omarchy theme dir vantablack)" ~/.config/omarchy/themes/vantablack
echo "Yaru-blue" > ~/.config/omarchy/themes/vantablack/icons.theme
omarchy theme refresh
Same for the White theme:
cp -a "$(omarchy theme dir white)" ~/.config/omarchy/themes/white
echo "Yaru-blue" > ~/.config/omarchy/themes/white/icons.theme
omarchy theme refresh
Verify the name you chose resolves before trusting it:
ls -d /usr/share/icons/Yaru-blue
yaru-icon-theme is already listed in install/omarchy-base.packages, so it should be present. Verify rather than reinstall, and use -Syu (never -S against a stale db, and never -Sy, which causes a partial upgrade):
pacman -Qi yaru-icon-theme >/dev/null 2>&1 || sudo pacman -Syu yaru-icon-theme
Verify
gsettings get org.gnome.desktop.interface icon-theme returns 'Yaru-dark', and omarchy-notification-send -u critical "test" "test" -i battery-caution shows a real battery icon rather than a checkerboard. journalctl --user -b | grep 'Could not load icon' produces no new lines.