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
Copy Markdown
Owner

@bholmesdev bholmesdev commented Feb 27, 2026

SEO/AEO Audit: www docs site

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

Critical fixes

  • Add site URL to astro.config.mjs — enables Starlight's built-in sitemap generation, canonical URLs, and absolute URL resolution
  • Create robots.txt — directs crawlers and references the auto-generated sitemap
  • Add structured data (JSON-LD) — WebSite + Organization schema site-wide; FAQPage schema on store and query pages

High-priority improvements

  • Open Graph + Twitter Card meta tags — enables social sharing previews
  • Keyword-rich homepage <title> — replaces emoji-only title with "Simple Stack — Lightweight Developer Tools for Astro & Vite"
  • Improved meta descriptions on all 8 content pages — specific, 120-155 char descriptions optimized for SERP display and AI extraction

AEO (AI visibility) improvements

  • Answer-first lead paragraphs on all package pages — concise, self-contained definitions (40-60 words) that AI engines can directly extract and cite
  • FAQPage JSON-LD on store and query pages with common developer questions

Build verification

  • Site builds successfully with all changes
  • Sitemap auto-generates with all 8 pages
  • JSON-LD, OG tags, and improved titles verified in output HTML

Conversation: https://app.warp.dev/conversation/7b495eb0-e409-4a90-b78a-0e6801407ba2
Run: https://oz.warp.dev/runs/019d8611-c0f5-705b-8625-da0ac643b4cf
Plans:

@changeset-bot
Copy link
Copy Markdown

changeset-bot bot commented Feb 27, 2026

⚠️ No Changeset found

Latest commit: c7a40eb

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
Copy Markdown

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 Apr 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
@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
@bholmesdev bholmesdev changed the title feat(www): SEO & AEO audit improvements feat(www): SEO/AEO improvements — site URL, robots.txt, structured data, clean titles Mar 24, 2026
- Add site URL to astro.config.mjs (enables sitemap, canonical URLs)
- Add Organization + WebSite JSON-LD structured data site-wide
- Add Open Graph and Twitter Card meta tags site-wide
- Create public/robots.txt with sitemap reference
- Improve homepage <title> (keyword-rich, no emoji) and meta description
- Add answer-first lead paragraphs for AEO on all package pages
- Improve meta descriptions on all 8 content pages (120-155 chars, specific)
- Add FAQPage JSON-LD schema to store and query pages
- Build verified: sitemap auto-generates with all pages

Co-Authored-By: Oz <oz-agent@warp.dev>
@bholmesdev bholmesdev changed the title feat(www): SEO/AEO improvements — site URL, robots.txt, structured data, clean titles feat(www): SEO/AEO audit improvements Apr 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