docs(roomote-control): add Notifications section with per-platform setup and toggle screenshot; clarify requirements and limits

Author: hannesrudolph

docs/roo-code-cloud/roomote-control.mdx

@@ -43,7 +43,7 @@ While basic monitoring is available to all users, remote control capabilities (s
 
 ## Getting Started
 
-### Step 1: Connect Your Account
+#### Step 1: Connect Your Account
 
 First, you need to connect your Roo Code extension to Roo Code Cloud. Follow the [login instructions](/roo-code-cloud/login#getting-started) to connect your account.
 
@@ -68,6 +68,58 @@ Once your account is connected and Roomote Control is enabled:
 4. Click **Start** to begin the task
 5. Watch real-time progress in your browser
 
+## Notifications
+
+
+Receive push notifications about task updates and completions without keeping the app open.
+
+### Requirements
+- Signed in to your Roomote account on the device.
+- Supported browser with Notifications, Service Workers, and Push:
+  - iPhone/iPad (iOS 16.4+): Safari installed to Home Screen is required.
+  - Android: Chrome, Edge, Firefox (install optional).
+  - Desktop: Chrome, Edge, Firefox, Safari 16+ on macOS (Ventura+)
+- Allow notifications when prompted by the browser/OS.
+
+### Turn it on
+Toggle location: Settings › User.
+
+<img src="/img/roomote-control/roomote-control.png" alt="Enable Push Notifications in Settings › User" width="500" />
+
+- iPhone/iPad (Safari)
+  1. Open https://app.roocode.com.
+  2. Share › Add to Home Screen › Add.
+  3. Launch Roo Code from the Home Screen icon.
+  4. In the app: Settings › User › Push Notifications — turn On; allow the permission prompt.
+- Android (Chrome)
+  1. Open https://app.roocode.com.
+  2. Optional: Menu › Add to Home screen / Install app.
+  3. Settings › User › Push Notifications — turn On; allow the permission prompt.
+- Desktop
+  1. Open https://app.roocode.com and sign in.
+  2. Settings › User › Push Notifications — turn On; allow the permission prompt.
+
+### Manage per device
+- Location: Settings › User.
+- The Push Notifications switch controls only the current browser/device.
+- To stop notifications on a device, toggle Off there or use OS/browser notification settings for Roo Code.
+
+### What to expect
+- A permission prompt the first time you enable notifications.
+- Alerts for task updates and completions.
+- Clicking a notification opens Roo Code, usually to the relevant task.
+
+### Troubleshooting
+- No permission prompt: Use a supported browser, disable private/incognito mode, and ensure site notifications aren't blocked.
+- iPhone not receiving: Make sure Roo Code is installed to Home Screen, opened from the icon, and Push Notifications is On.
+- Duplicate notifications: You've enabled them on multiple devices. Turn them Off on devices you don't want.
+- Nothing arrives: Check system notification settings for Roo Code, confirm you're signed in, and that Push Notifications is On.
+
+### Limits
+- iOS requires installing to Home Screen (iOS 16.4+).
+- Private/incognito modes and some corporate policies can block notifications or background updates.
+- An internet connection is required to receive notifications.
+- Enabling on one device does not enable on others; manage each device separately.
 
 ## Limitations