Will It Vibe?
DOCS-015Medium severity-8 points

Focus outline removed

Part of Documentation, UX & Accessibility, which counts for 15% of the overall score. When this check fires it deducts 8 points from that category, once per scan, no matter how many places it turns up.

What it detects

Removing the default focus outline without a visible replacement breaks keyboard navigation.

Why it matters

The focus outline is the only way a keyboard user can see where they are on the page; removing it with outline: none and no replacement makes the site unusable without a mouse. This also affects power users tabbing through forms, not just assistive-technology users. Sighted mouse users never see the difference once you scope the fix correctly.

How to fix it

Replace the blanket :focus { outline: none } with :focus-visible styling: keep no ring on mouse clicks if you want, but give keyboard focus a clearly visible indicator, for example :focus-visible { outline: 2px solid <accent>; outline-offset: 2px; }. A box-shadow ring works too if outlines clash with rounded corners. Never ship outline suppression without a visible replacement.

The paid report includes a ready-to-paste prompt for your AI coding agent for every check it finds, pointed at the exact findings from your scan. See pricing

Does your repo trip this check?

Paste a GitHub URL or drop a project folder. Scans run in your browser and take seconds.

Scan your repo

Related Documentation, UX & Accessibility checks