Skip to content

feat(www): SEO/AEO audit β€” site URL, robots.txt, structured data, improved meta#89

Open
bholmesdev wants to merge 1 commit intomainfrom
seo-aeo-audit
Open

feat(www): SEO/AEO audit β€” site URL, robots.txt, structured data, improved meta#89
bholmesdev wants to merge 1 commit intomainfrom
seo-aeo-audit

Conversation

@bholmesdev
Copy link
Owner

@bholmesdev bholmesdev commented Mar 5, 2026

SEO/AEO Audit for www/

Comprehensive SEO and AEO (Answer Engine Optimization) audit of the Simple Stack documentation site.

Critical fixes

  • Add site URL to astro.config.mjs β€” enables canonical URL generation and Starlight's built-in sitemap (sitemap-index.xml)
  • Create robots.txt β€” allows crawlers to discover all pages and references the sitemap
  • Add WebSite JSON-LD structured data β€” schema.org markup with publisher info for rich results and AI citability

High priority improvements

  • Improved homepage title β€” keyword-rich title replacing emoji-only title for better search targeting
  • Improved meta descriptions β€” all main package pages (Store, Scope, Query) now have detailed, answer-first descriptions (40-60 words) optimized for AI citation
  • Meta robots tag β€” explicit index, follow directive on all pages

Files changed

  • www/astro.config.mjs β€” Added site, head config with JSON-LD and meta robots
  • www/public/robots.txt β€” New file
  • www/src/content/docs/index.mdx β€” Updated title, description, intro copy
  • www/src/content/docs/store.mdx β€” Updated description
  • www/src/content/docs/scope.mdx β€” Updated description
  • www/src/content/docs/query.mdx β€” Updated description

Remaining recommendations (not in this PR)

  • Add a default og:image social card for social sharing previews
  • Consider adding FAQPage JSON-LD schema on doc pages for enhanced rich results
  • Add BreadcrumbList structured data for navigation hierarchy signals

This PR was generated with Oz.

@changeset-bot
Copy link

changeset-bot bot commented Mar 5, 2026

⚠️ No Changeset found

Latest commit: 038ea7e

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
Copy link

vercel bot commented Mar 5, 2026

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

Project Deployment Actions Updated (UTC)
simple-stack-docs Ready Ready Preview, Comment Mar 10, 2026 9:28am

@bholmesdev bholmesdev changed the title feat(www): SEO & AEO audit β€” sitemap, robots.txt, structured data, improved meta SEO/AEO audit: add site URL, robots.txt, structured data, and improved meta descriptions Mar 6, 2026
… and improved meta

- Add site: 'https://simple-stack.dev' to astro.config.mjs (enables
  canonical URLs and sitemap generation)
- Add WebSite JSON-LD structured data with publisher info via Starlight
  head config
- Add meta robots tag (index, follow) to all pages
- Create public/robots.txt with sitemap reference
- Improve homepage title and description for keyword targeting
- Improve Store, Scope, Query page descriptions for AEO (answer-first,
  self-contained summaries for AI citation)

Co-Authored-By: Oz <oz-agent@warp.dev>
@bholmesdev bholmesdev changed the title SEO/AEO audit: add site URL, robots.txt, structured data, and improved meta descriptions feat(www): SEO/AEO audit β€” site URL, robots.txt, structured data, improved meta Mar 10, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant