diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index de02f5a..ab4dc33 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -3,8 +3,6 @@ name: CI
 on:
   pull_request:
     branches: [main, develop]
-  push:
-    branches: [main]
 
 concurrency:
   group: ci-${{ github.ref }}
diff --git a/README.md b/README.md
index 08dcf1e..f472527 100644
--- a/README.md
+++ b/README.md
@@ -1,11 +1,20 @@
-# Ark 🛳
-
-[![Maven Central](https://img.shields.io/maven-central/v/xyz.juandiii/ark-core?label=Maven%20Central)](https://central.sonatype.com/namespace/xyz.juandiii)
-[![CI](https://github.com/juandiii/ark/actions/workflows/ci.yml/badge.svg)](https://github.com/juandiii/ark/actions/workflows/ci.yml)
-[![Java 17+](https://img.shields.io/badge/Java-17%2B-orange.svg)](https://adoptium.net/)
-[![License: Apache 2.0](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](LICENSE)
-
-**A modular HTTP client toolkit for Java 17+ with fluent and declarative APIs, pluggable transports, composable decorators, and support for sync, async, and reactive applications.**
+<h1 align="center">
+  <picture>
+    <source media="(prefers-color-scheme: dark)" srcset="assets/logo/ark-logo-dark.svg">
+    <img src="assets/logo/ark-logo.svg" alt="Ark" width="320">
+  </picture>
+</h1>
+
+<p align="center">
+  <strong>A modular HTTP client toolkit for Java 17+ with fluent and declarative APIs, pluggable transports, composable decorators, and support for sync, async, and reactive applications.</strong>
+</p>
+
+<p align="center">
+  <a href="https://central.sonatype.com/namespace/xyz.juandiii"><img src="https://img.shields.io/maven-central/v/xyz.juandiii/ark-core?label=Maven%20Central" alt="Maven Central"></a>
+  <a href="https://github.com/juandiii/ark/actions/workflows/ci.yml"><img src="https://github.com/juandiii/ark/actions/workflows/ci.yml/badge.svg" alt="CI"></a>
+  <a href="https://adoptium.net/"><img src="https://img.shields.io/badge/Java-17%2B-orange.svg" alt="Java 17+"></a>
+  <a href="LICENSE"><img src="https://img.shields.io/badge/License-Apache_2.0-blue.svg" alt="License: Apache 2.0"></a>
+</p>
 
 ---
 
diff --git a/assets/logo/ark-icon.svg b/assets/logo/ark-icon.svg
new file mode 100644
index 0000000..fc94da1
--- /dev/null
+++ b/assets/logo/ark-icon.svg
@@ -0,0 +1,29 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 128 128" width="128" height="128" role="img" aria-label="Ark logo">
+  <title>Ark</title>
+  <defs>
+    <linearGradient id="ark-tile" x1="0" y1="0" x2="1" y2="1">
+      <stop offset="0" stop-color="#2dd4bf"/>
+      <stop offset="1" stop-color="#0e7490"/>
+    </linearGradient>
+  </defs>
+
+  <!-- tile -->
+  <rect x="8" y="8" width="112" height="112" rx="28" fill="url(#ark-tile)"/>
+
+  <!-- water -->
+  <g stroke="#ffffff" stroke-opacity="0.30" stroke-width="3" stroke-linecap="round" fill="none">
+    <path d="M14 96 q5 -5 10 0 t10 0"/>
+    <path d="M94 96 q5 -5 10 0 t10 0"/>
+  </g>
+
+  <!-- ark: peaked roof + trapezoidal hull -->
+  <g fill="#ffffff">
+    <!-- Hull (trapezoid, wider at deck) -->
+    <path d="M22 74 L106 74 L94 102 L34 102 Z"/>
+    <!-- Peaked roof sitting directly on deck -->
+    <path d="M40 74 L64 42 L88 74 Z"/>
+  </g>
+
+  <!-- Hull plank line -->
+  <line x1="34" y1="86" x2="94" y2="86" stroke="#0e7490" stroke-opacity="0.30" stroke-width="1.5"/>
+</svg>
diff --git a/assets/logo/ark-logo-dark.svg b/assets/logo/ark-logo-dark.svg
new file mode 100644
index 0000000..af966ea
--- /dev/null
+++ b/assets/logo/ark-logo-dark.svg
@@ -0,0 +1,38 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 280 128" role="img" aria-label="Ark — HTTP client for Java">
+  <title>Ark</title>
+  <defs>
+    <linearGradient id="ark-logo-tile-dark" x1="0" y1="0" x2="1" y2="1">
+      <stop offset="0" stop-color="#2dd4bf"/>
+      <stop offset="1" stop-color="#0e7490"/>
+    </linearGradient>
+  </defs>
+
+  <!-- ICON -->
+  <g>
+    <!-- tile -->
+    <rect x="8" y="8" width="112" height="112" rx="28" fill="url(#ark-logo-tile-dark)"/>
+
+    <!-- water -->
+    <g stroke="#ffffff" stroke-opacity="0.30" stroke-width="3" stroke-linecap="round" fill="none">
+      <path d="M14 96 q5 -5 10 0 t10 0"/>
+      <path d="M94 96 q5 -5 10 0 t10 0"/>
+    </g>
+
+    <!-- ark: peaked roof + trapezoidal hull -->
+    <g fill="#ffffff">
+      <path d="M22 74 L106 74 L94 102 L34 102 Z"/>
+      <path d="M40 74 L64 42 L88 74 Z"/>
+    </g>
+
+    <!-- Hull plank line -->
+    <line x1="34" y1="86" x2="94" y2="86" stroke="#0e7490" stroke-opacity="0.30" stroke-width="1.5"/>
+  </g>
+
+  <!-- WORDMARK (near-white for dark theme) -->
+  <text x="148" y="86"
+        font-family="-apple-system, BlinkMacSystemFont, 'Segoe UI', Inter, sans-serif"
+        font-size="80"
+        font-weight="700"
+        fill="#f8fafc"
+        letter-spacing="-3">ark</text>
+</svg>
diff --git a/assets/logo/ark-logo.svg b/assets/logo/ark-logo.svg
new file mode 100644
index 0000000..20e4c65
--- /dev/null
+++ b/assets/logo/ark-logo.svg
@@ -0,0 +1,38 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 280 128" role="img" aria-label="Ark — HTTP client for Java">
+  <title>Ark</title>
+  <defs>
+    <linearGradient id="ark-logo-tile" x1="0" y1="0" x2="1" y2="1">
+      <stop offset="0" stop-color="#2dd4bf"/>
+      <stop offset="1" stop-color="#0e7490"/>
+    </linearGradient>
+  </defs>
+
+  <!-- ICON -->
+  <g>
+    <!-- tile -->
+    <rect x="8" y="8" width="112" height="112" rx="28" fill="url(#ark-logo-tile)"/>
+
+    <!-- water -->
+    <g stroke="#ffffff" stroke-opacity="0.30" stroke-width="3" stroke-linecap="round" fill="none">
+      <path d="M14 96 q5 -5 10 0 t10 0"/>
+      <path d="M94 96 q5 -5 10 0 t10 0"/>
+    </g>
+
+    <!-- ark: peaked roof + trapezoidal hull -->
+    <g fill="#ffffff">
+      <path d="M22 74 L106 74 L94 102 L34 102 Z"/>
+      <path d="M40 74 L64 42 L88 74 Z"/>
+    </g>
+
+    <!-- Hull plank line -->
+    <line x1="34" y1="86" x2="94" y2="86" stroke="#0e7490" stroke-opacity="0.30" stroke-width="1.5"/>
+  </g>
+
+  <!-- WORDMARK (dark slate for light theme) -->
+  <text x="148" y="86"
+        font-family="-apple-system, BlinkMacSystemFont, 'Segoe UI', Inter, sans-serif"
+        font-size="80"
+        font-weight="700"
+        fill="#0f172a"
+        letter-spacing="-3">ark</text>
+</svg>