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

SEO & AEO Audit β€” www docs site

Comprehensive SEO and Answer Engine Optimization audit for the Simple Stack documentation site.

Critical fixes

  • Added site URL (https://simple-stack.dev) to astro.config.mjs β€” required for canonical URLs, sitemap generation, and absolute URLs in structured data
  • Installed @astrojs/sitemap β€” auto-generates sitemap-index.xml at build time
  • Created robots.txt β€” directs crawlers and references the sitemap

High-priority improvements

  • Improved homepage <title> from emoji-only to keyword-rich: "Simple Stack – Lightweight Tools for Modern Web Development"
  • Improved meta descriptions on all pages to 120-160 characters with relevant keywords
  • Added OG and Twitter Card meta tags site-wide via Starlight head config

Structured data (AEO)

  • Added JSON-LD SoftwareApplication schema to homepage with author, pricing, and sameAs links

Other improvements

  • Replaced generic "Documentation" link text with descriptive package-specific anchors (e.g. "Get started with Simple Store")
  • Added aria-label to the stream demo video element
  • Updated homepage intro to be a concise, AI-extractable lead paragraph

Remaining recommendations (not in this PR)

  • Add a social sharing image (og:image) once one is designed
  • Consider adding FAQPage structured data for common questions in docs
  • Add BreadcrumbList JSON-LD (Starlight renders breadcrumbs visually but doesn't emit schema)
  • Monitor AI referral traffic from chat.openai.com, perplexity.ai, etc. in analytics

Build verification

βœ… astro check β€” 0 errors, 0 warnings
βœ… astro build β€” all 9 pages built, sitemap generated

This PR was generated with Oz.

…, improved meta

- Add site URL (https://simple-stack.dev) to astro.config.mjs
- Install and configure @astrojs/sitemap integration
- Add robots.txt with sitemap reference
- Add OG and Twitter Card meta tags via Starlight head config
- Add JSON-LD SoftwareApplication structured data to homepage
- Improve homepage title to be keyword-rich and descriptive
- Improve meta descriptions on all pages (120-160 chars)
- Replace generic 'Documentation' link text with package-specific anchor text
- Add aria-label to stream demo video for accessibility

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

changeset-bot bot commented Mar 5, 2026

⚠️ No Changeset found

Latest commit: 24a5377

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 Error Error Mar 5, 2026 9:04am

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