feat(docs): apply TrakHound brand colour and logo to the VitePress theme

Author: ottobolyos

docs/.vitepress/config.ts

@@ -50,10 +50,39 @@ export default withMermaid(
     ignoreDeadLinks: true,
 
     head: [
-      ['meta', { name: 'theme-color', content: '#1f6feb' }],
+      ['meta', { name: 'theme-color', content: '#0073e6' }],
+      ['link', { rel: 'icon', type: 'image/png', href: '/logo.png' }],
+      ['meta', { property: 'og:type', content: 'website' }],
+      ['meta', { property: 'og:title', content: 'MTConnect.NET' }],
+      [
+        'meta',
+        {
+          property: 'og:description',
+          content:
+            'The .NET implementation of the MTConnect Standard — 100% public-surface API coverage, 100% MTConnect Standard compliance.',
+        },
+      ],
+      ['meta', { property: 'og:image', content: '/logo.png' }],
+      ['meta', { name: 'twitter:card', content: 'summary_large_image' }],
+      ['meta', { name: 'twitter:title', content: 'MTConnect.NET' }],
+      [
+        'meta',
+        {
+          name: 'twitter:description',
+          content: 'The .NET implementation of the MTConnect Standard.',
+        },
+      ],
+      ['meta', { name: 'twitter:image', content: '/logo.png' }],
     ],
 
     themeConfig: {
+      // The maintainer-supplied logo (`docs/img/mtconnect-net-03-md.png`,
+      // copied into `docs/public/logo.png`) already carries the
+      // 'mtconnect .NET' wordmark, so the text site title is hidden to
+      // avoid the wordmark rendering twice in the top nav.
+      logo: '/logo.png',
+      siteTitle: false,
+
       // Top nav: Compliance / Configure & Use / API / Concepts / Wire
       // formats / Modules / CLI / Cookbook / Troubleshooting.
       nav: [

docs/.vitepress/theme/index.ts

@@ -0,0 +1,15 @@
+/**
+ * VitePress theme entry for the MTConnect.NET documentation site.
+ *
+ * Extends the default theme and layers a small CSS override that
+ * remaps the brand palette to the TrakHound accent (`#0073e6`).
+ * Keeping the override in `./style.css` (rather than inlining a
+ * `<style>` block) lets VitePress hash the asset for cache-busting
+ * on each build.
+ *
+ * @see {@link https://vitepress.dev/guide/extending-default-theme}
+ */
+import DefaultTheme from 'vitepress/theme';
+import './style.css';
+
+export default DefaultTheme;

docs/.vitepress/theme/style.css

@@ -0,0 +1,24 @@
+/*
+ * Brand-palette override for the MTConnect.NET documentation site.
+ *
+ * The maintainer-supplied accent is #0073e6 (confirmed in discussion
+ * #184). VitePress derives the navigation highlight, link colour,
+ * active-state border, and CTA button fill from --vp-c-brand-1, with
+ * -2 and -3 used for hover / pressed states. Light mode darkens the
+ * shade as the index grows; dark mode lightens it. The soft variant
+ * is the same hue at ~14-16% alpha for surface tints.
+ */
+
+:root {
+  --vp-c-brand-1: #0073e6;
+  --vp-c-brand-2: #1f86eb;
+  --vp-c-brand-3: #4ba0f0;
+  --vp-c-brand-soft: rgba(0, 115, 230, 0.14);
+}
+
+.dark {
+  --vp-c-brand-1: #4ba0f0;
+  --vp-c-brand-2: #1f86eb;
+  --vp-c-brand-3: #0073e6;
+  --vp-c-brand-soft: rgba(75, 160, 240, 0.16);
+}