Skip to content

feat(www): SEO & AEO audit — sitemap, robots.txt, structured data, improved metadata#87

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

feat(www): SEO & AEO audit — sitemap, robots.txt, structured data, improved metadata#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: www/ documentation site

Summary

This PR addresses critical SEO and AEO (Answer Engine Optimization) gaps in the Simple Stack documentation site built with Astro Starlight.

Changes

Critical fixes:

  • Sitemap generation: Added @astrojs/sitemap integration and required site property to astro.config.mjs
  • robots.txt: Created public/robots.txt with crawl directives and sitemap reference
  • Structured data: Added SoftwareSourceCode JSON-LD schema to homepage, store, scope, and query pages via Starlight's head frontmatter

On-page SEO improvements:

  • Improved meta descriptions on all 8 content pages (120-160 chars with relevant keywords)
  • Removed redundant head: - tag: title override on homepage (Starlight auto-generates <title> from frontmatter title)
  • Added title attribute to <video> element in stream.md for accessibility and SEO

AEO improvements:

  • Added concise, self-contained lead-in paragraph on homepage for AI engine extraction
  • Descriptions now written in a factual, entity-focused style optimized for AI citation

Remaining items (out of scope for this PR)

  • Open Graph images (requires astro-og-canvas or similar setup)
  • Replace placeholder site URL (https://simple-stack.dev) with actual production domain
  • Consider adding llms.txt for AI crawler guidance

Build verification

  • pnpm build passes with 0 errors, 0 warnings
  • sitemap-index.xml generated successfully

This PR was generated with Oz.

@changeset-bot
Copy link

changeset-bot bot commented Feb 27, 2026

⚠️ No Changeset found

Latest commit: 4f93a2c

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 3, 2026 9:15am

…proved metadata

- Add @astrojs/sitemap integration and site property to astro.config.mjs
- Create public/robots.txt with crawl directives and sitemap reference
- Add SoftwareSourceCode JSON-LD structured data to homepage, store, scope, and query pages
- Improve meta descriptions across all pages (120-160 chars with keywords)
- Remove redundant head title override on homepage
- Add AEO-friendly lead-in paragraph on homepage for AI engine extraction
- Add title attribute to video element in stream.md for accessibility
- Improve form page descriptions for better search relevance

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