Skip to content

feat(www): SEO & AEO audit improvements#87

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

feat(www): SEO & AEO audit improvements#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 docs site

Comprehensive SEO and AEO (Answer Engine Optimization) improvements for the Simple Stack documentation site at simple-stack.dev.

Critical fixes

  • Add site to astro.config.mjs — enables canonical URLs, auto-generated sitemap, and proper OG tags across all pages
  • Create robots.txt — provides crawler guidance with sitemap reference
  • Sitemap generation — Starlight's built-in @astrojs/sitemap now generates sitemap-index.xml automatically

On-page SEO

  • Homepage: Improved title from generic "Simple stack 🌱" to keyword-rich "Simple Stack – Lightweight Tools for Astro & Vite"
  • All active pages: Enhanced meta descriptions with target keywords and appropriate length (150-160 chars)
  • Open Graph + Twitter Card meta tags added to homepage and all active doc pages

Structured data

  • JSON-LD SoftwareSourceCode schema on homepage with author, repository URL, and programming languages

AEO improvements

  • Answer-first content on homepage: leads with a direct description of what Simple Stack is
  • Self-contained descriptions that AI engines can extract without surrounding context

Deprecated page handling

  • noindex, follow added to all deprecated pages (stream, form/*) to prevent search engines from indexing outdated content while still following links

Verified output

Build succeeds and all pages render with correct:

  • <title> tags
  • <meta name="description"> tags
  • <link rel="canonical"> URLs
  • <link rel="sitemap"> reference
  • Open Graph and Twitter Card meta tags
  • JSON-LD structured data
  • <meta name="robots" content="noindex, follow"> on deprecated pages

This PR was generated with Oz.

@changeset-bot
Copy link

changeset-bot bot commented Feb 27, 2026

⚠️ No Changeset found

Latest commit: 60299ac

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 13, 2026 9:07am

@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
@bholmesdev bholmesdev changed the title feat(www): SEO & AEO audit — sitemap, robots.txt, structured data, improved metadata feat(www): SEO/AEO audit — sitemap, structured data, and improved meta tags Mar 9, 2026
@bholmesdev bholmesdev changed the title feat(www): SEO/AEO audit — sitemap, structured data, and improved meta tags feat(www): SEO & AEO audit — structured data, meta tags, robots.txt Mar 12, 2026
- Add site URL to astro.config.mjs (enables canonical URLs, sitemaps, OG tags)
- Create robots.txt with sitemap reference
- Improve homepage title, description, and body copy for AEO answer-first pattern
- Add JSON-LD SoftwareSourceCode structured data to homepage
- Add Open Graph and Twitter Card meta tags to homepage
- Enhance meta descriptions on store, scope, and query pages with OG tags
- Add noindex to deprecated pages (stream, form/*)

Co-Authored-By: Oz <oz-agent@warp.dev>
@bholmesdev bholmesdev changed the title feat(www): SEO & AEO audit — structured data, meta tags, robots.txt feat(www): SEO & AEO audit improvements Mar 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