Skip to content

feat(www): SEO/AEO audit — sitemap, structured data, and improved meta tags#87

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

feat(www): SEO/AEO audit — sitemap, structured data, and improved meta tags#87
bholmesdev wants to merge 1 commit intomainfrom
seo-aeo-audit-www

Conversation

@bholmesdev
Copy link
Owner

@bholmesdev bholmesdev commented Feb 27, 2026

SEO/AEO Audit for www

Problems Found

Critical:

  • No site property in astro.config.mjs — blocked sitemap generation, canonical URLs, and proper OG/meta URLs
  • No robots.txt — crawlers had no guidance

High Priority:

  • No structured data (JSON-LD) — no Organization, SoftwareSourceCode, or FAQ schema
  • Homepage title used emoji which is suboptimal for search snippets

Medium Priority:

  • Thin meta descriptions on some pages (form/client, form/parse)
  • No AEO optimization for AI citation

Changes

  1. astro.config.mjs: Added site: "https://simple-stack.dev" to enable Starlight's built-in sitemap, canonical URLs, and absolute OG URLs. Added global Organization JSON-LD structured data via the Starlight head config.

  2. public/robots.txt: Created with Allow: / and reference to sitemap-index.xml.

  3. Structured data (JSON-LD):

    • Organization schema on all pages (global head config)
    • FAQPage schema on homepage (3 common questions for AEO)
    • SoftwareSourceCode schema on store, scope, and query pages
  4. Improved titles: Replaced emoji-prefixed titles with keyword-rich, descriptive titles across all pages.

  5. Improved meta descriptions: Enriched all descriptions with specific keywords, framework names, and feature details.

Build Verification

The build compiles successfully with all changes, generating:

  • 9 static pages
  • sitemap-index.xml + sitemap-0.xml with all 8 content URLs
  • JSON-LD structured data in rendered HTML

This PR was generated with Oz.

@changeset-bot
Copy link

changeset-bot bot commented Feb 27, 2026

⚠️ No Changeset found

Latest commit: 0a8d103

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 Feb 27, 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 9, 2026 9:07am

@bholmesdev bholmesdev changed the title feat(www): SEO/AEO audit improvements feat(www): SEO & AEO audit — sitemap, robots.txt, structured data, improved metadata Mar 3, 2026
… meta tags

- Add site property to enable Starlight's built-in sitemap and canonical URLs
- Create robots.txt with sitemap reference
- Add Organization JSON-LD structured data site-wide
- Add SoftwareSourceCode JSON-LD to store, scope, and query pages
- Add FAQPage JSON-LD to homepage for AEO/AI citation optimization
- Improve title tags and meta descriptions across all pages
- Enrich thin descriptions on form/client and form/parse pages

Co-Authored-By: Oz <oz-agent@warp.dev>
@bholmesdev bholmesdev changed the title feat(www): SEO & AEO audit — sitemap, robots.txt, structured data, improved metadata feat(www): SEO/AEO audit — sitemap, structured data, and improved meta tags Mar 9, 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