From 0f1a16623d326d455780891003620500154d6bd0 Mon Sep 17 00:00:00 2001
From: Sasha Abramowitz <reallysasha@gmail.com>
Date: Wed, 20 May 2026 17:45:09 +0200
Subject: [PATCH 1/3] docs: readme updates

---
 README.md     |  9 ++++++---
 docs/logo.svg | 13 +++++++++++++
 2 files changed, 19 insertions(+), 3 deletions(-)
 create mode 100644 docs/logo.svg

diff --git a/README.md b/README.md
index 5649f26..bd2db83 100644
--- a/README.md
+++ b/README.md
@@ -1,6 +1,11 @@
+<p align="center">
+  <img src="docs/logo.svg" alt="echo" width="180">
+</p>
+
 # echo
 
 <p align="center">
+  <a href="https://github.com/instadeepai/echo/actions/workflows/ci.yml"><img src="https://github.com/instadeepai/echo/actions/workflows/ci.yml/badge.svg" alt="CI"></a>
   <a href="https://instadeepai.github.io/echo/"><img src="https://img.shields.io/badge/docs-instadeepai.github.io%2Fecho-blue?style=flat-square&logo=materialformkdocs" alt="Docs"></a>
   <a href="https://pypi.org/project/id-echo/"><img src="https://img.shields.io/pypi/v/id-echo?style=flat-square&logo=pypi&logoColor=white" alt="PyPI"></a>
   <a href="https://github.com/instadeepai/echo/blob/main/pyproject.toml"><img src="https://img.shields.io/python/required-version-toml?tomlFilePath=https%3A%2F%2Fraw.githubusercontent.com%2Finstadeepai%2Fecho%2Fmain%2Fpyproject.toml&style=flat-square&logo=python&logoColor=white&label=python" alt="Python"></a>
@@ -11,8 +16,6 @@ is a lockfree, pre-allocated Rust ring buffer. Batches come back to Python
 as zero-copy numpy views, with the GIL released while you wait for the next
 batch.
 
