diff --git a/docs/assets/modern-python-mark.svg b/docs/assets/modern-python-mark.svg
new file mode 100644
index 0000000..e441c2a
--- /dev/null
+++ b/docs/assets/modern-python-mark.svg
@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1 1" fill="none" stroke="var(--mp)" stroke-width="0.12" stroke-linecap="square" role="img" aria-label="Modern Python"><style>:root{--mp:#356852}@media(prefers-color-scheme:dark){:root{--mp:#ffffff}}</style><path d="M 0.060 0.620 L 0.060 0.060 L 0.620 0.060"/><path d="M 0.940 0.380 L 0.940 0.940 L 0.380 0.940"/></svg>
diff --git a/docs/assets/modern-python-white.svg b/docs/assets/modern-python-white.svg
new file mode 100644
index 0000000..77b32d8
--- /dev/null
+++ b/docs/assets/modern-python-white.svg
@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 5.773 2.382" fill="#ffffff" role="img" aria-label="Modern Python"><g transform="scale(0.000488) translate(696.3,2255.3) scale(1,-1)"><path transform="translate(0.0,0)" d="M131 0 456 1660 986 460 1535 1660 1827 0H1588L1439 932L982 -71L538 933L372 0Z"/><path transform="translate(2173.8,0)" d="M108 779Q108 1105 347 1339Q585 1573 919 1573Q1249 1573 1485 1337Q1722 1101 1722 770Q1722 437 1484 205Q1245 -28 907 -28Q608 -28 370 179Q108 408 108 779ZM343 776Q343 520 515 355Q686 190 910 190Q1153 190 1320 358Q1487 528 1487 772Q1487 1019 1322 1186Q1158 1354 916 1354Q675 1354 509 1186Q343 1020 343 776Z"/><path transform="translate(4208.6,0)" d="M185 0V1544H509Q742 1544 877 1498Q1022 1453 1140 1345Q1379 1127 1379 772Q1379 416 1130 196Q1005 86 868 43Q740 0 505 0ZM418 219H523Q680 219 784 252Q888 287 972 363Q1144 520 1144 772Q1144 1026 974 1184Q821 1325 523 1325H418Z"/><path transform="translate(5900.4,0)" d="M1037 1325H418V954H1019V735H418V219H1037V0H185V1544H1037Z"/><path transform="translate(7263.2,0)" d="M708 658 1186 0H901L460 632H418V0H185V1544H458Q764 1544 900 1429Q1050 1301 1050 1091Q1050 927 956.0 809.0Q862 691 708 658ZM418 835H492Q823 835 823 1088Q823 1325 501 1325H418Z"/><path transform="translate(8701.0,0)" d="M185 0V1649L1311 471V1544H1544V-94L418 1081V0Z"/></g><g transform="scale(0.000488) translate(1207.3,4183.0) scale(1,-1)"><path transform="translate(0.0,0)" d="M418 627V0H185V1544H449Q643 1544 742 1517Q842 1490 918 1415Q1051 1285 1051 1087Q1051 875 909.0 751.0Q767 627 526 627ZM418 843H505Q826 843 826 1090Q826 1329 495 1329H418Z"/><path transform="translate(1310.8,0)" d="M497 667 -7 1544H261L614 927L968 1544H1236L730 667V0H497Z"/><path transform="translate(2744.6,0)" d="M611 1325V0H378V1325H23V1544H965V1325Z"/><path transform="translate(3937.4,0)" d="M418 940H1084V1544H1317V0H1084V721H418V0H185V1544H418Z"/><path transform="translate(5644.2,0)" d="M108 779Q108 1105 347 1339Q585 1573 919 1573Q1249 1573 1485 1337Q1722 1101 1722 770Q1722 437 1484 205Q1245 -28 907 -28Q608 -28 370 179Q108 408 108 779ZM343 776Q343 520 515 355Q686 190 910 190Q1153 190 1320 358Q1487 528 1487 772Q1487 1019 1322 1186Q1158 1354 916 1354Q675 1354 509 1186Q343 1020 343 776Z"/><path transform="translate(7679.0,0)" d="M185 0V1649L1311 471V1544H1544V-94L418 1081V0Z"/></g><path fill="none" stroke="#ffffff" stroke-width="0.07" d="M 0.035 0.550 L 0.035 0.035 L 0.550 0.035"/><path fill="none" stroke="#ffffff" stroke-width="0.07" d="M 5.738 1.832 L 5.738 2.347 L 5.223 2.347"/></svg>
diff --git a/docs/css/brand.css b/docs/css/brand.css
new file mode 100644
index 0000000..5c95b6f
--- /dev/null
+++ b/docs/css/brand.css
@@ -0,0 +1,17 @@
+/* Brand palette — forest green sampled from the org logo (#356852) */
+:root > * {
+  --md-primary-fg-color:        #356852;
+  --md-primary-fg-color--light: #4a8a6e;
+  --md-primary-fg-color--dark:  #234738;
+  --md-accent-fg-color:         #c98a00;
+}
+
+/* Dark scheme keeps the same brand hue; lighter green for body links so they
+   stay AA-readable on the dark background. */
+[data-md-color-scheme="slate"] {
+  --md-primary-fg-color:        #356852;
+  --md-primary-fg-color--light: #4a8a6e;
+  --md-primary-fg-color--dark:  #234738;
+  --md-accent-fg-color:         #e0a300;
+  --md-typeset-a-color:         #7fb79f;
+}
diff --git a/mkdocs.yml b/mkdocs.yml
index 151fc74..08af22f 100644
--- a/mkdocs.yml
+++ b/mkdocs.yml
@@ -20,6 +20,8 @@ nav:
 
 theme:
   name: material
+  logo: assets/modern-python-white.svg
+  favicon: assets/modern-python-mark.svg
   features:
     - content.code.copy
     - content.action.edit
@@ -30,19 +32,22 @@ theme:
   palette:
     - media: "(prefers-color-scheme: light)"
       scheme: default
-      primary: black
-      accent: pink
+      primary: custom
+      accent: custom
       toggle:
         icon: material/brightness-7
         name: Switch to dark mode
     - media: "(prefers-color-scheme: dark)"
       scheme: slate
-      primary: black
-      accent: pink
+      primary: custom
+      accent: custom
       toggle:
         icon: material/brightness-4
         name: Switch to system preference
 
+extra_css:
+  - css/brand.css
+
 markdown_extensions:
   - toc:
       permalink: true