diff --git a/docs/stylesheets/locus.css b/docs/stylesheets/locus.css
index 3d9f0be7..d2f8bb06 100644
--- a/docs/stylesheets/locus.css
+++ b/docs/stylesheets/locus.css
@@ -662,6 +662,30 @@ html {
.md-drawer .md-header__source.md-header__github {
color: #FFFFFF;
}
+
+/* Header right slot — PyPI version badge (shields.io image) sits to the
+ right of the GitHub icon. Matches the OCI/GitHub vertical rhythm. */
+.md-header__source.md-header__pypi {
+ display: inline-flex;
+ align-items: center;
+ padding: 0.25rem 0.4rem;
+ margin-left: 0.25rem;
+ border-radius: 6px;
+ transition: background-color 0.15s, transform 0.15s;
+}
+.md-header__source.md-header__pypi:hover {
+ background-color: rgba(199, 70, 52, 0.08);
+ transform: translateY(-1px);
+}
+.md-header__pypi-badge {
+ height: 20px;
+ width: auto;
+ display: block;
+}
+@media (max-width: 60em) {
+ .md-header__source.md-header__pypi { padding: 0.15rem 0.25rem; margin-left: 0.15rem; }
+ .md-header__pypi-badge { height: 18px; }
+}
.md-nav--primary .md-header__source.md-header__github:hover {
color: #FFFFFF;
opacity: 0.8;
diff --git a/overrides/partials/source.html b/overrides/partials/source.html
index 72b2d3ca..521ccc4d 100644
--- a/overrides/partials/source.html
+++ b/overrides/partials/source.html
@@ -25,3 +25,14 @@
+
+
+