Skip to content

feat(www): SEO/AEO audit — sitemap, robots.txt, structured data, improved meta#89

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

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

This PR addresses SEO and AEO (Answer Engine Optimization) gaps in the documentation site to improve discoverability by search engines and AI assistants.

Changes

Technical SEO

  • Add site: 'https://simple-stack.dev' to astro.config.mjs — enables Starlight's built-in sitemap generation and canonical URL support
  • Create public/robots.txt allowing all crawlers with a sitemap reference
  • Add og:site_name meta tag globally via Starlight head config

Structured Data (JSON-LD)

  • Add WebSite schema site-wide (name, URL, description, author)
  • Add SoftwareSourceCode schema to the three active package pages (store, scope, query) with repository links and author info

On-Page SEO / AEO

  • Improve homepage title from "Simple stack 🌱" → "Simple Stack – Lightweight Developer Tools for the Modern Web"
  • Remove redundant head title override on homepage that was clobbering the auto-generated <title>
  • Rewrite homepage intro with answer-first format (40-60 word direct answer for AEO)
  • Improve meta descriptions on all pages to be keyword-rich, 150-160 chars, and answer-first
  • Clearly mark deprecated packages (stream, form) in their meta descriptions

Build Validation

  • astro check: 0 errors, 0 warnings
  • astro build: all 9 pages built successfully, sitemap-index.xml generated

This PR was generated with Oz.

@changeset-bot
Copy link

changeset-bot bot commented Mar 5, 2026

⚠️ No Changeset found

Latest commit: ca7693b

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 11, 2026 9:05am

@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
…and improved meta

- Add site property to astro.config.mjs to enable sitemap generation and canonical URLs
- Add robots.txt with sitemap reference
- Add global WebSite JSON-LD schema and og:site_name meta tag
- Add SoftwareSourceCode JSON-LD to store, scope, and query pages
- Improve homepage title and description for search/AI discoverability
- Rewrite homepage intro with answer-first format for AEO
- Improve meta descriptions on all pages (keyword-rich, 150-160 chars)
- Mark deprecated packages (stream, form) clearly in descriptions

Co-Authored-By: Oz <oz-agent@warp.dev>
@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
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