ApolloAutomation · bharvey88 · Jun 11, 2026 · Jun 11, 2026
diff --git a/docs/_snippets/bluetooth-proxy/method1-air-1.md b/docs/_snippets/bluetooth-proxy/method1-air-1.md
@@ -0,0 +1,7 @@
+--8<-- "_snippets/bluetooth-proxy/method1-steps.md"
+
+5\. Copy the code inside the codeblock below.
+
+--8<-- "_snippets/bluetooth-proxy/air-1.md"
+
+--8<-- "_snippets/bluetooth-proxy/method1-finish.md"
diff --git a/docs/_snippets/bluetooth-proxy/method1-msr-1.md b/docs/_snippets/bluetooth-proxy/method1-msr-1.md
@@ -0,0 +1,7 @@
+--8<-- "_snippets/bluetooth-proxy/method1-steps.md"
+
+5\. Copy the code inside the codeblock below.
+
+--8<-- "_snippets/bluetooth-proxy/msr-1.md"
+
+--8<-- "_snippets/bluetooth-proxy/method1-finish.md"
diff --git a/docs/_snippets/bluetooth-proxy/method1-msr-2.md b/docs/_snippets/bluetooth-proxy/method1-msr-2.md
@@ -0,0 +1,7 @@
+--8<-- "_snippets/bluetooth-proxy/method1-steps.md"
+
+5\. Copy the code inside the codeblock below.
+
+--8<-- "_snippets/bluetooth-proxy/msr-2.md"
+
+--8<-- "_snippets/bluetooth-proxy/method1-finish.md"
diff --git a/docs/_snippets/bluetooth-proxy/method1-mtr-1.md b/docs/_snippets/bluetooth-proxy/method1-mtr-1.md
@@ -0,0 +1,7 @@
+--8<-- "_snippets/bluetooth-proxy/method1-steps.md"
+
+5\. Copy the code inside the codeblock below.
+
+--8<-- "_snippets/bluetooth-proxy/mtr-1.md"
+
+--8<-- "_snippets/bluetooth-proxy/method1-finish.md"
diff --git a/docs/_snippets/bluetooth-proxy/method1-plt-1.md b/docs/_snippets/bluetooth-proxy/method1-plt-1.md
@@ -0,0 +1,7 @@
+--8<-- "_snippets/bluetooth-proxy/method1-steps.md"
+
+5\. Copy the code inside the codeblock below.
+
+--8<-- "_snippets/bluetooth-proxy/plt-1.md"
+
+--8<-- "_snippets/bluetooth-proxy/method1-finish.md"
diff --git a/docs/_snippets/bluetooth-proxy/method1-plt-1b.md b/docs/_snippets/bluetooth-proxy/method1-plt-1b.md
@@ -0,0 +1,7 @@
+--8<-- "_snippets/bluetooth-proxy/method1-steps.md"
+
+5\. Copy the code inside the codeblock below.
+
+--8<-- "_snippets/bluetooth-proxy/plt-1b.md"
+
+--8<-- "_snippets/bluetooth-proxy/method1-finish.md"
diff --git a/docs/_snippets/bluetooth-proxy/method1-temp-1.md b/docs/_snippets/bluetooth-proxy/method1-temp-1.md
@@ -0,0 +1,7 @@
+--8<-- "_snippets/bluetooth-proxy/method1-steps.md"
+
+5\. Copy the code inside the codeblock below.
+
+--8<-- "_snippets/bluetooth-proxy/temp-1.md"
+
+--8<-- "_snippets/bluetooth-proxy/method1-finish.md"
diff --git a/docs/_snippets/bluetooth-proxy/method1-temp-1b.md b/docs/_snippets/bluetooth-proxy/method1-temp-1b.md
@@ -0,0 +1,7 @@
+--8<-- "_snippets/bluetooth-proxy/method1-steps.md"
+
+5\. Copy the code inside the codeblock below.
+
+--8<-- "_snippets/bluetooth-proxy/temp-1b.md"
+
+--8<-- "_snippets/bluetooth-proxy/method1-finish.md"
diff --git a/docs/_snippets/bluetooth-proxy/no-ble-fork-page.md b/docs/_snippets/bluetooth-proxy/no-ble-fork-page.md
@@ -0,0 +1,3 @@
+!!! info "This product does not have a prebuilt \_BLE.yaml firmware"
+
+    This product is set up as a Bluetooth Proxy by adding the BLE proxy yaml to your existing config by hand. Follow the steps below.
diff --git a/docs/_snippets/bluetooth-proxy/no-ble-fork-tab.md b/docs/_snippets/bluetooth-proxy/no-ble-fork-tab.md
@@ -0,0 +1,3 @@
+!!! info "This product needs Method 2"
+
+    This product does not have a prebuilt \_BLE.yaml firmware, so Method 1 does not apply. Scroll down and follow **Method 2** to add the BLE proxy yaml to your existing config by hand.
diff --git a/docs/products/air1/additional-info/bluetooth-proxy.md b/docs/products/air1/additional-info/bluetooth-proxy.md
@@ -1,23 +1,17 @@
----
+---
 title: AIR-1 Bluetooth Proxy
 description: Tutorial for how to turn your AIR-1 into a BLE proxy!
 ---
 # AIR-1 Bluetooth Proxy
 
 --8<-- "_snippets/bluetooth-proxy/intro.md"
 
