[DOC] add element to top page + fix on sidebar

Author: SimonBlanke

docs/source/_static/css/custom.css

@@ -67,6 +67,17 @@ html[data-theme="dark"] {
     --pytorch-yellow: #eaa700;
 }
 
+/* ============================================
+   Right Sidebar - On This Page spacing
+   ============================================ */
+.bd-toc-nav.page-toc {
+    margin-top: 1.25rem;
+}
+
+.pst-page-navigation-heading {
+    margin-bottom: 0.5rem;
+}
+
 /* ============================================
    Hero Section
    ============================================ */
@@ -122,13 +133,111 @@ html[data-theme="dark"] {
     margin: 0;
 }
 
+/* ============================================
+   Stats Strip (below hero)
+   ============================================ */
+.stats-strip {
+    display: flex;
+    justify-content: center;
+    align-items: stretch;
+    gap: 0;
+    margin: 0 0 2rem 0;
+    padding: 0;
+    border-radius: 12px;
+    overflow: hidden;
+    box-shadow: var(--card-shadow);
+    border: 1px solid var(--pst-color-border);
+    background: var(--pst-color-surface);
+}
+
+.stat-item {
+    flex: 1;
+    display: flex;
+    flex-direction: column;
+    align-items: center;
+    justify-content: center;
+    padding: 1.25rem 1rem;
+    text-align: center;
+    position: relative;
+    transition: background 0.2s ease;
+}
+
+.stat-item:not(:last-child)::after {
+    content: '';
+    position: absolute;
+    right: 0;
+    top: 20%;
+    height: 60%;
+    width: 1px;
+    background: var(--pst-color-border);
+}
+
+.stat-item:hover {
+    background: var(--pst-color-background);
+}
+
+.stat-value {
+    font-size: 1.75rem;
+    font-weight: 700;
+    color: var(--hyperactive-primary);
+    line-height: 1.2;
+    margin-bottom: 0.25rem;
+}
+
+html[data-theme="dark"] .stat-value {
+    color: var(--hyperactive-secondary);
+}
+
+.stat-label {
+    font-size: 0.8rem;
+    font-weight: 500;
+    color: var(--pst-color-text-muted);
+    text-transform: uppercase;
+    letter-spacing: 0.05em;
+}
+
+.stat-icon {
+    font-size: 1.25rem;
+    margin-bottom: 0.5rem;
+    opacity: 0.7;
+}
+
+/* Responsive: stack on mobile */
+@media (max-width: 640px) {
+    .stats-strip {
+        flex-wrap: wrap;
+    }
+
+    .stat-item {
+        flex: 1 1 50%;
+        padding: 1rem 0.75rem;
+    }
+
+    .stat-item:not(:last-child)::after {
+        display: none;
+    }
+
+    .stat-item:nth-child(1),
+    .stat-item:nth-child(2) {
+        border-bottom: 1px solid var(--pst-color-border);
+    }
+
+    .stat-item:nth-child(odd) {
+        border-right: 1px solid var(--pst-color-border);
+    }
+
+    .stat-value {
+        font-size: 1.5rem;
+    }
+}
+
 /* ============================================
    Badge Banner (replaces Maturity Banner)
    ============================================ */
 .badge-banner {
     text-align: center;
-    padding: 1.25rem 1rem;
-    margin: 1.5rem 0;
+    padding: 1rem 1rem 1.5rem;
+    margin: 1rem 0;
 }
 
 .badge-items {
@@ -141,17 +250,14 @@ html[data-theme="dark"] {
 
 .badge-items a {
     display: inline-block;
-    transition: transform 0.2s ease, opacity 0.2s ease;
-}
-
-.badge-items a:hover {
-    transform: translateY(-2px);
-    opacity: 0.9;
+    line-height: 0;
 }
 
 .badge-items img {
-    height: 20px;
+    height: 28px;
     vertical-align: middle;
+    border-radius: 0 !important;
+    image-rendering: crisp-edges;
 }
 
 /* Legacy Maturity Banner (kept for backwards compatibility) */

docs/source/_static/images/badges/generate_badges.py

@@ -73,14 +73,15 @@ def create_badge_svg(label: str, value: str, color: str, label_width: int = None
     return svg
 
 
-def create_simple_badge_svg(text: str, color: str, width: int = None) -> str:
+def create_simple_badge_svg(text: str, color: str, width: int = None, font_size: int = 11) -> str:
     """
     Create a simple single-section SVG badge.
 
     Args:
         text: Badge text
         color: Background color
         width: Override calculated width
+        font_size: Font size in pixels
 
     Returns:
         SVG string
@@ -89,11 +90,12 @@ def create_simple_badge_svg(text: str, color: str, width: int = None) -> str:
     padding = 16
     w = width or int(len(text) * char_width + padding * 2)
     height = 20
+    text_y = 14 if font_size >= 11 else 13.5
 
     svg = f'''<svg xmlns="http://www.w3.org/2000/svg" width="{w}" height="{height}">
   <title>{text}</title>
   <rect width="{w}" height="{height}" fill="{color}"/>
-  <text x="{w/2}" y="14" fill="#fff" font-family="DejaVu Sans,Verdana,Geneva,sans-serif" font-size="11" text-anchor="middle" font-weight="600">{text}</text>
+  <text x="{w/2}" y="{text_y}" fill="#fff" font-family="DejaVu Sans,Verdana,Geneva,sans-serif" font-size="{font_size}" text-anchor="middle" font-weight="600">{text}</text>
 </svg>'''
 
     return svg
@@ -163,7 +165,7 @@ def main():
         "version.svg": create_badge_svg("version", f"v{version}", COLORS["primary"]),
         "python.svg": create_badge_svg("python", python_range, COLORS["primary"]),
         "license.svg": create_badge_svg("license", license_name, COLORS["primary"]),
-        "sponsor.svg": create_simple_badge_svg("GC.OS Sponsored", COLORS["sponsor"], width=110),
+        "sponsor.svg": create_simple_badge_svg("GC.OS Sponsored", COLORS["sponsor"], width=105, font_size=10),
     }
 
     # Write badges

docs/source/_static/images/badges/sponsor.svg

@@ -385,10 +385,46 @@ def adds(pth):
 else:
     _py_versions_inline = "3.10+"
 
+
+# -- Count algorithms and integrations dynamically ----------------------------
+def count_from_all_list(module_path: str) -> int:
+    """Count items in __all__ list of a Python module file."""
+    import ast
+
+    file_path = Path(__file__).parent.parent.parent / "src" / module_path
+    if not file_path.exists():
+        return 0
+
+    try:
+        tree = ast.parse(file_path.read_text())
+        for node in ast.walk(tree):
+            if isinstance(node, ast.Assign):
+                for target in node.targets:
+                    if isinstance(target, ast.Name) and target.id == "__all__":
+                        if isinstance(node.value, ast.List):
+                            return len(node.value.elts)
+    except Exception:
+        pass
+    return 0
+
+
+# Count algorithms from opt/__init__.py
+_n_algorithms = count_from_all_list("hyperactive/opt/__init__.py")
+
+# Count integrations from experiment/integrations/__init__.py
+_n_integrations = count_from_all_list("hyperactive/experiment/integrations/__init__.py")
+
+# Backends are conceptual (GFO, Optuna, sklearn) - hardcoded
+_n_backends = 3
+
+
 rst_epilog = f"""
 .. |version| replace:: {PYPROJECT_METADATA["version"]}
 .. |min_python| replace:: {PYPROJECT_METADATA["min_python"]}
 .. |python_versions_list| replace:: {_py_versions_inline}
 .. |python_version_range| replace:: {_py_version_range}
 .. |current_year| replace:: {current_year}
+.. |n_algorithms| replace:: {_n_algorithms}
+.. |n_backends| replace:: {_n_backends}
+.. |n_integrations| replace:: {_n_integrations}
 """

docs/source/conf.py

@@ -9,6 +9,26 @@
       </div>
    </div>
 
+   <!-- Stats are auto-counted in conf.py: n_algorithms, n_backends, n_integrations -->
+   <div class="stats-strip">
+      <div class="stat-item">
+         <div class="stat-value" id="stat-algorithms">31</div>
+         <div class="stat-label">Algorithms</div>
+      </div>
+      <div class="stat-item">
+         <div class="stat-value" id="stat-backends">3</div>
+         <div class="stat-label">Backends</div>
+      </div>
+      <div class="stat-item">
+         <div class="stat-value" id="stat-integrations">5</div>
+         <div class="stat-label">Integrations</div>
+      </div>
+      <div class="stat-item">
+         <div class="stat-value">1</div>
+         <div class="stat-label">Unified API</div>
+      </div>
+   </div>
+
 
 Hyperactive provides a collection of optimization algorithms, accessible through a unified
 experiment-based interface that separates optimization problems from algorithms. The library