Will It Vibe?
DOCS-016Low severity-4 points

No responsive design signals

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

What it detects

No media queries or a utility framework with responsive prefixes were found in a non-trivial stylesheet.

Why it matters

Around half of real traffic arrives on phones, and a stylesheet with no media queries and no utility framework almost always means the layout was only ever checked on a desktop window. On a 375px screen that typically shows up as horizontal scrolling, overlapping columns, or unreadably small content. Users on phones rarely report this; they just leave.

How to fix it

Open the app in devtools at 375px and 768px wide and fix what breaks. Convert fixed pixel widths to max-width or percentages, add max-width: 100% to images and media, let flex and grid containers wrap, and add @media (max-width: ...) blocks where columns need to stack or navigation needs to collapse. Work mobile-first where practical: base styles for small screens, media queries adding the wide layout.

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