@homebridge-plugins/homebridge-ecovacs 8.2.0-beta.0 → 8.2.0-beta.2

package/CHANGELOG.md

@@ -7,6 +7,8 @@ All notable changes to `@homebridge-plugins/homebridge-ecovacs` will be document
 ### Changed
 
 - feat(ui): add, remove and hide devices from the config via the my devices tab
+- style(ui): standardise the custom ui layout and sync the support tab with the readme
+- feat(ui): add a remove all devices action to the my devices tab
 
 ## v8.1.4 (2026-07-19)
 

package/dist/homebridge-ui/public/index.html

@@ -108,6 +108,17 @@
           </button>
         </div>
       </li>
+      <li class="list-group-item">
+        <div class="d-flex justify-content-between align-items-center">
+          <div class="pr-2">
+            <div>Remove All Devices</div>
+            <div class="text-muted action-desc" id="removeAllText">Remove every device from the plugin config.</div>
+          </div>
+          <button type="button" class="btn btn-primary m-0 ml-3 py-1 min-w-50" id="removeAllBtn" aria-label="Remove all devices from the config">
+            <i aria-hidden="true" class="fas fa-arrow-right"></i>
+          </button>
+        </div>
+      </li>
       <li class="list-group-item">
         <div class="d-flex justify-content-between align-items-center">
           <div class="pr-2">
@@ -179,133 +190,55 @@
   </div>
 </div>
 <div id="pageSupport" class="mt-4" style="display: none">
-  <p class="text-center lead">
-    Thank you for using <strong>homebridge-ecovacs</strong>
-  </p>
-  <p class="text-center">The links below will take you to our GitHub wiki</p>
-  <h4>Setup</h4>
-  <ul>
-    <li>
-      <a
-        href="https://github.com/homebridge-plugins/homebridge-ecovacs/wiki/Installation"
-        target="_blank"
-        >Installation</a
-      >
-    </li>
-    <li>
-      <a
-        href="https://github.com/homebridge-plugins/homebridge-ecovacs/wiki/Configuration"
-        target="_blank"
-        >Configuration</a
-      >
-    </li>
-    <li>
-      <a
-        href="https://github.com/homebridge-plugins/homebridge-ecovacs/wiki/Beta-Version"
-        target="_blank"
-        >Beta Version</a
-      >
-    </li>
-    <li>
-      <a
-        href="https://github.com/homebridge-plugins/homebridge-ecovacs/wiki/Node-Version"
-        target="_blank"
-        >Node Version</a
-      >
-    </li>
-  </ul>
-  <h4>Features</h4>
-  <ul>
-    <li>
-      <a
-        href="https://github.com/homebridge-plugins/homebridge-ecovacs/wiki/Supported-Devices"
-        target="_blank"
-        >Supported Devices</a
-      >
-    </li>
-    <li>
-      <a
-        href="https://github.com/homebridge-plugins/homebridge-ecovacs/wiki/Speed-Control"
-        target="_blank"
-        >Speed Control</a
-      >
-    </li>
-    <li>
-      <a
-        href="https://github.com/homebridge-plugins/homebridge-ecovacs/wiki/Custom-Areas"
-        target="_blank"
-        >Custom Areas</a
-      >
-    </li>
-  </ul>
-  <h4>Help/About</h4>
-  <ul>
-    <li>
-      <a
-        href="https://github.com/homebridge-plugins/homebridge-ecovacs/wiki/Common-Errors"
-        target="_blank"
-        >Common Errors</a
-      >
-    </li>
-    <li>
-      <a
-        href="https://github.com/homebridge-plugins/homebridge-ecovacs/issues/new/choose"
-        target="_blank"
-        >Support Request</a
-      >
-    </li>
-    <li>
-      <a
-        href="https://github.com/homebridge-plugins/homebridge-ecovacs/blob/latest/CHANGELOG.md"
-        target="_blank"
-        >Changelog</a
-      >
-    </li>
-    <li>
-      <a href="https://github.com/sponsors/bwp91" target="_blank">About Me</a>
-    </li>
-  </ul>
-  <h4>Credits</h4>
+  <p class="text-center lead">Thank you for using <strong>homebridge-ecovacs</strong></p>
+  <h5>Plugin Information</h5>
+<ul>
+  <li>This plugin allows you to view and control your Ecovacs or Yeedi devices within HomeKit. The plugin:</li>
   <ul>