-### Method 1: Switch to AIR-1\_BLE.yaml fork
-
---8<-- "_snippets/bluetooth-proxy/method1-steps.md"
-
-5\. Copy the code inside the codeblock below and paste it directly below the two lines you just commented out.
+Select a method below. Method 1 switches your AIR-1 to the prebuilt AIR-1_BLE.yaml firmware. Method 2 adds the BLE proxy yaml to your existing config by hand.
 
---8<-- "_snippets/bluetooth-proxy/air-1.md"
+=== "Method 1: AIR-1_BLE.yaml firmware"
 
---8<-- "_snippets/bluetooth-proxy/method1-finish.md"
-
----
+    --8<-- "_snippets/bluetooth-proxy/method1-air-1.md"
 
-### Method 2: Manually enter the BLE proxy yaml
+=== "Method 2: Manually enter the BLE proxy yaml"
 
---8<-- "_snippets/bluetooth-proxy/method2.md"
+    --8<-- "_snippets/bluetooth-proxy/method2.md"
diff --git a/docs/products/btn1/additional-info/bluetooth-proxy.md b/docs/products/btn1/additional-info/bluetooth-proxy.md
@@ -0,0 +1,15 @@
+---
+title: BTN-1 Bluetooth Proxy
+description: Tutorial for how to turn your BTN-1 into a BLE proxy!
+---
+# BTN-1 Bluetooth Proxy
+
+--8<-- "_snippets/bluetooth-proxy/intro.md"
+
+!!! info "This product does not have a prebuilt \_BLE.yaml firmware"
+
+    This product is set up as a Bluetooth Proxy by adding the BLE proxy yaml to your existing config by hand. Follow the steps below.
+
+    Sleep must be disabled for the BTN-1 to work as a Bluetooth Proxy. See the [Prevent Sleep guide](https://wiki.apolloautomation.com/products/btn1/additional-info/prevent-sleep/).
+
+--8<-- "_snippets/bluetooth-proxy/method2.md"
diff --git a/docs/products/general/setup/bluetooth-proxy.md b/docs/products/general/setup/bluetooth-proxy.md
@@ -1,57 +1,67 @@
----
+---
 title: Bluetooth Proxy Setup
 description: Tutorial for how to turn your Apollo device into a BLE proxy!
 ---
 # Bluetooth Proxy
 
 --8<-- "_snippets/bluetooth-proxy/intro.md"
 
-### Method 1: Switch to \_BLE.yaml fork
-
---8<-- "_snippets/bluetooth-proxy/method1-steps.md"
+### Method 1: Switch to \_BLE.yaml firmware
 
-5\. Select your product below, copy the code, and paste it directly below the two lines you just commented out.
+Select your product below to see the full walkthrough.
 
 === "AIR-1"
 
-    --8<-- "_snippets/bluetooth-proxy/air-1.md"
+    --8<-- "_snippets/bluetooth-proxy/method1-air-1.md"
 
 === "MSR-1"
 
-    --8<-- "_snippets/bluetooth-proxy/msr-1.md"
+    --8<-- "_snippets/bluetooth-proxy/method1-msr-1.md"
 
 === "MSR-2"
 
-    --8<-- "_snippets/bluetooth-proxy/msr-2.md"
+    --8<-- "_snippets/bluetooth-proxy/method1-msr-2.md"
 
 === "MTR-1"
 
-    --8<-- "_snippets/bluetooth-proxy/mtr-1.md"
+    --8<-- "_snippets/bluetooth-proxy/method1-mtr-1.md"
+
+=== "R-PRO-1"
+
+    --8<-- "_snippets/bluetooth-proxy/no-ble-fork-tab.md"
 
-=== "PLT-1 / PLT-1B"
+=== "PUMP-1"
 
-    **PLT-1:**
+    --8<-- "_snippets/bluetooth-proxy/no-ble-fork-tab.md"
 
-    --8<-- "_snippets/bluetooth-proxy/plt-1.md"
+=== "PLT-1"
 
-    **PLT-1B:**
+    --8<-- "_snippets/bluetooth-proxy/method1-plt-1.md"
 
-    --8<-- "_snippets/bluetooth-proxy/plt-1b.md"
+=== "PLT-1B"
 
-=== "TEMP-1 / TEMP-1B"
+    --8<-- "_snippets/bluetooth-proxy/method1-plt-1b.md"
 
-    **TEMP-1:**
+=== "TEMP-1"
 
-    --8<-- "_snippets/bluetooth-proxy/temp-1.md"
+    --8<-- "_snippets/bluetooth-proxy/method1-temp-1.md"
 
-    **TEMP-1B:**
+=== "TEMP-1B"
 
-    --8<-- "_snippets/bluetooth-proxy/temp-1b.md"
+    --8<-- "_snippets/bluetooth-proxy/method1-temp-1b.md"
 
---8<-- "_snippets/bluetooth-proxy/method1-finish.md"
+=== "BTN-1"
+
+    !!! info "This product needs Method 2"
+
+        This product does not have a prebuilt \_BLE.yaml firmware, so Method 1 does not apply. Scroll down and follow **Method 2** to add the BLE proxy yaml to your existing config by hand.
+
+        Sleep must be disabled for the BTN-1 to work as a Bluetooth Proxy. See the [Prevent Sleep guide](https://wiki.apolloautomation.com/products/btn1/additional-info/prevent-sleep/).
 
 ---
 
 ### Method 2: Manually enter the BLE proxy yaml
 
+This method works the same on every product.
+
 --8<-- "_snippets/bluetooth-proxy/method2.md"
diff --git a/docs/products/msr1/additional-info/bluetooth-proxy.md b/docs/products/msr1/additional-info/bluetooth-proxy.md
@@ -1,23 +1,17 @@
----
+---
 title: MSR-1 Bluetooth Proxy
 description: Tutorial for how to turn your MSR-1 into a BLE proxy!
 ---
 # MSR-1 Bluetooth Proxy
 
 --8<-- "_snippets/bluetooth-proxy/intro.md"
 
-### Method 1: Switch to MSR-1\_BLE.yaml fork
-
---8<-- "_snippets/bluetooth-proxy/method1-steps.md"
-
-5\. Copy the code inside the codeblock below and paste it directly below the two lines you just commented out.
+Select a method below. Method 1 switches your MSR-1 to the prebuilt MSR-1_BLE.yaml firmware. Method 2 adds the BLE proxy yaml to your existing config by hand.
 
---8<-- "_snippets/bluetooth-proxy/msr-1.md"
+=== "Method 1: MSR-1_BLE.yaml firmware"
 
---8<-- "_snippets/bluetooth-proxy/method1-finish.md"
-
----
+    --8<-- "_snippets/bluetooth-proxy/method1-msr-1.md"
 
-### Method 2: Manually enter the BLE proxy yaml
+=== "Method 2: Manually enter the BLE proxy yaml"
 
---8<-- "_snippets/bluetooth-proxy/method2.md"
+    --8<-- "_snippets/bluetooth-proxy/method2.md"
diff --git a/docs/products/msr2/additional-info/bluetooth-proxy.md b/docs/products/msr2/additional-info/bluetooth-proxy.md
@@ -1,23 +1,17 @@
----
+---
 title: MSR-2 Bluetooth Proxy
 description: Tutorial for how to turn your MSR-2 into a BLE proxy!
 ---
 # MSR-2 Bluetooth Proxy
 
 --8<-- "_snippets/bluetooth-proxy/intro.md"
 
-### Method 1: Switch to MSR-2\_BLE.yaml fork
-
---8<-- "_snippets/bluetooth-proxy/method1-steps.md"
-
-5\. Copy the code inside the codeblock below and paste it directly below the two lines you just commented out.
+Select a method below. Method 1 switches your MSR-2 to the prebuilt MSR-2_BLE.yaml firmware. Method 2 adds the BLE proxy yaml to your existing config by hand.
 
---8<-- "_snippets/bluetooth-proxy/msr-2.md"
+=== "Method 1: MSR-2_BLE.yaml firmware"
 
---8<-- "_snippets/bluetooth-proxy/method1-finish.md"
-
----
+    --8<-- "_snippets/bluetooth-proxy/method1-msr-2.md"
 
-### Method 2: Manually enter the BLE proxy yaml
+=== "Method 2: Manually enter the BLE proxy yaml"
 
---8<-- "_snippets/bluetooth-proxy/method2.md"
+    --8<-- "_snippets/bluetooth-proxy/method2.md"
diff --git a/docs/products/mtr1/additional-info/bluetooth-proxy.md b/docs/products/mtr1/additional-info/bluetooth-proxy.md
@@ -1,23 +1,17 @@
----
+---
 title: MTR-1 Bluetooth Proxy
 description: Tutorial for how to turn your MTR-1 into a BLE proxy!
 ---
 # MTR-1 Bluetooth Proxy
 
 --8<-- "_snippets/bluetooth-proxy/intro.md"
 
-### Method 1: Switch to MTR-1\_BLE.yaml fork
-
---8<-- "_snippets/bluetooth-proxy/method1-steps.md"
-
-5\. Copy the code inside the codeblock below and paste it directly below the two lines you just commented out.
+Select a method below. Method 1 switches your MTR-1 to the prebuilt MTR-1_BLE.yaml firmware. Method 2 adds the BLE proxy yaml to your existing config by hand.
 
---8<-- "_snippets/bluetooth-proxy/mtr-1.md"
+=== "Method 1: MTR-1_BLE.yaml firmware"
 
---8<-- "_snippets/bluetooth-proxy/method1-finish.md"
-
----
+    --8<-- "_snippets/bluetooth-proxy/method1-mtr-1.md"
 
-### Method 2: Manually enter the BLE proxy yaml
+=== "Method 2: Manually enter the BLE proxy yaml"
 
---8<-- "_snippets/bluetooth-proxy/method2.md"
+    --8<-- "_snippets/bluetooth-proxy/method2.md"
diff --git a/docs/products/plt1/additional-info/bluetooth-proxy.md b/docs/products/plt1/additional-info/bluetooth-proxy.md
@@ -1,23 +1,17 @@
----
+---
 title: PLT-1 Bluetooth Proxy
 description: Tutorial for how to turn your PLT-1 into a BLE proxy!
 ---
 # PLT-1 Bluetooth Proxy
 
 --8<-- "_snippets/bluetooth-proxy/intro.md"
 
-### Method 1: Switch to PLT-1\_BLE.yaml fork
-
---8<-- "_snippets/bluetooth-proxy/method1-steps.md"
-
-5\. Copy the code inside the codeblock below and paste it directly below the two lines you just commented out.
+Select a method below. Method 1 switches your PLT-1 to the prebuilt PLT-1_BLE.yaml firmware. Method 2 adds the BLE proxy yaml to your existing config by hand.
 
---8<-- "_snippets/bluetooth-proxy/plt-1.md"
+=== "Method 1: PLT-1_BLE.yaml firmware"
 
---8<-- "_snippets/bluetooth-proxy/method1-finish.md"
-
----
+    --8<-- "_snippets/bluetooth-proxy/method1-plt-1.md"
 
-### Method 2: Manually enter the BLE proxy yaml
+=== "Method 2: Manually enter the BLE proxy yaml"
 
---8<-- "_snippets/bluetooth-proxy/method2.md"
+    --8<-- "_snippets/bluetooth-proxy/method2.md"
diff --git a/docs/products/plt1b/additional-info/bluetooth-proxy.md b/docs/products/plt1b/additional-info/bluetooth-proxy.md
@@ -1,23 +1,17 @@
----
+---
 title: PLT-1B Bluetooth Proxy
 description: Tutorial for how to turn your PLT-1B into a BLE proxy!
 ---
 # PLT-1B Bluetooth Proxy
 
 --8<-- "_snippets/bluetooth-proxy/intro.md"
 
-### Method 1: Switch to PLT-1B\_BLE.yaml fork
-
---8<-- "_snippets/bluetooth-proxy/method1-steps.md"
-
-5\. Copy the code inside the codeblock below and paste it directly below the two lines you just commented out.
+Select a method below. Method 1 switches your PLT-1B to the prebuilt PLT-1B_BLE.yaml firmware. Method 2 adds the BLE proxy yaml to your existing config by hand.
 
---8<-- "_snippets/bluetooth-proxy/plt-1b.md"
+=== "Method 1: PLT-1B_BLE.yaml firmware"
 
---8<-- "_snippets/bluetooth-proxy/method1-finish.md"
-
----
+    --8<-- "_snippets/bluetooth-proxy/method1-plt-1b.md"
 
-### Method 2: Manually enter the BLE proxy yaml
+=== "Method 2: Manually enter the BLE proxy yaml"
 
---8<-- "_snippets/bluetooth-proxy/method2.md"
+    --8<-- "_snippets/bluetooth-proxy/method2.md"
diff --git a/docs/products/pump1/additional-info/bluetooth-proxy.md b/docs/products/pump1/additional-info/bluetooth-proxy.md
@@ -0,0 +1,11 @@
+---
+title: PUMP-1 Bluetooth Proxy
+description: Tutorial for how to turn your PUMP-1 into a BLE proxy!
+---
+# PUMP-1 Bluetooth Proxy
+
+--8<-- "_snippets/bluetooth-proxy/intro.md"
+
+--8<-- "_snippets/bluetooth-proxy/no-ble-fork-page.md"
+
+--8<-- "_snippets/bluetooth-proxy/method2.md"
diff --git a/docs/products/rpro1/additional-info/bluetooth-proxy.md b/docs/products/rpro1/additional-info/bluetooth-proxy.md
@@ -0,0 +1,11 @@
+---
+title: R-PRO-1 Bluetooth Proxy
+description: Tutorial for how to turn your R-PRO-1 into a BLE proxy!
+---
+# R-PRO-1 Bluetooth Proxy
+
+--8<-- "_snippets/bluetooth-proxy/intro.md"
+
+--8<-- "_snippets/bluetooth-proxy/no-ble-fork-page.md"
+
+--8<-- "_snippets/bluetooth-proxy/method2.md"
Original file line number	Diff line number	Diff line change
		@@ -0,0 +1,3 @@
		!!! info "This product does not have a prebuilt \_BLE.yaml firmware"

		This product is set up as a Bluetooth Proxy by adding the BLE proxy yaml to your existing config by hand. Follow the steps below.
Original file line number	Diff line number	Diff line change
		@@ -0,0 +1,3 @@
		!!! info "This product needs Method 2"

		This product does not have a prebuilt \_BLE.yaml firmware, so Method 1 does not apply. Scroll down and follow Method 2 to add the BLE proxy yaml to your existing config by hand.