feat(www): SEO/AEO audit improvements

[bholmesdev]

SEO/AEO Audit for simple-stack/www

This PR addresses critical SEO and AEO (Answer Engine Optimization) issues found during an audit of the documentation site.

Changes

Critical fixes:

• Add site URL to astro.config.mjs — enables Starlight's built-in sitemap generation (sitemap-index.xml)
• Add robots.txt — allows crawlers to discover the sitemap

Structured data & social:

• Add WebSite JSON-LD schema (site-wide) with author info for search engine and AI engine visibility
• Add Open Graph meta tags (og:site_name, og:type) for social sharing previews

Content optimization:

• Improve homepage title and description — keyword-rich, answer-first format for better SERP and AI citation visibility
• Improve per-page meta descriptions — Store, Scope, Query, and Stream pages now have detailed, keyword-rich descriptions
• Restructure homepage intro — entity-focused, answer-first format optimized for AEO

Build verification

• Build succeeds with 0 errors, 0 warnings
• Sitemap generated at dist/sitemap-index.xml
• 9 pages built, 8 pages indexed by Pagefind

---

Conversation: https://app.warp.dev/conversation/5c046d4b-e3e0-42c2-b3c9-bb038a6dc5f5
Run: https://oz.warp.dev/runs/019d905e-78fc-7ce2-abd3-b1dd419c7c65
Plans:

• SEO/AEO Audit: simple-stack/www

This PR was generated with Oz.

[changeset-bot]

⚠️ No Changeset found

Latest commit: 60ea78f

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
simple-stack-docs	Ready	Preview, Comment	Apr 15, 2026 9:09am