docs: use anywidget

Signed-off-by: Henry Schreiner <henryfs@princeton.edu>

Author: henryiii

docs/assets/js/repo-review-widget.mjs

@@ -0,0 +1,93 @@
+/**
+ * AnyWidget wrapper for repo-review app
+ * Provides the render() interface for MyST's anywidget directive
+ */
+
+export async function render({ model, el }) {
+  // Create a root container for the React app
+  const root = document.createElement("div");
+  root.id = "root";
+  root.style.width = "100%";
+  root.style.minHeight = "600px";
+
+  // Add Material Design fonts if not already present
+  ensureFonts();
+
+  // Append root to the target element
+  el.appendChild(root);
+
+  // Determine the correct path to the app
+  // The widget will be in /build/ and the app is in /assets/js/
+  const baseUrl = new URL(import.meta.url);
+  const appUrl = new URL("../../assets/js/repo-review-app.min.js", baseUrl).href;
+
+  // Load the app via dynamic import
+  try {
+    const appModule = await import(appUrl);
+
+    // The app should export a mountApp function
+    if (appModule.mountApp) {
+      appModule.mountApp({
+        header: true,
+        deps: [
+          "repo-review~=1.0.0",
+          "sp-repo-review==2026.04.04",
+          "validate-pyproject[all]~=0.25.0",
+          "validate-pyproject-schema-store==2026.03.29",
+        ],
+      });
+    } else {
+      console.warn(
+        "repo-review-app.min.js does not export mountApp, attempting alternative load"
+      );
+      // Try loading as a script tag instead
+      loadAppAsScript(appUrl);
+    }
+  } catch (error) {
+    console.error("Failed to load repo-review app via import:", error);
+    // Fallback: load as a regular script
+    const appSrc = appUrl.replace(/\.mjs$/, ".js").replace(/\.js$/, ".min.js");
+    loadAppAsScript(appSrc);
+  }
+
+  function loadAppAsScript(src) {
+    const script = document.createElement("script");
+    script.type = "module";
+    script.textContent = `import('./repo-review-app.min.js').then(m => m.mountApp ? m.mountApp({
+      header: true,
+      deps: [
+        "repo-review~=1.0.0",
+        "sp-repo-review==2026.04.04",
+        "validate-pyproject[all]~=0.25.0",
+        "validate-pyproject-schema-store==2026.03.29",
+      ],
+    }) : console.error("mountApp not found")).catch(e => {
+      root.innerHTML = "<p style='color: red; padding: 20px;'>Failed to load repo-review app. Please check the browser console for details.</p>";
+      console.error("Failed to load repo-review app:", e);
+    });`;
+    document.head.appendChild(script);
+  }
+}
+
+/**
+ * Ensure Material Design fonts are loaded
+ */
+function ensureFonts() {
+  // Check if fonts are already loaded
+  if (document.querySelector('link[href*="fonts.googleapis.com"]')) {
+    return;
+  }
+
+  // Add Roboto font for Material Design
+  const robotoLink = document.createElement("link");
+  robotoLink.rel = "stylesheet";
+  robotoLink.href =
+    "https://fonts.googleapis.com/css?family=Roboto:300,400,500,700&display=swap";
+  document.head.appendChild(robotoLink);
+
+  // Add Material Icons
+  const iconsLink = document.createElement("link");
+  iconsLink.rel = "stylesheet";
+  iconsLink.href = "https://fonts.googleapis.com/icon?family=Material+Icons";
+  document.head.appendChild(iconsLink);
+}

docs/myst.yml

@@ -43,12 +43,14 @@ project:
     - file: pages/guides/repo_review.md
 
 site:
+  template: book-theme
   nav:
     - title: Scientific Python
       url: https://scientific-python.org
     - title: Learn
       url: https://learn.scientific-python.org
-    - title: Cookie
+  actions:
+    - title: src
       url: https://github.com/scientific-python/cookie
   options:
     favicon: assets/favicon.ico

docs/pages/guides/repo_review.md

@@ -21,6 +21,5 @@ pipx run 'sp-repo-review[cli]' <path to repo>
 
 ---
 
-:::{iframe} <https://scientific-python.github.io/repo-review/>
-:width: 100%
+:::{anywidget} /assets/js/repo-review-widget.mjs
 :::

helpers/copy-assets.sh

@@ -0,0 +1,13 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+# Copy assets to both build outputs
+for build_dir in docs/_build/html docs/_build/site/public; do
+  if [ -d "$build_dir" ]; then
+    mkdir -p "$build_dir/assets/js"
+    cp -v docs/assets/js/repo-review-app.min.js "$build_dir/assets/js/"
+    cp -v docs/assets/js/repo-review-app.min.js.map "$build_dir/assets/js/"
+  fi
+done
+
+echo "✓ Assets copied successfully"

package.json

@@ -3,7 +3,7 @@
   "private": true,
   "type": "module",
   "scripts": {
-    "build": "cd docs && myst build --html",
+    "build": "cd docs && myst build --html && cd .. && bash helpers/copy-assets.sh",
     "serve": "cd docs && myst start",
     "clean": "rm -rf docs/_build"
   },