docs: add page-specific social cards

Author: thebuilder

apps/docs/docs/guides/document-analytics.mdx

@@ -1,6 +1,8 @@
 ---
 title: Document analytics
 description: Map document roots and types to show reports automatically filtered to the selected published route. Document reports do not require global Analytics-section access.
+seo:
+  image: /social/guides/document-analytics.png
 ---
 
 Document mappings are optional. A connection without a mapping remains available in the global Analytics section but does not add a document workspace report. Document reports do not require global Analytics-section access.

apps/docs/docs/guides/reports.mdx

@@ -1,6 +1,8 @@
 ---
 title: Understanding your reports
 description: What each metric, breakdown, control, and drill-down in the Analytics dashboard means, and how date comparison and filtering work together.
+seo:
+  image: /social/guides/reports.png
 ---
 
 The Analytics section presents one dashboard per connection. This page explains what every part of it shows so you can move from a headline number to the context behind it. It describes the reading experience; for setup see the [quickstart](/quickstart), and for page-level reports see [document analytics](/guides/document-analytics).

apps/docs/docs/overview.mdx

@@ -1,6 +1,8 @@
 ---
 title: Overview
 description: Bring the analytics your site already collects into Umbraco, giving editors useful traffic reports in the backoffice and on mapped documents.
+seo:
+  image: /social/overview.png
 sidebar:
   order: 0
 ---

apps/docs/docs/providers/plausible.mdx

@@ -1,6 +1,8 @@
 ---
 title: Plausible
 description: Reference for Plausible Cloud and self-hosted connections, including fields, endpoint requirements, event properties, reports, and common errors.
+seo:
+  image: /social/providers/plausible.png
 ---
 
 The [quickstart](/quickstart) owns the first-time setup flow. Use this page to look up Plausible-specific requirements, connection fields, and capabilities.

apps/docs/docs/providers/vercel.mdx

@@ -1,6 +1,8 @@
 ---
 title: Vercel Web Analytics
 description: Reference for Vercel Web Analytics connection fields, reports, team projects, credential overrides, and common connection errors.
+seo:
+  image: /social/providers/vercel.png
 ---
 
 The [quickstart](/quickstart) owns the first-time setup flow. Use this page to look up Vercel-specific requirements, connection fields, and capabilities.

apps/docs/docs/quickstart.mdx

@@ -1,6 +1,8 @@
 ---
 title: Quickstart
 description: Install Web Analytics, configure a Vercel or Plausible credential, create and test a connection, then verify the Umbraco Analytics dashboard.
+seo:
+  image: /social/quickstart.png
 ---
 
 This is the complete first-time setup path for Web Analytics. Stay on this page from package installation to a working dashboard.

apps/docs/docs/reference/configuration.mdx

@@ -1,6 +1,8 @@
 ---
 title: Configuration reference
 description: Before the first Settings save, server configuration supplies non-secret values; afterward, Umbraco settings take precedence.
+seo:
+  image: /social/reference/configuration.png
 ---
 
 ## Configuration lifecycle and precedence

apps/docs/docs/reference/troubleshooting.mdx

@@ -1,6 +1,8 @@
 ---
 title: Troubleshooting
 description: Resolve missing access, provider credential failures, empty reports, and stale multi-instance settings.
+seo:
+  image: /social/reference/troubleshooting.png
 ---
 
 ## Connection and data

apps/docs/package.json

@@ -8,11 +8,13 @@
     "dev": "blume dev",
     "build": "blume build",
     "check": "blume check",
+    "generate:brand": "node scripts/generate-brand.mjs",
     "validate": "blume validate"
   },
   "devDependencies": {
     "@types/node": "24.10.1",
     "blume": "1.2.1",
+    "gray-matter": "4.0.3",
     "sharp": "0.34.5"
   }
 }