playbook/antigravity-awesome-skills/skills/vercel-optimize/references/support-topics/next-font-cls-self-hosting.md

id	title	status	candidateKinds	frameworks	metrics	priority	citations	maxBriefChars
next-font-cls-self-hosting	Next.js font CLS guardrail	active	cwv_poor	next@>=13.2.0	CLS	86	https://nextjs.org/docs/app/api-reference/components/font https://web.dev/articles/optimize-cls	800

Investigation Brief

For poor CLS, check fonts only when the route actually loads external font CSS or swaps text after render.

Evidence To Check

Inspect layouts and global styles for external font links, CSS imports, custom font-face rules, late-loading font classes, and whether next/font is already used.

Do Not Recommend When

Do not migrate fonts when CLS is caused by images, ads, embeds, or injected UI. Do not suggest next/font for unsupported Next.js versions.

Verification

Name the CLS value, font-loading mechanism, and the exact layout or stylesheet line to change.