Skip to content

feat(www): SEO/AEO improvements — site URL, robots.txt, structured data, clean titles#87

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

feat(www): SEO/AEO improvements — site URL, robots.txt, structured data, clean titles#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 Improvements for simple-stack/www

Summary

This PR addresses critical SEO and AEO (Answer Engine Optimization) gaps in the documentation site at simple-stack.dev, based on a comprehensive audit.

Changes

Critical fixes:

  • Add site URL to astro.config.mjs — enables Starlight's built-in sitemap generation, canonical URLs, and absolute URL resolution (all previously non-functional)
  • Add robots.txt — allows all crawlers and references the generated sitemap

High priority:

  • Add Open Graph meta tags (og:type, og:site_name) site-wide via Starlight head config
  • Clean up page titles — remove emojis from <title> tags for consistent SERP display (emojis are kept in sidebar labels for visual navigation)
  • Improve homepage title for search relevance

Structured data (AEO):

  • Organization JSON-LD added site-wide (name, URL, logo, GitHub sameAs)
  • WebSite JSON-LD added to the homepage

What this enables

  • Sitemap auto-generated at /sitemap-index.xml
  • Canonical URLs on all pages
  • Structured data for AI engines and rich results
  • Clean, professional title tags in search results

AEO content recommendation (not in this PR)

The homepage and package pages could benefit from 40-60 word "answer-first" lead paragraphs that directly state what each tool is and why to use it. This helps AI engines (ChatGPT, Perplexity, Google AI Overviews) extract and cite answers.


This PR was generated with Oz.

@changeset-bot
Copy link

changeset-bot bot commented Feb 27, 2026

⚠️ No Changeset found

Latest commit: edc0368

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

@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
@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
@bholmesdev bholmesdev changed the title feat(www): SEO/AEO audit — sitemap, structured data, and improved meta tags feat(www): SEO & AEO audit — structured data, meta tags, robots.txt Mar 12, 2026
@bholmesdev bholmesdev changed the title feat(www): SEO & AEO audit — structured data, meta tags, robots.txt feat(www): SEO & AEO audit improvements Mar 13, 2026
…ta, clean titles

- Add site URL (https://simple-stack.dev) to astro.config.mjs to enable
  sitemap generation, canonical URLs, and absolute URL resolution
- Add robots.txt allowing all crawlers with sitemap reference
- Add Open Graph meta tags (og:type, og:site_name) site-wide
- Add Organization JSON-LD structured data site-wide
- Add WebSite JSON-LD structured data on homepage
- Remove emojis from page title frontmatter for cleaner SERP display
  (emojis remain in sidebar labels for visual navigation)
- Improve homepage title for SEO

Co-Authored-By: Oz <oz-agent@warp.dev>
@bholmesdev bholmesdev changed the title feat(www): SEO & AEO audit improvements feat(www): SEO/AEO improvements — site URL, robots.txt, structured data, clean titles Mar 24, 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