feat(www): SEO/AEO audit — site config, robots.txt, structured data, improved meta

www/astro.config.mjs

@@ -2,9 +2,40 @@ import starlight from "@astrojs/starlight";
 import { defineConfig } from "astro/config";
 
 export default defineConfig({
+	site: "https://simple-stack.dev",
 	integrations: [
 		starlight({
 			title: "Simple Stack 🌱",
+			description:
+				"Simple Stack is a collection of lightweight tools for web development including a reactive store, scoped IDs, and DOM query utilities for Astro.",
+			head: [
+				{
+					tag: "script",
+					attrs: { type: "application/ld+json" },
+					content: JSON.stringify({
+						"@context": "https://schema.org",
+						"@graph": [
+							{
+								"@type": "WebSite",
+								name: "Simple Stack",
+								url: "https://simple-stack.dev",
+								description:
+									"A collection of lightweight tools for web development: reactive store, scoped IDs, and DOM query utilities for Astro.",
+							},
+							{
+								"@type": "Organization",
+								name: "Simple Stack",
+								url: "https://simple-stack.dev",
+								logo: "https://simple-stack.dev/favicon.svg",
+								sameAs: [
+									"https://github.com/bholmesdev/simple-stack",
+									"https://wtw.dev/chat",
+								],
+							},
+						],
+					}),
+				},
+			],
 			social: [
 				{
 					icon: "github",

www/public/robots.txt

@@ -0,0 +1,4 @@
+User-agent: *
+Allow: /
+
+Sitemap: https://simple-stack.dev/sitemap-index.xml

www/src/content/docs/form/client.md

@@ -1,6 +1,6 @@
 ---
-title:  Add client validation
-description: Add client validation to your forms
+title: Add Client Validation
+description: "Add client-side form validation using the reward-early, punish-late UX pattern. Generate accessible form components with the simple-form CLI."
 sidebar:
   order: 3
 ---

www/src/content/docs/form/index.mdx

@@ -1,6 +1,6 @@
 ---
-title: Simple form
-description: The simple way to validate forms in your fullstack app. 
+title: Simple Form (Deprecated)
+description: "Simple Form was a Zod-based form validation library for Astro with auto-generated input props, server-side parsing, and client-side validation. Now deprecated in favor of Astro Form Actions."
 sidebar:
   label: Get started
   order: 1

www/src/content/docs/form/parse.md

@@ -1,6 +1,6 @@
 ---
-title: Parse form requests 
-description: Validate forms server-side
+title: Parse Form Requests
+description: "Validate and parse form submissions server-side using Zod schemas with Simple Form's validateForm() helper and Astro.locals.form API."
 sidebar:
   order: 2
 ---

www/src/content/docs/index.mdx

@@ -1,10 +1,7 @@
 ---
-title: Simple stack 🌱
-description: A suite of tools built for Astro to simplify your workflow.
+title: Simple Stack — Lightweight Web Development Tools for Astro
+description: Simple Stack is a collection of lightweight, focused tools for web development. Includes a reactive store with selectors, build-time scoped IDs, and a DOM query library for Astro components.
 tableOfContents: false
-head:
-  - tag: title
-    content: Simple stack 🌱
 ---
 
 A collection of tools I've built to **make web development simpler.**

www/src/content/docs/query.mdx

@@ -1,6 +1,6 @@
 ---
-title: 💰 Simple Query
-description: A simple library to query the DOM from your Astro components.
+title: Simple Query
+description: "Simple Query is an Astro integration for querying DOM elements with scoped selectors, typed element access, and optional signal-based reactivity via the TC39 Signals proposal polyfill."
 ---
 
 import { Tabs, TabItem, LinkCard } from '@astrojs/starlight/components';

www/src/content/docs/scope.mdx

@@ -1,6 +1,6 @@
 ---
-title: 🔎 Simple scope
-description: Get a scoped ID for whatever file you're in. Resolved at build-time with zero client JS.
+title: Simple Scope
+description: "Simple Scope is a Vite plugin that generates deterministic scoped IDs for any file at build time with zero client-side JavaScript. Compatible with Astro, Nuxt, SvelteKit, and any Vite-based framework."
 ---
 
 import { LinkCard } from '@astrojs/starlight/components';

www/src/content/docs/store.mdx

@@ -1,6 +1,6 @@
 ---
-title: 💾 Simple store
-description: A reactive store that combines the simplicity of signals with the power of "selectors" you'd find in Zustand or Redux.
+title: Simple Store
+description: "Simple Store is a reactive state management library that combines the simplicity of signals with selector-based access like Zustand or Redux. Works with React, Next.js, and vanilla JS with sub-store selection and middleware support."
 sidebar:
   label: Get started
   order: 1

www/src/content/docs/stream.md

@@ -1,6 +1,6 @@
 ---
-title: Simple stream 🌊
-description: Suspend Astro components with fallback content. Like React Server Components, but Just HTML ™️
+title: Simple Stream (Deprecated)
+description: "Simple Stream was an Astro integration for suspending components with fallback content, similar to React Server Components but using plain HTML streaming. Now deprecated in favor of Astro Server Islands."
 ---
 
 :::caution