Skip to content

feat(www): SEO/AEO audit — site config, 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 config, 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 — simple-stack/www

Comprehensive SEO and AEO (Answer Engine Optimization) audit and fixes for the documentation site at https://simple-stack.dev.

Critical fixes

  • Add site config to astro.config.mjs — enables canonical URLs, sitemap generation, and correct OG URLs (this was the single biggest SEO blocker)
  • Create robots.txt with crawl directives and sitemap reference
  • Enable automatic sitemap — Starlight's built-in @astrojs/sitemap now generates sitemap-index.xml

SEO improvements

  • Improved homepage title from "Simple stack 🌱" → "Simple Stack — Reactive Store, Scoped IDs & DOM Queries for Astro"
  • Richer meta descriptions on all active package pages (Store, Scope, Query) with relevant keywords
  • Clean <title> tags on subpages — emojis removed from <title> (kept in <h1> and sidebar for UX)
  • Open Graph meta tags added on homepage

Structured data (JSON-LD)

  • Organization schema added site-wide via Starlight head config
  • WebSite schema on homepage
  • FAQPage schema on homepage covering the three main packages — optimized for AI engine citations

Verified

  • Build passes with no errors
  • Sitemap generates correctly with all 8 pages
  • All three JSON-LD blocks render in built HTML
  • Canonical URLs, sitemap link, and OG tags present in <head>

This PR was generated with Oz.

@changeset-bot
Copy link

changeset-bot bot commented Mar 5, 2026

⚠️ No Changeset found

Latest commit: b94413d

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 25, 2026 9:06am

@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
@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
@bholmesdev bholmesdev changed the title feat(www): SEO/AEO audit — site URL, robots.txt, structured data, improved meta feat(www): SEO/AEO audit — sitemap, robots.txt, structured data, improved meta Mar 11, 2026
@bholmesdev bholmesdev changed the title feat(www): SEO/AEO audit — sitemap, robots.txt, structured data, improved meta SEO/AEO audit: improve titles, descriptions, structured data, and crawlability Mar 16, 2026
@bholmesdev bholmesdev changed the title SEO/AEO audit: improve titles, descriptions, structured data, and crawlability SEO/AEO audit: site URL, robots.txt, structured data, improved descriptions Mar 17, 2026
@bholmesdev bholmesdev changed the title SEO/AEO audit: site URL, robots.txt, structured data, improved descriptions feat(www): SEO/AEO audit and optimizations Mar 18, 2026
@bholmesdev bholmesdev changed the title feat(www): SEO/AEO audit and optimizations feat(www): SEO & AEO audit improvements Mar 19, 2026
@bholmesdev bholmesdev changed the title feat(www): SEO & AEO audit improvements seo: add site config, robots.txt, structured data, and improved meta descriptions Mar 23, 2026
…ta, and improved meta

- Add site URL to astro.config.mjs enabling canonical URLs and sitemap generation
- Add Organization JSON-LD schema site-wide via Starlight head config
- Create robots.txt with sitemap reference
- Improve homepage: descriptive title, richer description, WebSite + FAQPage JSON-LD
- Add OG meta tags on homepage
- Override <title> on Store, Scope, Query pages to remove emojis for cleaner SERPs
- Improve meta descriptions on all active package pages

Co-Authored-By: Oz <oz-agent@warp.dev>
@bholmesdev bholmesdev changed the title seo: add site config, robots.txt, structured data, and improved meta descriptions feat(www): SEO/AEO audit — site config, robots.txt, structured data, improved meta Mar 25, 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