diff --git a/social-preview.svg b/social-preview.svg
new file mode 100644
index 0000000..67d3dff
--- /dev/null
+++ b/social-preview.svg
@@ -0,0 +1,101 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="1280" height="640" viewBox="0 0 1280 640">
+  <!-- Background -->
+  <defs>
+    <linearGradient id="bg" x1="0%" y1="0%" x2="100%" y2="100%">
+      <stop offset="0%" style="stop-color:#0d1117"/>
+      <stop offset="100%" style="stop-color:#161b22"/>
+    </linearGradient>
+    <linearGradient id="accent" x1="0%" y1="0%" x2="100%" y2="0%">
+      <stop offset="0%" style="stop-color:#00d4aa"/>
+      <stop offset="100%" style="stop-color:#0094ff"/>
+    </linearGradient>
+    <linearGradient id="glow" x1="0%" y1="0%" x2="0%" y2="100%">
+      <stop offset="0%" style="stop-color:#00d4aa;stop-opacity:0.3"/>
+      <stop offset="100%" style="stop-color:#00d4aa;stop-opacity:0"/>
+    </linearGradient>
+  </defs>
+
+  <!-- Main background -->
+  <rect width="1280" height="640" fill="url(#bg)"/>
+
+  <!-- Grid lines -->
+  <g stroke="#21262d" stroke-width="1" opacity="0.6">
+    <line x1="0" y1="160" x2="1280" y2="160"/>
+    <line x1="0" y1="320" x2="1280" y2="320"/>
+    <line x1="0" y1="480" x2="1280" y2="480"/>
+    <line x1="320" y1="0" x2="320" y2="640"/>
+    <line x1="640" y1="0" x2="640" y2="640"/>
+    <line x1="960" y1="0" x2="960" y2="640"/>
+  </g>
+
+  <!-- Accent top bar -->
+  <rect x="0" y="0" width="1280" height="4" fill="url(#accent)"/>
+
+  <!-- Decorative chart line (right side) -->
+  <polyline
+    points="680,520 740,480 800,490 860,420 920,440 980,360 1040,380 1100,300 1160,320 1220,260 1280,240"
+    fill="none" stroke="#00d4aa" stroke-width="2.5" opacity="0.5"/>
+
+  <!-- Glow under chart line -->
+  <polygon
+    points="680,520 740,480 800,490 860,420 920,440 980,360 1040,380 1100,300 1160,320 1220,260 1280,240 1280,640 680,640"
+    fill="url(#glow)" opacity="0.4"/>
+
+  <!-- Volatility cone shapes (decorative) -->
+  <polygon points="900,500 1000,300 1100,500" fill="#0094ff" opacity="0.07"/>
+  <polygon points="920,500 1000,340 1080,500" fill="#00d4aa" opacity="0.07"/>
+
+  <!-- Left side content -->
+  <!-- Icon circle -->
+  <circle cx="120" cy="200" r="48" fill="#00d4aa" opacity="0.15"/>
+  <circle cx="120" cy="200" r="36" fill="#00d4aa" opacity="0.2"/>
+  <text x="120" y="212" font-family="monospace" font-size="28" fill="#00d4aa" text-anchor="middle">QT</text>
+
+  <!-- Main title -->
+  <text x="195" y="190" font-family="-apple-system, BlinkMacSystemFont, Segoe UI, sans-serif" font-size="52" font-weight="700" fill="#ffffff">Quantum Terminal</text>
+
+  <!-- Subtitle -->
+  <text x="195" y="230" font-family="-apple-system, BlinkMacSystemFont, Segoe UI, sans-serif" font-size="22" fill="#8b949e">Free &amp; Open Source Trading Terminal</text>
+
+  <!-- Divider line -->
+  <rect x="80" y="268" width="560" height="2" fill="url(#accent)" rx="1"/>
+
+  <!-- Feature tags -->
+  <!-- Tag 1: Python / FastAPI -->
+  <rect x="80" y="295" width="160" height="36" rx="18" fill="#00d4aa" opacity="0.15"/>
+  <rect x="80" y="295" width="160" height="36" rx="18" fill="none" stroke="#00d4aa" stroke-width="1" opacity="0.4"/>
+  <text x="160" y="319" font-family="monospace" font-size="14" fill="#00d4aa" text-anchor="middle">Python / FastAPI</text>
+
+  <!-- Tag 2: Electron -->
+  <rect x="252" y="295" width="120" height="36" rx="18" fill="#0094ff" opacity="0.15"/>
+  <rect x="252" y="295" width="120" height="36" rx="18" fill="none" stroke="#0094ff" stroke-width="1" opacity="0.4"/>
+  <text x="312" y="319" font-family="monospace" font-size="14" fill="#0094ff" text-anchor="middle">Electron</text>
+
+  <!-- Tag 3: MIT License -->
+  <rect x="384" y="295" width="120" height="36" rx="18" fill="#3fb950" opacity="0.15"/>
+  <rect x="384" y="295" width="120" height="36" rx="18" fill="none" stroke="#3fb950" stroke-width="1" opacity="0.4"/>
+  <text x="444" y="319" font-family="monospace" font-size="14" fill="#3fb950" text-anchor="middle">MIT License</text>
+
+  <!-- Feature list -->
+  <!-- Item 1 -->
+  <circle cx="97" cy="378" r="5" fill="#00d4aa"/>
+  <text x="115" y="384" font-family="-apple-system, BlinkMacSystemFont, Segoe UI, sans-serif" font-size="18" fill="#c9d1d9">Volatility Cones &amp; GEX Overlays</text>
+
+  <!-- Item 2 -->
+  <circle cx="97" cy="420" r="5" fill="#0094ff"/>
+  <text x="115" y="426" font-family="-apple-system, BlinkMacSystemFont, Segoe UI, sans-serif" font-size="18" fill="#c9d1d9">Live MT5 / Rithmic / Tradovate Feeds</text>
+
+  <!-- Item 3 -->
+  <circle cx="97" cy="462" r="5" fill="#f78166"/>
+  <text x="115" y="468" font-family="-apple-system, BlinkMacSystemFont, Segoe UI, sans-serif" font-size="18" fill="#c9d1d9">Max Pain &amp; Dealer Positioning</text>
+
+  <!-- Item 4 -->
+  <circle cx="97" cy="504" r="5" fill="#d2a8ff"/>
+  <text x="115" y="510" font-family="-apple-system, BlinkMacSystemFont, Segoe UI, sans-serif" font-size="18" fill="#c9d1d9">Open Source — Contributors Welcome</text>
+
+  <!-- Bottom GitHub link -->
+  <text x="80" y="590" font-family="monospace" font-size="16" fill="#8b949e">github.com/wJubran/QuantumTerminal</text>
+
+  <!-- Bottom right stars/stats area -->
+  <text x="1200" y="590" font-family="monospace" font-size="14" fill="#3fb950" text-anchor="end">v0.1.0-alpha</text>
+</svg>