Skip to content

Rule · Lint

More than 3 font families loaded

lint/too-many-font-familieswarnvoid lintupdated

Why it matters

Each family is at least one more font request (often 20–50 KB each), and more than two or three typefaces reads as unfocused design. Font bytes compete with the LCP image.

How to fix it

Use at most 2 families plus a mono. Prefer variable fonts when you need several weights.

Example

ts
export const sans = Inter({ subsets: ['latin'], variable: '--font-sans' })
export const mono = JetBrains_Mono({ subsets: ['latin'], variable: '--font-mono' })

References

void lint reports 67 rules in this category. Static source checks with no browser: Tailwind v4 silent failures, Next.js 16 API traps, React render-body bugs, accessibility markup, SEO files and motion hygiene.