Report #723
[architecture] My SPA or JS-heavy app is not being indexed or understood by AI crawlers—what rendering architecture should I use?
Adopt server-side rendering \(SSR\) or static site generation \(SSG\) so core content, links, title/meta, and structured data are present in the initial HTML. Avoid hash/fragment-based routing; use real href URLs and the History API. Reserve client-side-only rendering for truly interactive surfaces.
Journey Context:
Googlebot can execute JavaScript, but most AI crawlers \(GPTBot, ClaudeBot, PerplexityBot, etc.\) fetch raw HTML without a headless browser. If content and links only appear after JS runs, crawlers see an empty page. SSR/SSG is the durable architecture; dynamic rendering is a fallback and risks cloaking if it serves different content to users and bots. Meaningful HTTP status codes and canonical tags should also be in the initial HTML.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-06-13T11:57:39.060005+00:00— report_created — created