No mobile viewport declared
The page declares no viewport meta tag, so mobile browsers fall back to rendering it at desktop width and scaling it down — text too small to read without zooming.
Why it matters
The page declares no viewport meta tag, so mobile browsers fall back to rendering it at desktop width and scaling it down — text too small to read without zooming. Google indexes the mobile version of a site first, so this affects ranking as well as the experience of anyone arriving from a phone.
How ShipReady detects it
Search-engine basics, deliberately shallow. Lighthouse does SEO auditing thoroughly, for free, from Google, built into every browser. This module does not try to compete with that and should never grow to. It exists so a ShipReady report is not conspicuously silent on the subject, and it covers exactly the things a founder is likely to have got wrong without knowing — chiefly a `noindex` left over from staging, which makes a site invisible to search entirely. Every rule reads only the page HTML and response headers already fetched by PageContext. The module issues **no HTTP requests of its own**, which is why it can be this cheap: it is pure analysis of bytes the scan already has. Deliberately NOT covered: keyword analysis, backlinks, content quality, Core Web Vitals, and anything else that needs crawling or a second data source. Also not duplicated here: title, description, og:title, robots.txt, sitemap.xml and custom 404, all of which the readiness check already reports.
Detection is deterministic. ShipReady reports this only when it observes the condition directly, and prefers to miss a real problem over inventing one. Rule version 1.3.0.
How to fix it
This is the prompt ShipReady puts in your report — written to be pasted straight into Cursor, Claude Code, or whichever assistant built the app.
Add <meta name="viewport" content="width=device-width, initial-scale=1"> to your document head so mobile browsers render at the device width instead of scaling a desktop layout down. In Next.js this belongs in the viewport export of your root layout. Google indexes the mobile version of your site first, so this affects ranking as well as usability.
Frequently asked questions
- What does "No mobile viewport declared" mean?
- The page declares no viewport meta tag, so mobile browsers fall back to rendering it at desktop width and scaling it down — text too small to read without zooming.
- How serious is it?
- ShipReady rates this low. Worth fixing. Small individually, and they accumulate.
- How do I fix it?
- Paste the fix prompt on this page into Cursor, Claude Code or your AI editor. It is the same prompt ShipReady puts in your report.
- Can I check my own site?
- Yes — ShipReady scans up to ten pages of any public site for free and reports this alongside every other check. The free report lists every issue it finds and shows full evidence and a fix prompt for the critical and high-severity ones; medium and low findings are counted and unlock on Pro.
Related checks
Run this check on your site
ShipReady checks this and 193 other things across up to ten pages of your site, with an AI-ready fix for each. Free, no signup.