diff --git a/docs/docs.json b/docs/docs.json
index cd3a263..6bc1c79 100644
--- a/docs/docs.json
+++ b/docs/docs.json
@@ -4,9 +4,39 @@
   "name": "DataFog Core",
   "description": "PII detection and privacy transformations for Rust, Python, Node.js, and browsers",
   "colors": {
-    "primary": "#0F766E",
-    "light": "#0F766E",
-    "dark": "#2DD4BF"
+    "primary": "#795900",
+    "light": "#F7BE36",
+    "dark": "#795900"
+  },
+  "appearance": {
+    "default": "dark"
+  },
+  "background": {
+    "color": {
+      "light": "#E5E2E1",
+      "dark": "#131313"
+    }
+  },
+  "logo": {
+    "light": "/images/datafog-wordmark-light.svg",
+    "dark": "/images/datafog-wordmark.svg"
+  },
+  "favicon": "/favicon.svg",
+  "fonts": {
+    "heading": {
+      "family": "Hanken Grotesk",
+      "weight": 600
+    },
+    "body": {
+      "family": "Inter"
+    }
+  },
+  "seo": {
+    "metatags": {
+      "og:image": "https://datafog.ai/datafog-icon-512.png",
+      "twitter:image": "https://datafog.ai/datafog-icon-512.png",
+      "twitter:card": "summary"
+    }
   },
   "navigation": {
     "groups": [
diff --git a/docs/favicon.ico b/docs/favicon.ico
new file mode 100644
index 0000000..489e6bd
Binary files /dev/null and b/docs/favicon.ico differ
diff --git a/docs/favicon.svg b/docs/favicon.svg
new file mode 100644
index 0000000..2d74bfb
--- /dev/null
+++ b/docs/favicon.svg
@@ -0,0 +1,6 @@
+<svg width="32" height="32" viewBox="0 0 32 32" xmlns="http://www.w3.org/2000/svg">
+  <rect width="32" height="32" rx="6" fill="#0E0C09"/>
+  <rect x="5" y="8" width="22" height="4" rx="1" fill="#E8A84C"/>
+  <rect x="5" y="14" width="16" height="4" rx="1" fill="#E8A84C"/>
+  <rect x="5" y="20" width="19" height="4" rx="1" fill="#E8A84C"/>
+</svg>
diff --git a/docs/images/datafog-wordmark-light.svg b/docs/images/datafog-wordmark-light.svg
new file mode 100644
index 0000000..04ca82c
--- /dev/null
+++ b/docs/images/datafog-wordmark-light.svg
@@ -0,0 +1,9 @@
+<svg width="280" height="48" viewBox="0 0 280 48" xmlns="http://www.w3.org/2000/svg">
+  <!-- Icon -->
+  <rect width="48" height="48" rx="10" fill="#0E0C09"/>
+  <rect x="8" y="11" width="32" height="6" rx="1.5" fill="#E8A84C"/>
+  <rect x="8" y="21" width="24" height="6" rx="1.5" fill="#E8A84C"/>
+  <rect x="8" y="31" width="28" height="6" rx="1.5" fill="#E8A84C"/>
+  <!-- Text -->
+  <text x="62" y="33" font-family="'JetBrains Mono', monospace" font-weight="700" font-size="22" fill="#313030" letter-spacing="0.08em">DATAFOG</text>
+</svg>
diff --git a/docs/images/datafog-wordmark.svg b/docs/images/datafog-wordmark.svg
new file mode 100644
index 0000000..f59dca7
--- /dev/null
+++ b/docs/images/datafog-wordmark.svg
@@ -0,0 +1,9 @@
+<svg width="280" height="48" viewBox="0 0 280 48" xmlns="http://www.w3.org/2000/svg">
+  <!-- Icon -->
+  <rect width="48" height="48" rx="10" fill="#0E0C09"/>
+  <rect x="8" y="11" width="32" height="6" rx="1.5" fill="#E8A84C"/>
+  <rect x="8" y="21" width="24" height="6" rx="1.5" fill="#E8A84C"/>
+  <rect x="8" y="31" width="28" height="6" rx="1.5" fill="#E8A84C"/>
+  <!-- Text -->
+  <text x="62" y="33" font-family="'JetBrains Mono', monospace" font-weight="700" font-size="22" fill="#EDE8DF" letter-spacing="0.08em">DATAFOG</text>
+</svg>