diff --git a/.github/social-preview.html b/.github/social-preview.html
new file mode 100644
index 0000000..6f5803b
--- /dev/null
+++ b/.github/social-preview.html
@@ -0,0 +1,33 @@
+<!doctype html>
+<html><head><meta charset="utf-8"><style>
+html,body{margin:0;padding:0;background:#0D1117}
+svg{display:block}
+</style></head><body>
+<svg xmlns="http://www.w3.org/2000/svg" width="1280" height="640" viewBox="0 0 1280 640" font-family="Segoe UI, Helvetica, Arial, sans-serif">
+  <rect width="1280" height="640" fill="#0D1117"/>
+  <!-- broom: handle, ferrule, bristles -->
+  <g transform="translate(990 320) rotate(35)" fill="none" stroke="#F5B342" stroke-width="10" stroke-linejoin="round" stroke-linecap="round">
+    <path d="M0 -190 V-40"/>
+    <path d="M-34 -40 H34 L48 10 H-48 Z"/>
+    <path d="M-48 10 L-84 150 H84 L48 10"/>
+    <path d="M-28 10 L-40 150 M0 10 V150 M28 10 L40 150" stroke-width="7"/>
+  </g>
+  <!-- swept debris dots -->
+  <g fill="#F5B342">
+    <circle cx="800" cy="510" r="9" opacity="0.7"/>
+    <circle cx="848" cy="540" r="7" opacity="0.5"/>
+    <circle cx="772" cy="552" r="6" opacity="0.4"/>
+    <circle cx="896" cy="560" r="5" opacity="0.3"/>
+  </g>
+  <text x="80" y="290" font-size="112" font-weight="700" fill="#FFFFFF">Sweepito</text>
+  <text x="84" y="360" font-size="40" fill="#C9D1D9">Safely clean caches and build artifacts</text>
+  <g font-size="28" font-weight="600" text-anchor="middle">
+    <rect x="84" y="420" width="190" height="52" rx="26" fill="none" stroke="#F5B342" stroke-width="2"/>
+    <text x="179" y="456" fill="#F5B342">Python 3.11+</text>
+    <rect x="294" y="420" width="120" height="52" rx="26" fill="none" stroke="#F5B342" stroke-width="2"/>
+    <text x="354" y="456" fill="#F5B342">CLI</text>
+    <rect x="434" y="420" width="190" height="52" rx="26" fill="none" stroke="#F5B342" stroke-width="2"/>
+    <text x="529" y="456" fill="#F5B342">Git-aware</text>
+  </g>
+</svg>
+</body></html>
diff --git a/.github/social-preview.png b/.github/social-preview.png
new file mode 100644
index 0000000..ba37cbe
Binary files /dev/null and b/.github/social-preview.png differ