@homebridge-plugins/homebridge-sharkiq 1.5.3-beta.3 → 1.5.3-beta.5

package/CHANGELOG.md

@@ -10,6 +10,8 @@ All notable changes to this project will be documented in this file. This projec
 - fix(matter): handle the home app's play, pause and dock buttons, so the vacuum responds instead of rejecting the command (#68)
 - fix: start a whole-house clean with just the start command, so the vacuum actually leaves the dock instead of being told to clean no areas (#68)
 - chore: log the start command and whether shark accepts it in debug mode, to diagnose a vacuum that will not leave the dock from homekit (#68)
+- style(ui): standardise the custom ui layout and sync the support tab with the readme
+- fix(ui): fall back to the older copy command when the clipboard api is unavailable, so the oauth url copy button works over plain http (#84)
 
 ## v1.5.2 (2026-07-22)
 

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

@@ -1,3 +1,24 @@
+<style>
+  .dark-mode {
+    background-color: #242424;
+    color: lightgrey;
+
+    .form-control {
+      background-color: #333333 !important;
+      border: none !important;
+      color: #eeeeee !important;
+    }
+
+    thead, tbody, tr {
+      border-style: hidden;
+    }
+
+    th {
+      color: #eeeeee !important;
+      font-weight: 500 !important;
+    }
+  }
+</style>
 <p class="text-center">
   <img src="https://raw.githubusercontent.com/homebridge/plugins/latest/icons/homebridge-sharkiq.png"
     alt="homebridge-sharkiq logo" style="width: 15%" />
@@ -14,8 +35,8 @@
   </div>
 </div>
 <div id="menuWrapper" class="btn-group w-100 mb-0" role="group" aria-label="UI Menu" style="display: none">
-  <button type="button" class="btn btn-primary" id="menuDevices">Devices</button>
   <button type="button" class="btn btn-primary" id="menuSettings">Settings</button>
+  <button type="button" class="btn btn-primary" id="menuDevices">My Devices</button>
   <button type="button" class="btn btn-primary mr-0" id="menuHome">Support</button>
 </div>
 <div id="pageDevices" class="mt-4" style="display: none">
@@ -87,43 +108,54 @@
 </div>
 <div id="pageSupport" class="mt-4" style="display: none">
   <p class="text-center lead">Thank you for using <strong>homebridge-sharkiq</strong></p>
-  <p class="text-center">The links below will take you to our GitHub wiki</p>
-  <h5>Setup</h5>
+  <h5>Plugin Information</h5>
+<ul>
+  <li>This plugin allows you to view and control your Shark IQ robot vacuums within HomeKit. The plugin:</li>
   <ul>
-    <li>
-      <a href="https://github.com/homebridge-plugins/homebridge-sharkiq/wiki" target="_blank">Wiki Home</a>
-    </li>
-    <li>
-      <a href="https://github.com/homebridge-plugins/homebridge-sharkiq/wiki/Configuration" target="_blank">Configuration</a>
-    </li>
-    <li>
-      <a href="https://github.com/homebridge-plugins/homebridge-sharkiq/wiki/Beta-Version" target="_blank">Beta Version</a>
-    </li>
-    <li>
-      <a href="https://github.com/homebridge-plugins/homebridge-sharkiq/wiki/Node-Version" target="_blank">Node Version</a>
-    </li>
-    <li>
-      <a href="https://github.com/homebridge-plugins/homebridge-sharkiq/wiki/Uninstallation"
-        target="_blank">Uninstallation</a>
-    </li>
+    <li>connects to SharkNinja's cloud (which runs on the Ayla Networks platform) to discover and control your robots</li>
+    <li>supports both the US and EU regions</li>
+    <li>can optionally expose robots over Matter as well as HomeKit</li>
   </ul>
-  <h5>Features</h5>
+</ul>
+  <h5>Prerequisites</h5>
+<ul>
+  <li>To use this plugin, you will need to already have:</li>
   <ul>
-    <li>
-      <a href="https://github.com/homebridge-plugins/homebridge-sharkiq/wiki/Supported-Devices" target="_blank">Supported
-        Devices</a>
-    </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</code> - refer to link for more information and installation instructions.</li>
+    <li>A Shark IQ robot vacuum set up in the SharkClean app.</li>
   </ul>
+</ul>
+  <h5>Setup</h5>
+<ul>
+  <li><a href="https://github.com/homebridge-plugins/homebridge-sharkiq/wiki/Installation" target="_blank">Installation</a></li>
+  <li><a href="https://github.com/homebridge-plugins/homebridge-sharkiq/wiki/Configuration" target="_blank">Configuration</a></li>
+  <li><a href="https://github.com/homebridge-plugins/homebridge-sharkiq/wiki/Beta-Version" target="_blank">Beta Version</a></li>
+  <li><a href="https://github.com/homebridge-plugins/homebridge-sharkiq/wiki/Node-Version" target="_blank">Node Version</a></li>
+</ul>
+  <h5>Features</h5>
+<ul>
+  <li>A switch to start and stop a clean</li>
+  <li>A fan control reflecting the robot's running state</li>
+  <li>A contact sensor that reports when the robot is docked</li>
+</ul>
   <h5>Help/About</h5>
-  <ul>
-    <li>
-      <a href="https://github.com/homebridge-plugins/homebridge-sharkiq/issues/new/choose" target="_blank">Support Request</a>
-    </li>
-    <li>
-      <a href="https://github.com/homebridge-plugins/homebridge-sharkiq/blob/latest/CHANGELOG.md"
-        target="_blank">Changelog</a>
-    </li>
-  </ul>
+<ul>
+  <li><a href="https://github.com/homebridge-plugins/homebridge-sharkiq/wiki/Common-Errors" target="_blank">Common Errors</a></li>
+  <li><a href="https://github.com/homebridge-plugins/homebridge-sharkiq/issues/new/choose" target="_blank">Support Request</a></li>
+  <li><a href="https://github.com/homebridge-plugins/homebridge-sharkiq/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 Bubba8291: the original creator of this plugin.</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 SharkNinja 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 () => {
@@ -171,10 +203,21 @@
 
         copyOauthUrlBtn.addEventListener('click', async () => {
           try {
-            await navigator.clipboard.writeText(oauthUrlLink.value);
+            if (navigator.clipboard && window.isSecureContext) {
+              await navigator.clipboard.writeText(oauthUrlLink.value);
+            } else {
+              // The clipboard API only exists on secure (https) pages, and many
+              // local Homebridge UIs run over plain http, so fall back to
+              // selecting the text and using the older copy command.
+              oauthUrlLink.select();
+              oauthUrlLink.setSelectionRange(0, oauthUrlLink.value.length);
+              if (!document.execCommand('copy')) {
+                throw new Error('copy command rejected');
+              }
+            }
             homebridge.toast.success('OAuth URL copied to clipboard.', 'Copied');
           } catch {
-            homebridge.toast.error('Unable to copy OAuth URL.', 'Error');
+            homebridge.toast.error('Unable to copy automatically - please select the URL and copy it manually.', 'Error');
           }
         });
 

package/package.json

@@ -2,7 +2,7 @@
   "name": "@homebridge-plugins/homebridge-sharkiq",
   "displayName": "SharkIQ Plugin",
   "type": "module",
-  "version": "1.5.3-beta.3",
+  "version": "1.5.3-beta.5",
   "description": "A Homebridge plugin to connect your Shark Vacuum to homebridge.",
   "author": {
     "name": "Bubba8291",