diff --git a/README.md b/README.md
index 3c73c44..f4983c3 100644
--- a/README.md
+++ b/README.md
@@ -1,16 +1,28 @@
+<p align="center">
+  <img src="docs/assets/banner.png" alt="FastCloud. Any cloud. One interface." width="100%" />
+</p>
 
-<h1 align="center" style="margin-top:-25px">FastCloud</h1>
+<p align="center">
+  <a href="https://pypi.org/project/fastcloud/"><img src="https://img.shields.io/pypi/v/fastcloud?labelColor=000000&color=76B900" alt="PyPI version"></a>
+  <a href="https://pypi.org/project/fastcloud/"><img src="https://img.shields.io/pypi/pyversions/fastcloud?labelColor=000000&color=76B900" alt="Python versions"></a>
+  <a href="https://github.com/SocAIty/fastCloud"><img src="https://img.shields.io/badge/github-SocAIty%2FfastCloud-76B900?labelColor=000000" alt="GitHub"></a>
+</p>
 
-<h3 align="center" style="margin-top:-10px">Up & Download files to any cloud storage.</h3>
+<h3 align="center">Any cloud. One interface.</h3>
 
-Simplistic unified interface for uploading and downloading files to the cloud. 
+<p align="center">
+  Upload and download files to any cloud through one client.<br>
+  Switch between Azure Blob, S3, Socaity and Replicate without changing your code.
+</p>
+
+Simplistic unified interface for uploading and downloading files to the cloud.
 
 Supports
-- Azure Blob Storage  :white_check_mark:
+- Azure Blob Storage :white_check_mark:
+- S3 :white_check_mark:
 - Socaity Upload API
 - Replicate Upload API
 
-
 # Installation
 
 Install via pypi with:
