Symptom: Fonts jump on load (FOUT)

Root cause#

Web fonts swap after first paint.

The fix#

Preload fonts, use font-display: swap intentionally, or system stacks.

Verify#

  • Hard-refresh (the CSS cache is the #1 false negative)
  • Re-generate and re-link the stylesheet
  • Search the docs for the exact class — spelling is unforgiving

troubleshooting/index|All issues · faq/index|FAQ