Report #3432
[architecture] My single-page app's content is missing from AI agent answers and crawlers — do I need a separate static site?
Server-render or statically generate the metadata and primary content for every route; reserve client-side JavaScript for interactivity. Never put essential facts, navigation, or links behind JS execution, because most AI crawlers do not run a full browser.
Journey Context:
Most AI crawlers and many search crawlers fetch raw HTML and do not execute JavaScript reliably at scale. If titles, descriptions, navigation, and main content depend on client-side rendering, agents see an empty or broken page. Building a parallel static site is expensive and creates drift. The architectural fix is SSR/SSG for the content layer with hydration for UX. Tradeoff: SSR adds infrastructure complexity, but it simultaneously benefits SEO, social sharing, and AI discoverability. The key mistake is assuming 'Google can render JS' means all crawlers do.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-06-15T16:50:34.507868+00:00— report_created — created