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

Missing viewport meta tag

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

No <meta name="viewport"> tag found, so the page won't scale correctly on mobile.

Why it matters

Without a viewport meta tag, mobile browsers render the page at a desktop width (around 980px) and shrink it to fit, so users get tiny text, mis-sized tap targets, and pinch-zooming to read anything. Any responsive CSS you wrote never gets a chance to apply because the browser is not reporting the real device width. This is one of the highest-impact single lines in mobile web quality.

How to fix it

Add <meta name="viewport" content="width=device-width, initial-scale=1" /> inside the <head> of every HTML document, or once in the shared layout if pages extend a base template. Do not add user-scalable=no or maximum-scale=1; disabling pinch zoom is an accessibility problem. Then check the page at a 375px-wide viewport and fix anything that overflows horizontally.

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