From de3933d7c0efd763c81a456adbebd844fd806b10 Mon Sep 17 00:00:00 2001
From: Christian Benincasa <chrisbenincasa@gmail.com>
Date: Mon, 13 Apr 2026 21:12:34 -0400
Subject: [PATCH] docs: add social top bar to docs

---
 docs/generated/openapi-specs.js     |  2 +-
 docs/overrides/partials/header.html | 78 +++++++++++++++++++++++++++++
 docs/stylesheets/extra.css          |  5 ++
 mkdocs.yml                          |  5 ++
 4 files changed, 89 insertions(+), 1 deletion(-)
 create mode 100644 docs/overrides/partials/header.html

diff --git a/docs/generated/openapi-specs.js b/docs/generated/openapi-specs.js
index 1f76cc7f6..3a5d32608 100644
--- a/docs/generated/openapi-specs.js
+++ b/docs/generated/openapi-specs.js
@@ -1,2 +1,2 @@
 
-const sources = [{"title":"Latest","slug":"latest","url":"/generated/tunarr-latest-openapi.json"},{"title":"1.1.3","slug":"1.1.3","url":"/generated/tunarr-v1.1.3-openapi.json"},{"title":"1.1.1","slug":"1.1.1","url":"/generated/tunarr-v1.1.1-openapi.json"},{"title":"1.1.0-dev.3","slug":"1.1.0-dev.3","url":"/generated/tunarr-v1.1.0-dev.3-openapi.json"},{"title":"1.1.0-dev.1","slug":"1.1.0-dev.1","url":"/generated/tunarr-v1.1.0-dev.1-openapi.json"},{"title":"1.1.0-dev.0","slug":"1.1.0-dev.0","url":"/generated/tunarr-v1.1.0-dev.0-openapi.json"},{"title":"1.0.18","slug":"1.0.18","url":"/generated/tunarr-v1.0.18-openapi.json"},{"title":"1.0.17","slug":"1.0.17","url":"/generated/tunarr-v1.0.17-openapi.json"},{"title":"1.0.16","slug":"1.0.16","url":"/generated/tunarr-v1.0.16-openapi.json"},{"title":"1.0.15","slug":"1.0.15","url":"/generated/tunarr-v1.0.15-openapi.json"},{"title":"1.0.11","slug":"1.0.11","url":"/generated/tunarr-v1.0.11-openapi.json"},{"title":"1.0.9","slug":"1.0.9","url":"/generated/tunarr-v1.0.9-openapi.json"},{"title":"1.0.8","slug":"1.0.8","url":"/generated/tunarr-v1.0.8-openapi.json"},{"title":"1.0.7","slug":"1.0.7","url":"/generated/tunarr-v1.0.7-openapi.json"},{"title":"1.0.3","slug":"1.0.3","url":"/generated/tunarr-v1.0.3-openapi.json"},{"title":"0.22.11","slug":"0.22.11","url":"/generated/tunarr-v0.22.11-openapi.json"}]
+const sources = [{"title":"Latest","slug":"latest","url":"/generated/tunarr-latest-openapi.json"},{"title":"1.2.0-dev.1","slug":"1.2.0-dev.1","url":"/generated/tunarr-v1.2.0-dev.1-openapi.json"},{"title":"1.1.3","slug":"1.1.3","url":"/generated/tunarr-v1.1.3-openapi.json"},{"title":"1.1.1","slug":"1.1.1","url":"/generated/tunarr-v1.1.1-openapi.json"},{"title":"1.1.0-dev.3","slug":"1.1.0-dev.3","url":"/generated/tunarr-v1.1.0-dev.3-openapi.json"},{"title":"1.1.0-dev.1","slug":"1.1.0-dev.1","url":"/generated/tunarr-v1.1.0-dev.1-openapi.json"},{"title":"1.1.0-dev.0","slug":"1.1.0-dev.0","url":"/generated/tunarr-v1.1.0-dev.0-openapi.json"},{"title":"1.0.18","slug":"1.0.18","url":"/generated/tunarr-v1.0.18-openapi.json"},{"title":"1.0.17","slug":"1.0.17","url":"/generated/tunarr-v1.0.17-openapi.json"},{"title":"1.0.16","slug":"1.0.16","url":"/generated/tunarr-v1.0.16-openapi.json"},{"title":"1.0.15","slug":"1.0.15","url":"/generated/tunarr-v1.0.15-openapi.json"},{"title":"1.0.11","slug":"1.0.11","url":"/generated/tunarr-v1.0.11-openapi.json"},{"title":"1.0.9","slug":"1.0.9","url":"/generated/tunarr-v1.0.9-openapi.json"},{"title":"1.0.8","slug":"1.0.8","url":"/generated/tunarr-v1.0.8-openapi.json"},{"title":"1.0.7","slug":"1.0.7","url":"/generated/tunarr-v1.0.7-openapi.json"},{"title":"1.0.3","slug":"1.0.3","url":"/generated/tunarr-v1.0.3-openapi.json"},{"title":"0.22.11","slug":"0.22.11","url":"/generated/tunarr-v0.22.11-openapi.json"}]
diff --git a/docs/overrides/partials/header.html b/docs/overrides/partials/header.html
new file mode 100644
index 000000000..4f68116e5
--- /dev/null
+++ b/docs/overrides/partials/header.html
@@ -0,0 +1,78 @@
+{#-
+  This file was automatically generated - do not edit
+-#}
+{% set class = "md-header" %}
+{% if "navigation.tabs.sticky" in features %}
+  {% set class = class ~ " md-header--shadow md-header--lifted" %}
+{% elif "navigation.tabs" not in features %}
+  {% set class = class ~ " md-header--shadow" %}
+{% endif %}
+<header class="{{ class }}" data-md-component="header">
+  <nav class="md-header__inner md-grid" aria-label="{{ lang.t('header') }}">
+    <a href="{{ config.extra.homepage | d(nav.homepage.url, true) | url }}" title="{{ config.site_name | e }}" class="md-header__button md-logo" aria-label="{{ config.site_name }}" data-md-component="logo">
+      {% include "partials/logo.html" %}
+    </a>
+    <label class="md-header__button md-icon" for="__drawer">
+      {% set icon = config.theme.icon.menu or "material/menu" %}
+      {% include ".icons/" ~ icon ~ ".svg" %}
+    </label>
+    <div class="md-header__title" data-md-component="header-title">
+      <div class="md-header__ellipsis">
+        <div class="md-header__topic">
+          <span class="md-ellipsis">
+            {{ config.site_name }}
+          </span>
+        </div>
+        <div class="md-header__topic" data-md-component="header-topic">
+          <span class="md-ellipsis">
+            {% if page.meta and page.meta.title %}
+              {{ page.meta.title }}
+            {% else %}
+              {{ page.title }}
+            {% endif %}
+          </span>
+        </div>
+      </div>
+    </div>
+    {% if config.theme.palette %}
+      {% if not config.theme.palette is mapping %}
+        {% include "partials/palette.html" %}
+      {% endif %}
+    {% endif %}
+    {% if not config.theme.palette is mapping %}
+      {% include "partials/javascripts/palette.html" %}
+    {% endif %}
+    {% if config.extra.alternate %}
+      {% include "partials/alternate.html" %}
+    {% endif %}
+    {% if "material/search" in config.plugins %}
+      {% set search = config.plugins["material/search"] | attr("config") %}
+      {% if search.enabled %}
+        <label class="md-header__button md-icon" for="__search">
+          {% set icon = config.theme.icon.search or "material/magnify" %}
+          {% include ".icons/" ~ icon ~ ".svg" %}
+        </label>
+        {% include "partials/search.html" %}
+      {% endif %}
+    {% endif %}
+    {% if config.extra.social %}
+      <div class="md-header__social">
+        {% for social in config.extra.social %}
+          <a href="{{ social.link }}" {% if social.name %}title="{{ social.name }}"{% endif %} class="md-header__button md-icon" target="_blank" rel="noopener">
+            {% include ".icons/" ~ social.icon ~ ".svg" %}
+          </a>
+        {% endfor %}
+      </div>
+    {% endif %}
+    {% if config.repo_url %}
+      <div class="md-header__source">
+        {% include "partials/source.html" %}
+      </div>
+    {% endif %}
+  </nav>
+  {% if "navigation.tabs.sticky" in features %}
+    {% if "navigation.tabs" in features %}
+      {% include "partials/tabs.html" %}
+    {% endif %}
+  {% endif %}
+</header>
diff --git a/docs/stylesheets/extra.css b/docs/stylesheets/extra.css
index ab3916ce2..c260eebd3 100644
--- a/docs/stylesheets/extra.css
+++ b/docs/stylesheets/extra.css
@@ -1,3 +1,8 @@
+.md-header__social {
+  display: flex;
+  gap: 0.15rem;
+}
+
 [data-md-color-scheme='tunarr'] {
   --md-primary-fg-color: #008c93;
   --md-primary-fg-color--light: #ecb7b7;
diff --git a/mkdocs.yml b/mkdocs.yml
index 51761f747..87491197f 100644
--- a/mkdocs.yml
+++ b/mkdocs.yml
@@ -5,6 +5,7 @@ edit_uri: edit/dev/docs/
 site_url: https://tunarr.com/
 theme:
   name: material
+  custom_dir: docs/overrides
   palette:
     # Palette toggle for automatic mode
     - media: "(prefers-color-scheme)"
@@ -131,6 +132,10 @@ extra:
   social:
     - icon: fontawesome/brands/discord
       link: https://discord.gg/nYkb7MhPfD
+      name: Join the Tunarr Discord
+    - icon: fontawesome/solid/heart
+      link: https://github.com/sponsors/chrisbenincasa
+      name: Sponsor Tunarr on GitHub
 
 plugins:
   - glightbox