Skip to content

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

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

feat(www): SEO/AEO audit improvements#87
bholmesdev wants to merge 1 commit into
mainfrom
seo-aeo-audit-www

Conversation

@bholmesdev
Copy link
Copy Markdown
Owner

@bholmesdev bholmesdev commented Feb 27, 2026

SEO/AEO Audit: simple-stack/www

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

Critical fixes

  • Add site URL to astro.config.mjs — enables canonical URLs, sitemap generation, and absolute URL references. This was the single biggest gap.
  • Create robots.txt — tells crawlers where the sitemap lives and explicitly allows indexing.
  • Add Open Graph + Twitter Card meta — social shares will now render rich previews with title, description, and site name.
  • Add JSON-LD structured dataWebSite + Organization schema gives search engines and AI agents entity context.

High priority fixes

  • Improve homepage title & description — changed from generic "Simple stack 🌱" to keyword-rich "Simple Stack - Lightweight Tools for Astro, React & Vite" with a descriptive meta description.
  • Add noindex to deprecated pages — Stream and Form pages (4 total) now have noindex, follow to prevent crawl budget waste on unmaintained content.

Remaining recommendations (not implemented)

  • Add per-page OG images (requires an OG image generation pipeline)
  • Add FAQPage schema to pages with FAQ-style content
  • Improve cross-linking between package docs in content body
  • Add author entity signals (Person schema, sameAs links)
  • Consider answer-first paragraph formatting on key pages for better AI citation

Conversation: https://app.warp.dev/conversation/1736e562-6230-4289-9800-72965b779ec1
Run: https://oz.warp.dev/runs/019e25b6-e52e-79d7-9ab6-c936123738bf
Plans:

This PR was generated with Oz.

@changeset-bot
Copy link
Copy Markdown

changeset-bot Bot commented Feb 27, 2026

⚠️ No Changeset found

Latest commit: 6c74839

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 May 14, 2026 9:04am

@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
@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
- Add site URL to astro.config.mjs (enables canonical URLs and sitemap)
- Add Open Graph and Twitter Card meta tags via Starlight head config
- Add WebSite + Organization JSON-LD structured data
- Create public/robots.txt with sitemap reference
- Improve homepage title and description for better SERP visibility
- Add noindex to deprecated pages (stream, form/*)

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