-    <li>
-      To the owner of
-      <a href="https://github.com/mrbungle64/ecovacs-deebot.js" target="_blank"
-        >ecovacs-deebot.js</a
-      >
-      client:
-      <a href="https://github.com/mrbungle64" target="_blank">@mrbungle64</a>.
-    </li>
-    <li>
-      To the owner of
-      <a
-        href="https://github.com/nicoduj/homebridge-deebotEcovacs"
-        target="_blank"
-        >homebridge-deebotEcovacs</a
-      >: <a href="https://github.com/nicoduj" target="_blank">@nicoduj</a>.
-    </li>
-    <li>
-      To the creator of the awesome plugin header logo:
-      <a href="https://www.instagram.com/keryan.me" target="_blank"
-        >Keryan Belahcene</a
-      >.
-    </li>
-    <li>
-      To the creators/contributors of
-      <a href="https://homebridge.io" target="_blank">Homebridge</a> who make
-      this plugin possible.
-    </li>
+    <li>requires your Ecovacs or Yeedi credentials to function</li>
+    <li>uses a cloud-based connection (i.e. requires the internet)</li>
   </ul>
-  <h4>Disclaimer</h4>
+</ul>
+  <h5>Prerequisites</h5>
+<ul>
+  <li>To use this plugin, you will need to already have:</li>
   <ul>
-    <li>
-      I am in no way affiliated with Ecovacs and this plugin is a personal
-      project that I maintain in my free time.
-    </li>
-    <li>
-      Use this plugin entirely at your own risk - please see licence for more
-      information.
-    </li>
+    <li><a href="https://nodejs.org" target="_blank">Node</a>: latest version of <code>v22</code> or <code>v24</code> - any other major version is not supported.</li>
+    <li><a href="https://homebridge.io" target="_blank">Homebridge</a>: <code>v2.0</code> or above - refer to link for more information and installation instructions.</li>
   </ul>
+</ul>
+  <h5>Setup</h5>
+<ul>
+  <li><a href="https://github.com/homebridge-plugins/homebridge-ecovacs/wiki/Installation" target="_blank">Installation</a></li>
+  <li><a href="https://github.com/homebridge-plugins/homebridge-ecovacs/wiki/Configuration" target="_blank">Configuration</a></li>
+  <li><a href="https://github.com/homebridge-plugins/homebridge-ecovacs/wiki/Beta-Version" target="_blank">Beta Version</a></li>
+  <li><a href="https://github.com/homebridge-plugins/homebridge-ecovacs/wiki/Node-Version" target="_blank">Node Version</a></li>
+</ul>
+  <h5>Features</h5>
+<ul>
+  <li><a href="https://github.com/homebridge-plugins/homebridge-ecovacs/wiki/Supported-Devices" target="_blank">Supported Devices</a></li>
+  <li><a href="https://github.com/homebridge-plugins/homebridge-ecovacs/wiki/Speed-Control" target="_blank">Speed Control</a></li>
+  <li><a href="https://github.com/homebridge-plugins/homebridge-ecovacs/wiki/Predefined-Areas" target="_blank">Predefined Areas</a></li>
+</ul>
+  <h5>Help/About</h5>
+<ul>
+  <li><a href="https://github.com/homebridge-plugins/homebridge-ecovacs/wiki/Common-Errors" target="_blank">Common Errors</a></li>
+  <li><a href="https://github.com/homebridge-plugins/homebridge-ecovacs/issues/new/choose" target="_blank">Support Request</a></li>
+  <li><a href="https://github.com/homebridge-plugins/homebridge-ecovacs/blob/latest/CHANGELOG.md" target="_blank">Changelog</a></li>
+  <li><a href="https://github.com/sponsors/bwp91" target="_blank">About Me</a></li>
+</ul>
+  <h5>Credits</h5>
+<ul>
+  <li>To the owner of <a href="https://github.com/mrbungle64/ecovacs-deebot.js" target="_blank">ecovacs-deebot.js</a> client: <a href="https://github.com/mrbungle64" target="_blank">@mrbungle64</a>.</li>
+  <li>To the owner of <a href="https://github.com/nicoduj/homebridge-deebotEcovacs" target="_blank">homebridge-deebotEcovacs</a>: <a href="https://github.com/nicoduj" target="_blank">@nicoduj</a>.</li>
+  <li>To the creator of the awesome plugin header logo: <a href="https://www.instagram.com/keryan.me" target="_blank">Keryan Belahcene</a>.</li>
+  <li>To the creators/contributors of <a href="https://homebridge.io" target="_blank">Homebridge</a> who make this plugin possible.</li>
+</ul>
+  <h5>Disclaimer</h5>
+<ul>
+  <li>I am in no way affiliated with Ecovacs/Deebot/Yeedi and this plugin is a personal project that I maintain in my free time.</li>
+  <li>Use this plugin entirely at your own risk - please see licence for more information.</li>
+</ul>
 </div>
 <script>
   (async () => {
@@ -317,6 +250,7 @@
       // so staged-but-unsaved edits made in the Settings tab are respected
       let pickerAccessories = [];
       let removeConfirmTimer;
+      let removeAllConfirmTimer;
 
       // The action buttons always show the settings-page arrow; the row text
       // (and the button's aria-label) says what the arrow will do
@@ -542,6 +476,51 @@
           homebridge.toast.error(err.message, "Error");
         }
       });
