diff --git a/README.md b/README.md
index ae193f23..6d66b54e 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,9 @@
+<picture>
+    <source media="(prefers-color-scheme: dark)" srcset="https://github.com/QuantumKitHub/MatrixAlgebraKit.jl/blob/main/docs/src/assets/logo-dark.svg">
+    <img alt="MatrixAlgebraKit.jl logo" src="https://github.com/QuantumKitHub/MatrixAlgebraKit.jl/blob/main/docs/src/assets/logo.svg" width="150">
+</picture>
+
+
 # MatrixAlgebraKit
 
 A Julia interface for matrix algebra, with a focus on performance, flexibility and extensibility.
diff --git a/docs/src/assets/logo-dark.svg b/docs/src/assets/logo-dark.svg
new file mode 100644
index 00000000..06e8f23d
--- /dev/null
+++ b/docs/src/assets/logo-dark.svg
@@ -0,0 +1,13 @@
+<svg viewBox="0 0 325 100" xmlns="http://www.w3.org/2000/svg">
+  <!-- Connecting line: external legs on the sides, internal bonds between shapes -->
+  <line x1="0" y1="50" x2="325" y2="50" stroke="#E5E5E5" stroke-width="4" stroke-linecap="round"/>
+
+  <!-- Left triangle (red) pointing inward (right) -->
+  <polygon points="15,8 15,92 75,50" fill="#CB3C33"/>
+
+  <!-- Middle circle (green) -->
+  <circle cx="162.5" cy="50" r="42" fill="#389826"/>
+
+  <!-- Right triangle (purple) pointing inward (left) -->
+  <polygon points="250,50 310,8 310,92" fill="#9558B2"/>
+</svg>
\ No newline at end of file
diff --git a/docs/src/assets/logo.svg b/docs/src/assets/logo.svg
new file mode 100644
index 00000000..1bc63746
--- /dev/null
+++ b/docs/src/assets/logo.svg
@@ -0,0 +1,13 @@
+<svg viewBox="0 0 325 100" xmlns="http://www.w3.org/2000/svg">
+  <!-- Connecting line: external legs on the sides, internal bonds between shapes -->
+  <line x1="0" y1="50" x2="325" y2="50" stroke="#2A2A2A" stroke-width="4" stroke-linecap="round"/>
+
+  <!-- Left triangle (red) pointing inward (right) -->
+  <polygon points="15,8 15,92 75,50" fill="#CB3C33"/>
+
+  <!-- Middle circle (green) -->
+  <circle cx="162.5" cy="50" r="42" fill="#389826"/>
+
+  <!-- Right triangle (purple) pointing inward (left) -->
+  <polygon points="250,50 310,8 310,92" fill="#9558B2"/>
+</svg>
\ No newline at end of file