From 3efc27a493b0d3633a6f5d5c5d8dc05ff26db286 Mon Sep 17 00:00:00 2001
From: Lukas Devos <ldevos98@gmail.com>
Date: Thu, 14 May 2026 14:27:42 -0400
Subject: [PATCH 1/2] add logos

---
 docs/src/assets/logo-dark.svg | 13 +++++++++++++
 docs/src/assets/logo.svg      | 13 +++++++++++++
 2 files changed, 26 insertions(+)
 create mode 100644 docs/src/assets/logo-dark.svg
 create mode 100644 docs/src/assets/logo.svg

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

From 85ac1f816b59121deeb39beb4c1bb70375ee3682 Mon Sep 17 00:00:00 2001
From: Lukas Devos <ldevos98@gmail.com>
Date: Thu, 14 May 2026 14:29:35 -0400
Subject: [PATCH 2/2] add logo to README

---
 README.md | 6 ++++++
 1 file changed, 6 insertions(+)

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.