Skip to content

feat(www): SEO/AEO audit — sitemap, structured data, meta tags, and robots.txt#92

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

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

Conversation

@bholmesdev
Copy link
Copy Markdown
Owner

SEO/AEO Audit for docs site (www)

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

Critical fixes

  • Added site URL to astro.config.mjs — enables Starlight's built-in sitemap generation, canonical URLs, and <link rel="sitemap"> in <head>
  • Created robots.txt with sitemap reference for crawler discoverability

Structured data (JSON-LD)

  • Organization schema added site-wide via Starlight head config
  • SoftwareSourceCode schema added to store, scope, and query pages via frontmatter head

On-page SEO improvements

  • Improved titles — removed emoji prefixes from <title> tags (kept in sidebar labels), added descriptive suffixes
  • Improved meta descriptions — keyword-rich, 150-160 character descriptions on all pages
  • Removed redundant head override on homepage that duplicated the title

AEO improvements

  • Answer-first homepage intro — leads with a direct, extractable description of what Simple Stack is
  • Open Graph meta tagsog:type and og:site_name added site-wide

Build verification

  • Build passes with 0 errors
  • Sitemap generated with all 8 pages
  • JSON-LD, OG tags, and sitemap link verified in HTML output

Conversation: https://app.warp.dev/conversation/51826aec-b294-46d6-a621-e03cbe9b237b
Run: https://oz.warp.dev/runs/019d8b38-1d59-7d11-ad4c-995d6997c0a5
Plans:

This PR was generated with Oz.

…improved meta

- Add site URL to astro.config.mjs to enable sitemap, canonical URLs
- Add Organization JSON-LD and Open Graph meta tags site-wide
- Create public/robots.txt with sitemap reference
- Improve page titles and descriptions for SERP/AEO optimization
- Add SoftwareSourceCode JSON-LD to store, scope, and query pages
- Remove redundant head title override on homepage
- Remove emoji prefixes from page titles (kept in sidebar labels)
- Improve homepage intro text with answer-first AEO structure

Co-Authored-By: Oz <oz-agent@warp.dev>
@changeset-bot
Copy link
Copy Markdown

changeset-bot bot commented Apr 14, 2026

⚠️ No Changeset found

Latest commit: d1bcec9

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

vercel bot commented Apr 14, 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 Apr 14, 2026 9:05am

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