From bcea9d5c4d681c645f1883ded9b88b4735d62160 Mon Sep 17 00:00:00 2001
From: mikecarper <mikecarper@gmail.com>
Date: Tue, 29 Sep 2026 16:36:57 -0700
Subject: [PATCH] Link nRF52 picker results to the latest OTAFIX bootloader

---
 docs/_javascript/firmware_picker.js | 9 +++++++++
 docs/firmware_picker.md             | 7 +++++++
 mkdocs.yml                          | 2 +-
 3 files changed, 17 insertions(+), 1 deletion(-)

diff --git a/docs/_javascript/firmware_picker.js b/docs/_javascript/firmware_picker.js
index 8774fc011..6ae02fc62 100644
--- a/docs/_javascript/firmware_picker.js
+++ b/docs/_javascript/firmware_picker.js
@@ -1589,6 +1589,11 @@
     const release = createElement("a", "Open release notes");
     release.href = asset.releaseUrl;
     actions.appendChild(release);
+    if (profile.chipFamily === "nrf52") {
+      const bootloader = createElement("a", "Latest nRF52 OTAFIX bootloader");
+      bootloader.href = "https://github.com/mikecarper/Adafruit_nRF52_Bootloader_OTAFIX/releases/latest";
+      actions.appendChild(bootloader);
+    }
     const migrationAction = migrationLink(profile, asset);
     if (migrationAction) {
       const migration = createElement("a", migrationAction.label);
@@ -1596,6 +1601,10 @@
       actions.appendChild(migration);
     }
     card.appendChild(actions);
+    if (profile.chipFamily === "nrf52") {
+      card.appendChild(createElement("p",
+        "Choose the bootloader package for this exact board and storage setup. Application UF2 and DFU files do not install a bootloader. Follow the bootloader release's migration instructions if your installed version needs a recovery bridge."));
+    }
 
     const steps = createElement("div");
     steps.className = "firmware-picker-steps";
diff --git a/docs/firmware_picker.md b/docs/firmware_picker.md
index 543ea2e9b..b7686e399 100644
--- a/docs/firmware_picker.md
+++ b/docs/firmware_picker.md
@@ -385,6 +385,13 @@ LoRa update still needs an exact target identity,
 compatible partition signature, matching radio settings, and the correct
 update package.
 
+nRF52 results include **Latest nRF52 OTAFIX bootloader**, linking to the
+[latest OTAFIX release](https://github.com/mikecarper/Adafruit_nRF52_Bootloader_OTAFIX/releases/latest).
+The link follows the current stable release automatically. Choose the package
+for the exact board and storage setup; application UF2 and DFU files do not
+install a bootloader. Follow the release's migration instructions if the
+installed version needs a recovery bridge.
+
 nRF52 LoRa OTA requires an OTAFIX bootloader built for the exact board and
 storage layout. Select the hardware-matched HEX, Serial DFU ZIP, or
 bootloader-update UF2 for the application image being installed.
diff --git a/mkdocs.yml b/mkdocs.yml
index 379a265b7..97a8f41ca 100644
--- a/mkdocs.yml
+++ b/mkdocs.yml
@@ -26,7 +26,7 @@ extra_css:
 
 extra_javascript:
   - https://unpkg.com/leaflet@1.9.4/dist/leaflet.js
-  - _javascript/firmware_picker.js?v=20260929-1
+  - _javascript/firmware_picker.js?v=20260929-2
   - _javascript/telemetry_decoder.js
   - _javascript/management_decoder.js
   - _javascript/filter_tool.js