diff --git a/.assets/fallout-social-preview.png b/.assets/fallout-social-preview.png
new file mode 100644
index 0000000..7894354
Binary files /dev/null and b/.assets/fallout-social-preview.png differ
diff --git a/.assets/fallout-social-preview.svg b/.assets/fallout-social-preview.svg
new file mode 100644
index 0000000..694c8b6
--- /dev/null
+++ b/.assets/fallout-social-preview.svg
@@ -0,0 +1,45 @@
+<svg width="1280" height="640" viewBox="0 0 1280 640" xmlns="http://www.w3.org/2000/svg">
+  <defs>
+    <radialGradient id="glow" cx="22%" cy="50%" r="55%">
+      <stop offset="0%" stop-color="#2a2205" />
+      <stop offset="100%" stop-color="#0d0d0f" />
+    </radialGradient>
+    <linearGradient id="bg" x1="0%" y1="0%" x2="100%" y2="100%">
+      <stop offset="0%" stop-color="#111113" />
+      <stop offset="100%" stop-color="#0a0a0b" />
+    </linearGradient>
+  </defs>
+
+  <!-- background -->
+  <rect width="1280" height="640" fill="url(#bg)" />
+  <rect width="1280" height="640" fill="url(#glow)" />
+
+  <!-- radioactive trefoil mark -->
+  <g transform="translate(300,320) scale(1.15)">
+    <circle cx="0" cy="0" r="175" fill="#f5c800" />
+    <circle cx="0" cy="0" r="172" fill="none" stroke="#111111" stroke-width="3" />
+    <circle cx="0" cy="0" r="155" fill="none" stroke="#111111" stroke-width="3" />
+
+    <ellipse cx="0" cy="-90" rx="52" ry="62" fill="#111111" />
+    <ellipse cx="-85" cy="48" rx="52" ry="62" transform="rotate(120 -85 48)" fill="#111111" />
+    <ellipse cx="85" cy="48" rx="52" ry="62" transform="rotate(-120 85 48)" fill="#111111" />
+
+    <circle cx="0" cy="0" r="52" fill="#f5c800" />
+    <circle cx="0" cy="0" r="32" fill="#111111" />
+    <circle cx="0" cy="0" r="18" fill="#f5c800" />
+
+    <path d="M0 -172 L-4 -130 L4 -110" fill="none" stroke="#1a1a1a" stroke-width="1.5" opacity="0.35" />
+    <path d="M165 90 L128 70 L110 80" fill="none" stroke="#1a1a1a" stroke-width="1.5" opacity="0.35" />
+    <path d="M-165 90 L-128 70 L-110 80" fill="none" stroke="#1a1a1a" stroke-width="1.5" opacity="0.35" />
+  </g>
+
+  <!-- text block -->
+  <g font-family="'Anthropic Sans', -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif">
+    <text x="580" y="270" font-size="112" font-weight="700" fill="#f5c800">Fallout</text>
+    <text x="583" y="322" font-size="34" font-weight="500" fill="#eaeaea">Build targets, inside your editor</text>
+    <text x="583" y="368" font-size="22" font-family="ui-monospace, 'SF Mono', 'Cascadia Code', monospace" fill="#888888" letter-spacing="0.1em">&#9762; explore &#183; run &#183; visualise</text>
+  </g>
+
+  <!-- footer -->
+  <text x="640" y="590" font-size="20" text-anchor="middle" font-family="ui-monospace, 'SF Mono', 'Cascadia Code', monospace" fill="#666666" letter-spacing="0.06em">github.com/Fallout-build/Fallout.Extensions.VSCode</text>
+</svg>
diff --git a/.vscodeignore b/.vscodeignore
index 2076b1e..c341b8e 100644
--- a/.vscodeignore
+++ b/.vscodeignore
@@ -24,6 +24,8 @@ docs/**
 AGENTS.md
 CLAUDE.md
 CONTRIBUTING.md
+# Repo branding (GitHub social preview), not extension assets — media/ holds those.
+.assets/**
 
 # Ship only Mermaid's self-contained UMD bundle (loaded by the graph webview via a
 # classic <script> tag), not its entire dependency tree or the code-split ESM build.