+      const resetRemoveAllButton = () => {
+        const btn = document.getElementById('removeAllBtn');
+        clearTimeout(removeAllConfirmTimer);
+        delete btn.dataset.confirm;
+        btn.classList.remove('btn-danger');
+        btn.classList.add('btn-primary');
+        btn.innerHTML = actionArrow;
+        btn.setAttribute('aria-label', 'Remove all devices from the config');
+        document.getElementById('removeAllText').innerHTML = 'Remove every device from the plugin config.';
+      };
+
+      document.getElementById('removeAllBtn').addEventListener('click', async () => {
+        try {
+          const btn = document.getElementById('removeAllBtn');
+          const blocks = await getConfigBlocks();
+          const config = blocks[0];
+          const total = Array.isArray(config.devices) ? config.devices.length : 0;
+          if (total === 0) {
+            resetRemoveAllButton();
+            homebridge.toast.info('There are no devices in the config.', 'Nothing To Remove');
+            return;
+          }
+          if (btn.dataset.confirm !== 'yes') {
+            // Removing everything always asks for a second click, since any
+            // settings on the entries would be lost
+            btn.dataset.confirm = 'yes';
+            btn.classList.remove('btn-primary');
+            btn.classList.add('btn-danger');
+            btn.innerHTML = actionArrow;
+            btn.setAttribute('aria-label', 'Confirm removing all devices from the config');
+            document.getElementById('removeAllText').innerHTML = 'Any settings on these entries will be lost. Click again to remove all ' + total + (total === 1 ? ' entry.' : ' entries.');
+            removeAllConfirmTimer = setTimeout(resetRemoveAllButton, 5000);
+            return;
+          }
+          delete config.devices;
+          await homebridge.updatePluginConfig(blocks);
+          resetRemoveAllButton();
+          setConfigButton(false);
+          setHideControl(false);
+          homebridge.toast.success(total + ' device entr' + (total === 1 ? 'y' : 'ies') + ' removed - press Save to apply.', 'Removed From Config');
+        } catch (err) {
+          homebridge.toast.error(err.message, 'Error');
+        }
+      });
+
       // ===== End device picker =====
       showIntro = () => {
         homebridge.disableSaveButton?.();

package/package.json

@@ -3,7 +3,7 @@
   "displayName": "Homebridge Ecovacs",
   "alias": "Deebot",
   "type": "module",
-  "version": "8.2.0-beta.0",
+  "version": "8.2.0-beta.2",
   "description": "Homebridge plugin to integrate Ecovacs Deebot/Yeedi devices into HomeKit.",
   "author": {
     "name": "bwp91",