chore(seo): improve discoverability across npm, GitHub, and search engines (#11)

- Point homepage to docs site for npm canonical link
- Add 10 keywords to package.json (nuxt3, nuxt4, vue3, typescript, etc.)
- Add 8 GitHub topics for search visibility
- Add "Why nuxt-safe-action?" section and comparison table to README
- Add TypeScript badge to README
- Expand Open Graph and Twitter Card meta on docs landing page
- Add site.url for proper sitemap and canonical tag generation
- Add robots.txt with sitemap reference
- Enrich all docs page descriptions for better meta tags

Author: rutbergphilip

README.md

@@ -8,6 +8,7 @@
 [![npm downloads](https://img.shields.io/npm/dm/nuxt-safe-action.svg?style=flat&colorA=020420&colorB=00DC82)](https://npm.chart.dev/nuxt-safe-action)
 [![License](https://img.shields.io/npm/l/nuxt-safe-action.svg?style=flat&colorA=020420&colorB=00DC82)](https://npmjs.com/package/nuxt-safe-action)
 [![Nuxt](https://img.shields.io/badge/Nuxt-020420?logo=nuxt)](https://nuxt.com)
+[![TypeScript](https://img.shields.io/badge/TypeScript-3178C6?logo=typescript&logoColor=white)](https://www.typescriptlang.org/)
 
 Type-safe server actions for Nuxt.
 
@@ -47,6 +48,21 @@ const { execute, data, status, validationErrors } = useAction(createPost)
 - **H3Event access** - Full request context available in middleware and handlers
 - **Nuxt-native** - Auto-imports, familiar conventions, works out of the box
 
+## Why nuxt-safe-action?
+
+Calling server endpoints with raw `$fetch` is untyped, error-prone, and forces you to manually handle validation, error formatting, and loading states. `nuxt-safe-action` gives you a declarative builder that validates input with Zod, chains middleware for auth and logging, and returns reactive state on the client, all with full end-to-end type inference. It works with Nuxt 3 and Nuxt 4, supports both Zod v3 and v4, and adds minimal bundle overhead.
+
+### Comparison
+
+| | `$fetch` | tRPC-nuxt | **nuxt-safe-action** |
+|---|---|---|---|
+| Type safety | manual | full | full |
+| Input validation | manual | via zod | built-in zod |
+| Middleware | manual | via context | composable chain |
+| File-based routing | N/A | no | auto-generated |
+| Vue composable | no | no | `useAction` |
+| Bundle overhead | none | heavy | minimal |
+
 ## Quick Setup
 
 Install the module:

docs/app/pages/index.vue

@@ -9,7 +9,17 @@ useSeoMeta({
   title: 'nuxt-safe-action',
   description:
     'Type-safe server actions for Nuxt. Define actions with Zod validation and middleware, call them from the client with full type inference.',
+  ogTitle: 'nuxt-safe-action - Type-safe Server Actions for Nuxt',
+  ogDescription:
+    'Define server actions with Zod validation and composable middleware. Call them from Vue components with full type inference, reactive status tracking, and field-level validation errors.',
+  ogType: 'website',
+  ogUrl: 'https://nuxt-safe-action.vercel.app',
   ogImage: '/social-card.png',
+  twitterCard: 'summary_large_image',
+  twitterTitle: 'nuxt-safe-action - Type-safe Server Actions for Nuxt',
+  twitterDescription:
+    'Define server actions with Zod validation and composable middleware. Call them from Vue components with full type inference, reactive status tracking, and field-level validation errors.',
+  twitterImage: 'https://nuxt-safe-action.vercel.app/social-card.png',
 })
 
 const copied = ref(false)

docs/content/1.getting-started/1.installation.md

@@ -1,6 +1,6 @@
 ---
 title: Installation
-description: Get started with nuxt-safe-action in under a minute.
+description: Install nuxt-safe-action, the type-safe server action module for Nuxt 3 and Nuxt 4 with Zod v3 and v4 support.
 ---
 
 # Installation

docs/content/1.getting-started/2.usage.md

@@ -1,6 +1,6 @@
 ---
 title: Usage
-description: Learn the three steps to using nuxt-safe-action.
+description: Learn how to create a type-safe action client, define validated server actions, and call them from Vue components with useAction.
 ---
 
 # Usage

docs/content/2.guide/1.action-client.md

@@ -1,6 +1,6 @@
 ---
 title: Action Client
-description: Create and configure your action client with error handling and middleware.
+description: Create and configure the nuxt-safe-action client with custom error handling, authentication middleware, and role-based access control.
 ---
 
 # Action Client

docs/content/2.guide/2.defining-actions.md

@@ -1,6 +1,6 @@
 ---
 title: Defining Actions
-description: Learn how to define server actions with validation and handlers.
+description: Define type-safe server actions with Zod input and output validation, file-based routing, HTTP method suffixes, and metadata.
 ---
 
 # Defining Actions

docs/content/2.guide/3.use-action.md

@@ -1,6 +1,6 @@
 ---
 title: useAction
-description: The reactive composable for executing server actions in your components.
+description: useAction is a Vue composable for executing type-safe server actions with reactive status, validation errors, and lifecycle callbacks.
 ---
 
 # useAction

docs/content/2.guide/4.middleware.md

@@ -1,6 +1,6 @@
 ---
 title: Middleware
-description: Chain middleware for auth, logging, and more with typed context.
+description: Chain composable middleware for authentication, authorization, logging, and rate limiting with fully typed context and H3Event access.
 ---
 
 # Middleware

docs/content/2.guide/5.error-handling.md

@@ -1,6 +1,6 @@
 ---
 title: Error Handling
-description: Handle server errors and return field-level validation errors.
+description: Handle server errors with ActionError and return field-level Zod validation errors to Vue components using nuxt-safe-action.
 ---
 
 # Error Handling

docs/content/3.api/1.create-safe-action-client.md

@@ -1,6 +1,6 @@
 ---
 title: createSafeActionClient
-description: API reference for creating a safe action client.
+description: API reference for createSafeActionClient — configure error handling, middleware, and create reusable type-safe action clients for Nuxt.
 ---
 
 # createSafeActionClient