fix(docs): preserve package OG cards

.gitignore

@@ -8,7 +8,7 @@ apps/docs/.blume/
 apps/docs/.blume-verify/
 apps/docs/dist/
 apps/docs/public/opengraph-image.png
-apps/docs/public/social/
+apps/docs/public/og/
 artifacts/
 src/TheBuilder.WebAnalytics/wwwroot/App_Plugins/
 **/umbraco/Data/

apps/docs/blume.config.ts

@@ -40,6 +40,11 @@ export default defineConfig({
     output: "static",
     site: "https://web-analytics.thebuilder.dk",
   },
+  seo: {
+    // Package-owned cards are generated into public/og before Blume builds.
+    // Disable Blume's generated /og routes so it cannot overwrite them.
+    og: { enabled: false },
+  },
   analytics: {
     vercel: true,
   },

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

@@ -2,7 +2,7 @@
 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
+  image: /og/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

@@ -2,7 +2,7 @@
 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
+  image: /og/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

@@ -2,7 +2,7 @@
 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
+  image: /og/overview.png
 sidebar:
   order: 0
 ---

apps/docs/docs/providers/plausible.mdx

@@ -2,7 +2,7 @@
 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
+  image: /og/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

@@ -2,7 +2,7 @@
 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
+  image: /og/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

@@ -2,7 +2,7 @@
 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
+  image: /og/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

@@ -2,7 +2,7 @@
 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
+  image: /og/reference/configuration.png
 ---
 
 ## Configuration lifecycle and precedence

apps/docs/docs/reference/troubleshooting.mdx

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

apps/docs/package.json

@@ -14,7 +14,7 @@
     "check:og": "umbraco-docs-og --check"
   },
   "devDependencies": {
-    "@thebuilder/umbraco-docs": "^1.0.2",
+    "@thebuilder/umbraco-docs": "^1.0.3",
     "@types/node": "24.10.1",
     "blume": "1.4.3",
     "sharp": "0.34.5"

apps/docs/pages/index.astro

@@ -104,7 +104,7 @@ const steps = [
   searchEnabled={config.search.enabled}
   siteUrl={config.site}
   ogEnabled={config.og.enabled}
-  ogImage="/social/index.png"
+  ogImage="/og/index.png"
   page={{
     title: "Web Analytics for Umbraco",
     description:

apps/docs/umbraco-docs.config.mjs

@@ -4,9 +4,10 @@ import { fileURLToPath } from "node:url";
 export default defineOgConfig({
   contentDir: fileURLToPath(new URL("./docs", import.meta.url)),
   publicDir: fileURLToPath(new URL("./public", import.meta.url)),
-  prefix: "/social",
+  prefix: "/og",
   brand: "TheBuilder · Web Analytics",
   accent: "#3544b1",
+  logo: "/logo.png",
   root: {
     title: "Web Analytics",
     description: "Bring Vercel Web Analytics and Plausible reports into the Umbraco backoffice.",

pnpm-workspace.yaml

@@ -6,4 +6,4 @@ allowBuilds:
   sharp: true
 minimumReleaseAgeExclude:
   - blume@1.4.3
-  - '@thebuilder/umbraco-docs@1.0.2'
+  - '@thebuilder/umbraco-docs@1.0.3'