-<p align="center"><a href="https://instadeepai.github.io/echo/"><b>📖 Documentation</b></a></p>
-
 ## Install
 
 ```bash
@@ -47,7 +50,7 @@ pytree-agnostic.
 ## Example
 
 A typical setup runs the server on the learner node and clients on rollout
-workers (separate processes or machines).
+workers (separate processes or machines). See more detailed examples in the [documentation](https://instadeepai.github.io/echo/).
 
 **Learner side** (one process):
 
diff --git a/docs/logo.svg b/docs/logo.svg
new file mode 100644
index 0000000..2ea4294
--- /dev/null
+++ b/docs/logo.svg
@@ -0,0 +1,13 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 200 200" fill="none" stroke-width="5" stroke-linecap="round">
+  <defs>
+    <radialGradient id="echoGrad" cx="100" cy="100" r="95" gradientUnits="userSpaceOnUse">
+      <stop offset="0" stop-color="#6BB6D6"/>
+      <stop offset="1" stop-color="#A8D8A0"/>
+    </radialGradient>
+  </defs>
+  <rect width="200" height="200" fill="white" stroke="none"/>
+  <circle cx="130" cy="100" r="62" stroke="url(#echoGrad)" opacity="0.45"/>
+  <circle cx="118" cy="100" r="44" stroke="url(#echoGrad)" opacity="0.65"/>
+  <circle cx="108" cy="100" r="28" stroke="url(#echoGrad)" opacity="0.85"/>
+  <circle cx="100" cy="100" r="15" stroke="url(#echoGrad)" opacity="1"/>
+</svg>

From ca6e2d07165fab58de086e6579747d626552af2e Mon Sep 17 00:00:00 2001
From: Sasha Abramowitz <reallysasha@gmail.com>
Date: Wed, 20 May 2026 17:55:26 +0200
Subject: [PATCH 2/3] chore: update logo

---
 docs/logo.svg | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/docs/logo.svg b/docs/logo.svg
index 2ea4294..64bd75f 100644
--- a/docs/logo.svg
+++ b/docs/logo.svg
@@ -1,13 +1,13 @@
-<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 200 200" fill="none" stroke-width="5" stroke-linecap="round">
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 200 200" fill="none" stroke-width="7" stroke-linecap="round">
   <defs>
     <radialGradient id="echoGrad" cx="100" cy="100" r="95" gradientUnits="userSpaceOnUse">
       <stop offset="0" stop-color="#6BB6D6"/>
       <stop offset="1" stop-color="#A8D8A0"/>
     </radialGradient>
   </defs>
-  <rect width="200" height="200" fill="white" stroke="none"/>
-  <circle cx="130" cy="100" r="62" stroke="url(#echoGrad)" opacity="0.45"/>
-  <circle cx="118" cy="100" r="44" stroke="url(#echoGrad)" opacity="0.65"/>
-  <circle cx="108" cy="100" r="28" stroke="url(#echoGrad)" opacity="0.85"/>
+  <rect width="200" height="200" fill="none" stroke="none"/>
+  <circle cx="124" cy="100" r="63" stroke="url(#echoGrad)" opacity="0.45"/>
+  <circle cx="116" cy="100" r="47" stroke="url(#echoGrad)" opacity="0.65"/>
+  <circle cx="108" cy="100" r="31" stroke="url(#echoGrad)" opacity="0.85"/>
   <circle cx="100" cy="100" r="15" stroke="url(#echoGrad)" opacity="1"/>
 </svg>

From b64ffcae3d55dd350b80dc7dc30bf641564aa42c Mon Sep 17 00:00:00 2001
From: Sasha Abramowitz <reallysasha@gmail.com>
Date: Thu, 21 May 2026 09:56:37 +0200
Subject: [PATCH 3/3] docs: nicer logo

---
 README.md                |  4 +---
 docs/logo.svg            | 13 -------------
 docs/src/assets/logo.svg | 22 ++++++++++++++++++++++
 docs/src/index.md        |  4 +++-
 mkdocs.yml               |  1 +
 5 files changed, 27 insertions(+), 17 deletions(-)
 delete mode 100644 docs/logo.svg
 create mode 100644 docs/src/assets/logo.svg

diff --git a/README.md b/README.md
index bd2db83..61663c6 100644
--- a/README.md
+++ b/README.md
@@ -1,9 +1,7 @@
 <p align="center">
-  <img src="docs/logo.svg" alt="echo" width="180">
+  <img src="docs/src/assets/logo.svg" alt="echo" width="320">
 </p>
 
-# echo
-
 <p align="center">
   <a href="https://github.com/instadeepai/echo/actions/workflows/ci.yml"><img src="https://github.com/instadeepai/echo/actions/workflows/ci.yml/badge.svg" alt="CI"></a>
   <a href="https://instadeepai.github.io/echo/"><img src="https://img.shields.io/badge/docs-instadeepai.github.io%2Fecho-blue?style=flat-square&logo=materialformkdocs" alt="Docs"></a>
diff --git a/docs/logo.svg b/docs/logo.svg
deleted file mode 100644
index 64bd75f..0000000
--- a/docs/logo.svg
+++ /dev/null
@@ -1,13 +0,0 @@
-<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 200 200" fill="none" stroke-width="7" stroke-linecap="round">
-  <defs>
-    <radialGradient id="echoGrad" cx="100" cy="100" r="95" gradientUnits="userSpaceOnUse">
-      <stop offset="0" stop-color="#6BB6D6"/>
-      <stop offset="1" stop-color="#A8D8A0"/>
-    </radialGradient>
-  </defs>
-  <rect width="200" height="200" fill="none" stroke="none"/>
-  <circle cx="124" cy="100" r="63" stroke="url(#echoGrad)" opacity="0.45"/>
-  <circle cx="116" cy="100" r="47" stroke="url(#echoGrad)" opacity="0.65"/>
-  <circle cx="108" cy="100" r="31" stroke="url(#echoGrad)" opacity="0.85"/>
-  <circle cx="100" cy="100" r="15" stroke="url(#echoGrad)" opacity="1"/>
-</svg>
diff --git a/docs/src/assets/logo.svg b/docs/src/assets/logo.svg
new file mode 100644
index 0000000..85f550f
--- /dev/null
+++ b/docs/src/assets/logo.svg
@@ -0,0 +1,22 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 620 250" fill="none">
+  <title>echo</title>
+  <defs>
+    <style><![CDATA[
+      @import url('https://fonts.googleapis.com/css2?family=Inter:wght@200&display=swap');
+    ]]></style>
+  </defs>
+  <text x="30" y="196"
+        font-family="'Inter', ui-sans-serif, -apple-system, BlinkMacSystemFont, 'Segoe UI', system-ui, sans-serif"
+        font-size="256"
+        font-weight="200"
+        letter-spacing="4"
+        fill="#0F766E">ech</text>
+
+  <g stroke="#0F766E" stroke-width="9" fill="none">
+    <ellipse cx="507" cy="130" rx="58" ry="65"/>
+    <ellipse cx="499" cy="130" rx="44" ry="49"/>
+    <ellipse cx="491" cy="130" rx="30" ry="34"/>
+    <ellipse cx="483" cy="130" rx="16" ry="18"/>
+  </g>
+  <!-- <circle cx="535" cy="130" r="60" stroke="#0F766E" stroke-width="20"/> -->
+</svg>
diff --git a/docs/src/index.md b/docs/src/index.md
index 42dc090..09434da 100644
--- a/docs/src/index.md
+++ b/docs/src/index.md
@@ -1,4 +1,6 @@
-# echo
+<p align="center">
+  <img src="assets/logo.svg" alt="echo" width="320">
+</p>
 
 A very fast distributed replay buffer for reinforcement learning. The core
 is a lockfree, pre-allocated Rust ring buffer; batches come back to Python
diff --git a/mkdocs.yml b/mkdocs.yml
index b7fb23c..e32abae 100644
--- a/mkdocs.yml
+++ b/mkdocs.yml
@@ -9,6 +9,7 @@ site_dir: docs/site
 
 theme:
   name: material
+  logo: assets/logo.svg
   features:
     - navigation.tabs
     - navigation.sections