Skip to content

feat(www): SEO/AEO audit — site config, robots.txt, structured data, improved meta#93

Draft
bholmesdev wants to merge 1 commit into
mainfrom
oz/seo-aeo-audit
Draft

feat(www): SEO/AEO audit — site config, robots.txt, structured data, improved meta#93
bholmesdev wants to merge 1 commit into
mainfrom
oz/seo-aeo-audit

Conversation

@bholmesdev
Copy link
Copy Markdown
Owner

@bholmesdev bholmesdev commented Apr 28, 2026

SEO/AEO Audit for www (simple-stack.dev)

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

Changes

Critical — enables sitemap, canonical URLs, and OpenGraph:

  • Add site: "https://simple-stack.dev" to astro.config.mjs
  • Starlight automatically generates a sitemap when site is set

Technical SEO:

  • Create public/robots.txt with sitemap reference
  • Add Starlight-level description as fallback meta description for pages without one
  • Remove redundant custom <title> override from homepage frontmatter (Starlight sets this automatically from title)

Structured Data (JSON-LD):

  • Add site-wide WebSite schema (name, URL, description)
  • Add Organization schema (name, URL, logo, sameAs links to GitHub + Discord)

On-page SEO / AEO:

  • Improve homepage title with keywords ("Lightweight Web Development Tools for Astro")
  • Update all content page descriptions to be AEO-friendly (40-60 word direct answers)
  • Clean page titles: remove decorative emoji (sidebar labels keep them), add "(Deprecated)" to deprecated packages

Build verified

All 9 pages build successfully with the sitemap generated at dist/sitemap-index.xml.

Generated output includes

  • ✅ JSON-LD structured data (WebSite + Organization)
  • ✅ Sitemap (sitemap-index.xml)
  • ✅ Canonical URLs
  • ✅ OpenGraph + Twitter Card meta tags
  • ✅ Meta descriptions on all pages

Conversation: https://app.warp.dev/conversation/1e680290-4d6b-4ce8-b66c-26248f8faad6
Run: https://oz.warp.dev/runs/019e2090-891d-7660-9cc3-530e2697809c
Plans:

This PR was generated with Oz.

@vercel
Copy link
Copy Markdown

vercel Bot commented Apr 28, 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 May 13, 2026 9:17am

@changeset-bot
Copy link
Copy Markdown

changeset-bot Bot commented Apr 28, 2026

⚠️ No Changeset found

Latest commit: e9f4afc

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

…improved meta

- Add site URL (https://simple-stack.dev) to enable sitemap, canonical URLs, and OpenGraph
- Add Starlight-level description as fallback meta description
- Add WebSite + Organization JSON-LD structured data via Starlight head config
- Create robots.txt with sitemap reference
- Improve homepage title and description for keyword relevance and AEO
- Improve all content page descriptions to be AEO-friendly (40-60 word direct answers)
- Clean up page titles: remove decorative emoji, add (Deprecated) where applicable
- Remove redundant custom <title> tag from homepage frontmatter

Co-Authored-By: Oz <oz-agent@warp.dev>
@bholmesdev bholmesdev changed the title docs(www): SEO/AEO audit fixes for simple-stack.dev feat(www): SEO/AEO audit — site config, robots.txt, structured data, improved meta May 13, 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