diff --git a/docs/assets/banner.html b/docs/assets/banner.html
new file mode 100644
index 0000000..5d17536
--- /dev/null
+++ b/docs/assets/banner.html
@@ -0,0 +1,118 @@
+<!doctype html>
+<!-- fastCloud SDK README banner, derived from the socaity SDK banner (socaity/docs/assets/banner.html).
+     Render to PNG @2x via headless Chrome:
+     "Google Chrome" --headless --screenshot=banner.png --window-size=1280,380 --force-device-scale-factor=2 \
+       --hide-scrollbars --default-background-color=00000000 banner.html -->
+<html lang="en">
+<head>
+<meta charset="utf-8">
+<link rel="preconnect" href="https://fonts.googleapis.com">
+<link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
+<link href="https://fonts.googleapis.com/css2?family=JetBrains+Mono:wght@400;500;700&family=Roboto:wght@400;500;700&display=swap" rel="stylesheet">
+<style>
+  /* --- real brand tokens (socaity_frontend/plugins/vuetify.ts: socaityDark) --- */
+  :root{
+    --void:#000000; --surface:#0F0F0F; --surface-container:#161616;
+    --neon:#76B900; --silicon:#0A86BF; --creator:#7C3AED; --rose:#EC4899;
+    --text:#FFFFFF; --text-2:#B0B0B0; --text-3:#707070; --border:#222222;
+    --syntax-keyword:#c084fc; --syntax-function:#60a5fa; --syntax-decorator:#f472b6;
+  }
+  *{margin:0;padding:0;box-sizing:border-box}
+  html,body{background:var(--void)}
+  .banner{
+    position:relative; width:1280px; height:380px; overflow:hidden;
+    background:var(--void); display:flex; align-items:center;
+    font-family:'Roboto',system-ui,sans-serif; color:var(--text);
+  }
+  /* --- HeroGlow: dual neon+silicon radial orbs on black --- */
+  .glow{position:absolute; inset:0; pointer-events:none}
+  .glow-1{opacity:.7;
+    background:
+      radial-gradient(circle at 30% 40%, rgba(118,185,0,.35) 0%, transparent 35%),
+      radial-gradient(circle at 70% 30%, rgba(10,134,191,.25) 0%, transparent 35%);}
+  .glow-2{opacity:.5;
+    background:
+      radial-gradient(circle at 82% 72%, rgba(10,134,191,.20) 0%, transparent 26%),
+      radial-gradient(circle at 18% 82%, rgba(118,185,0,.15) 0%, transparent 26%);}
+  .grid{position:absolute; inset:0; opacity:.04;
+    background-image:linear-gradient(var(--border) 1px,transparent 1px),linear-gradient(90deg,var(--border) 1px,transparent 1px);
+    background-size:40px 40px;}
+
+  .wrap{position:relative; z-index:1; display:flex; align-items:center; gap:48px;
+        width:100%; padding:0 56px;}
+  .left{flex:1; min-width:0}
+
+  /* pill badge (framework-badge) */
+  .badge{display:inline-flex; align-items:center; gap:8px; padding:7px 16px; border-radius:999px;
+    background:rgba(118,185,0,.08); border:1px solid rgba(118,185,0,.2); margin-bottom:22px;}
+  .badge .dot{width:7px;height:7px;border-radius:50%;background:var(--neon);box-shadow:0 0 10px rgba(118,185,0,.9)}
+  .badge span{font:700 11px/1 'JetBrains Mono',monospace; letter-spacing:.14em; text-transform:uppercase; color:var(--text-2)}
+
+  /* logo + separator + title */
+  .titlerow{display:flex; align-items:center; margin-bottom:18px}
+  .logo{width:74px;height:74px;flex:none;filter:drop-shadow(0 0 16px rgba(118,185,0,.25))}
+  .sep{width:1px;height:90px;background:#fff;opacity:.15;margin:0 22px}
+  h1{font:700 44px/1 'Roboto',sans-serif; letter-spacing:-2px}
+  h1 .neon{color:var(--neon)}
+  h1 .creator{color:var(--creator)}
+  .tagline{font:500 17px/1 'JetBrains Mono',monospace; letter-spacing:.15em; text-transform:uppercase;
+    margin-top:10px; color:var(--text)}
+  .tagline .info{color:var(--silicon)}
+
+  .subtitle{font:500 16px/1.6 'Roboto',sans-serif; color:var(--text-2); max-width:440px; margin-top:6px}
+  .subtitle .w{color:var(--text)}
+  .subtitle .q{font-family:'JetBrains Mono',monospace; color:var(--neon); font-size:.92em}
+
+  /* macOS code window (right column) */
+  .window{flex:none; width:572px; border-radius:14px; overflow:hidden;
+    background:var(--surface-container); border:1px solid rgba(118,185,0,.3);
+    box-shadow:0 25px 50px -12px rgba(0,0,0,.5), 0 0 40px rgba(118,185,0,.12);}
+  .titlebar{display:flex; align-items:center; gap:8px; padding:11px 16px; background:var(--surface);
+    border-bottom:1px solid var(--border)}
+  .titlebar .d{width:12px;height:12px;border-radius:50%}
+  .d.r{background:#ff5f56}.d.y{background:#ffbd2e}.d.g{background:#27c93f}
+  .titlebar .fn{margin-left:10px; font:400 13px/1 'JetBrains Mono',monospace; color:rgba(255,255,255,.45)}
+  .titlebar .st{margin-left:auto; font:500 12px/1 'JetBrains Mono',monospace; color:var(--neon)}
+  .bar{height:3px;background:var(--neon);opacity:.6}
+  pre{margin:0; padding:20px 22px; background:var(--surface);
+    font:400 12px/1.9 'JetBrains Mono',monospace; color:rgba(255,255,255,.82); white-space:pre}
+  .k{color:var(--syntax-keyword)} .fn2{color:var(--syntax-function)} .s{color:var(--neon)}
+  .c{color:var(--text-3)}
+</style>
+</head>
+<body>
+  <div class="banner">
+    <div class="glow glow-1"></div>
+    <div class="glow glow-2"></div>
+    <div class="grid"></div>
+    <div class="wrap">
+      <div class="left">
+        <div class="badge"><span class="dot"></span><span>Python SDK, Azure, S3, Replicate</span></div>
+        <div class="titlerow">
+          <img class="logo" src="./socaity_logo.png" alt="SocAIty">
+          <div class="sep"></div>
+          <div>
+            <h1>Any <span class="neon">cloud</span>.<br>One <span class="creator">interface</span>.</h1>
+            <div class="tagline">pip install <span class="info">fastcloud</span></div>
+          </div>
+        </div>
+        <p class="subtitle"><span class="w">Upload and download files to any cloud.</span><br>
+          One client for Azure Blob, S3, Socaity and Replicate.<span class="q"> Store anywhere.</span></p>
+      </div>
+
+      <div class="window">
+        <div class="titlebar">
+          <span class="d r"></span><span class="d y"></span><span class="d g"></span>
+          <span class="fn">quickstart.py</span><span class="st">azure blob</span>
+        </div>
+        <div class="bar"></div>
+<pre><span class="k">from</span> fastcloud <span class="k">import</span> AzureBlobStorage
+
+store = <span class="fn2">AzureBlobStorage</span>(connection_string=<span class="s">"..."</span>)
+url = store.<span class="fn2">upload</span>(file=<span class="s">"cat.png"</span>, folder=<span class="s">"uploads"</span>)
+store.<span class="fn2">download</span>(url, save_path=<span class="s">"out.png"</span>)  <span class="c"># returns a path</span></pre>
+      </div>
+    </div>
+  </div>
+</body>
+</html>
diff --git a/docs/assets/banner.png b/docs/assets/banner.png
new file mode 100644
index 0000000..e796097
Binary files /dev/null and b/docs/assets/banner.png differ
diff --git a/docs/assets/socaity_logo.png b/docs/assets/socaity_logo.png
new file mode 100755
index 0000000..c5b9900
Binary files /dev/null and b/docs/assets/socaity_logo.png differ
