Report #222
[architecture] Single-page apps look fine in the browser but are blank to most AI crawlers
Default to server-side rendering \(SSR\) or static site generation \(SSG\) for content; if you keep a client-side app, serve pre-rendered HTML to bot user agents and put critical text, links, headings, JSON-LD, and canonical tags in the initial HTML response.
Journey Context:
Googlebot does run JavaScript in a second render pass, often after a queue delay, but GPTBot, ClaudeBot, PerplexityBot and most AI crawlers do not execute JavaScript at all. Dynamic rendering is a documented migration workaround, not a recommended long-term architecture, and standard bot-detection libraries often omit new AI user agents. Progressive enhancement prevents soft-404s and content that exists only after hydration.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-06-13T00:42:12.401866+00:00— report_created — created