functionland · ehsan6sha · Aug 30, 2026 · Aug 30, 2026
diff --git a/docs/functionyard/fxblox-app.md b/docs/functionyard/fxblox-app.md
@@ -14,10 +14,10 @@ The FxBlox app now runs **in your browser**. There is nothing to install and not
 - Setting up a Blox uses Web Bluetooth and your browser's local-network permission, which only Chromium-based browsers provide. Firefox and Safari will show an "unsupported browser" page.
 :::
 
-:::caution iPhone and iPad
-The web app **cannot run on an iPhone or iPad**. Every browser on iOS — including Chrome and Edge — is built on Apple's WebKit engine, which has no Web Bluetooth and no local-network access, so there is no way for a page to reach your Blox.
+:::caution iOS is not supported — use a computer
+The FxBlox app **does not support iPhone or iPad**. Every browser on iOS — including Chrome and Edge — is built on Apple's WebKit engine, which has no Web Bluetooth and no local-network access, so a web page on iOS has no way to reach your Blox.
 
-If you have an iPhone, set your Blox up from **a computer with Chrome or Edge**, or from an Android phone. The legacy iOS app still works for now — see [Legacy mobile apps](#legacy-mobile-apps) at the bottom of this page.
+**Set your Blox up from a computer instead** — Windows, macOS or Linux with Chrome or Edge. This is new: the old mobile apps could only run on a phone, so you had to use one. The web app runs on a desktop or laptop, so a computer is now the simplest way to set up a Blox. (An Android phone works too, if that is what you have to hand.)
 :::
 
 :::warning
@@ -157,10 +157,12 @@ The Blox reconnects to the network and saves chain history automatically.
 
 ## Troubleshooting
 
-- **The app says your browser will not work.** Use Chrome or Edge on a computer or an Android phone. iPhones and iPads cannot run it — see the note at the top of this page.
+- **The app says your browser will not work.** Use Chrome or Edge on a computer (Windows, macOS or Linux), or on an Android phone. iOS is not supported — see the note at the top of this page.
 - **"Your browser is blocking access to your network."** Chrome has not been granted local network access for this site. Allow it at `chrome://settings/content/localNetworkAccess`, then reload the page. Or use **Connect via Bluetooth**, which does not need that permission.
 - **The Blox answers but the app reports missing CORS headers.** The firmware predates the web update. Use **Connect via Bluetooth** to continue, or update the Blox from the legacy mobile app.
-- **Chrome's Bluetooth chooser is empty.** Leave it open for up to 90 seconds — the Blox advertises periodically rather than continuously. Make sure Bluetooth is on and, on Android, that the browser has location/nearby-devices permission.
+- **Chrome's Bluetooth chooser is empty.** Leave it open for up to 90 seconds — the Blox advertises periodically rather than continuously. Make sure Bluetooth is switched on, and that the browser itself is allowed to use it (see the macOS and Android notes below).
+- **On macOS**, Chrome needs two permissions from the system or it will fail quietly. Grant both under **System Settings → Privacy & Security**: **Bluetooth** (otherwise the device chooser stays empty) and **Local Network** (otherwise the app cannot reach the Blox over Wi-Fi). Quit and reopen Chrome after changing them.
+- **On Android**, the browser needs the location / nearby-devices permission before it can scan for Bluetooth devices.
 - **The wallet does not come back after signing.** Switch back to the FxBlox tab yourself. If MetaMask is stuck on its splash screen, close it fully from recent apps and tap **Open wallet to approve** again.
 - **Connection problems at the final step.** Connect to the same Wi-Fi as the Blox, reload the page, and use **Reconnect to existing blox**. If that does not work, restart the Blox, wait for the flashing light blue, and set it up again.
 - **Starting completely over.** The browser equivalent of uninstalling and reinstalling the app is **Clear app storage** on the *Set identity* screen. It deletes everything FxBlox stored in this browser — identity, Blox list, settings and caches — and reloads the page.
@@ -183,7 +185,7 @@ The Android and iOS FxBlox apps are being discontinued and will stop receiving u
 You do not lose anything by switching: the same password and the same wallet give you the same identity, so your existing Bloxes are recognised immediately.
 :::
 
-While they last, the mobile apps are still available:
+They are listed here only for people who already have them installed. **Don't set up a new Blox with them** — use a computer with Chrome or Edge instead.
 
 - Android: [FxBlox on Google Play](https://play.google.com/store/apps/details?id=land.fx.blox) (version 2.0.1 or higher)
 - iOS: [FxBlox on the App Store](https://apps.apple.com/ca/app/fxblox/id6444862171) (version 2.0.1 or higher)

diff --git a/docs/functionyard/mainnet-transition/android-connected.md b/docs/functionyard/mainnet-transition/android-connected.md
@@ -17,7 +17,7 @@ This guide is for users whose FxBlox app shows their Blox as **connected**.
 
 ## Step 1: Open the app
 
-Open **[https://docs.fx.land/fxblox-web/](https://docs.fx.land/fxblox-web/)** in Chrome or Edge, on a computer or an Android phone. There is nothing to install and nothing to update — reload the tab and you are on the latest version.
+Open **[https://docs.fx.land/fxblox-web/](https://docs.fx.land/fxblox-web/)** in Chrome or Edge on a computer (Windows, macOS or Linux), or on an Android phone. There is nothing to install and nothing to update — reload the tab and you are on the latest version.
 
 Sign in with the same password and the same wallet you used before; your Blox is recognised immediately. If it does not appear, use **Reconnect to existing blox** and search your network.
 

diff --git a/docs/functionyard/mainnet-transition/existing-testnet.md b/docs/functionyard/mainnet-transition/existing-testnet.md
@@ -28,7 +28,7 @@ Your FxBlox app shows your Blox as disconnected, or you're having connection iss
 → **[Follow the Blox Disconnected guide](/functionyard/mainnet-transition/android-disconnected)**
 
 :::caution Using an iPhone or iPad?
-The Blox itself still needs a factory reset, but the web app cannot run on iOS. See **[iPhone & iPad](/functionyard/mainnet-transition/ios)** for what to do.
+iOS is not supported — do the transition from a **computer** with Chrome or Edge. See **[iPhone & iPad](/functionyard/mainnet-transition/ios)**.
 :::
 
 ## Pre-Transition Checklist
@@ -75,7 +75,7 @@ A: The process takes 2-3 hours total, including waiting time for device updates.
 A: The transition to mainnet is intended to be permanent. Contact support if you need to revert.
 
 **Q: I only have an iPhone. What now?**
-A: Use a computer with Chrome or Edge, or an Android phone. See [iPhone & iPad](/functionyard/mainnet-transition/ios).
+A: Use a computer — Windows, macOS or Linux with Chrome or Edge. The old apps were phone-only, but the web app runs on a desktop or laptop, so no phone is needed. See [iPhone & iPad](/functionyard/mainnet-transition/ios).
 
 ---
 

diff --git a/docs/functionyard/mainnet-transition/index.md b/docs/functionyard/mainnet-transition/index.md
@@ -11,7 +11,7 @@ Welcome to the Mainnet Transition guide! This section will help you smoothly tra
 
 The FxBlox app now runs in your browser at **[https://docs.fx.land/fxblox-web/](https://docs.fx.land/fxblox-web/)** — nothing to install, and always the latest version.
 
-Open it in **Chrome or Edge**, on a computer or an Android phone. Your identity is derived from your password and your wallet signature exactly as it was on the phone, so a Blox you already set up is recognised straight away.
+Open it in **Chrome or Edge** on a computer (Windows, macOS or Linux), or on an Android phone. iPhone and iPad are not supported. Your identity is derived from your password and your wallet signature exactly as it was on the phone, so a Blox you already set up is recognised straight away.
 
 :::caution The Android and iOS apps are being discontinued
 They will stop receiving updates. See [FxBlox App Setup](/functionyard/fxblox-app) for the full walkthrough, and [iPhone & iPad](/functionyard/mainnet-transition/ios) if you use an Apple device.
@@ -33,7 +33,7 @@ Pick the guide that matches your situation:
 
 ### Using an iPhone or iPad?
 
-- **[iPhone & iPad](/functionyard/mainnet-transition/ios)** — what to do, since the web app cannot run on iOS
+- **[iPhone & iPad](/functionyard/mainnet-transition/ios)** — iOS is not supported; use a computer with Chrome or Edge
 
 ## Important Notes
 

diff --git a/docs/functionyard/mainnet-transition/ios.md b/docs/functionyard/mainnet-transition/ios.md
@@ -5,29 +5,29 @@ id: ios
 
 # iPhone & iPad
 
-## The web app does not run on iOS
+## iOS is not supported — use a computer
 
-The FxBlox app now runs in the browser, but **it cannot run on an iPhone or iPad**.
+The FxBlox app **does not support iPhone or iPad**.
 
 Setting up and managing a Blox needs Web Bluetooth and your browser's local-network permission. Apple requires every browser on iOS — including Chrome and Edge — to use its WebKit engine, and WebKit provides neither. This is a limitation of iOS itself, not something the app can work around.
 
-:::tip What to do instead
-1. **Use a computer.** Windows, macOS or Linux with **Chrome or Edge**, at [https://docs.fx.land/fxblox-web/](https://docs.fx.land/fxblox-web/). This is the recommended route and gives you the full app.
-2. **Or use an Android phone**, also with Chrome or Edge.
-3. **Or keep using the legacy iOS app** for now — see below.
+:::tip Use a computer instead
+Open [https://docs.fx.land/fxblox-web/](https://docs.fx.land/fxblox-web/) on a **computer** — Windows, macOS or Linux — in **Chrome or Edge**. There is nothing to install.
 
-Your identity is derived from your password and your wallet signature, so whichever device you use, the same password with the same wallet gives you the same identity and your existing Bloxes are recognised immediately. Nothing needs re-pairing.
+This is the part that changed. The old FxBlox apps only ran on a phone, so if you had an iPhone you had to use the iPhone app. The web app runs on any desktop or laptop, so **a computer is now the normal way to set up a Blox** — you no longer need a phone at all. (An Android phone works too, if that is what you have to hand.)
+
+Your identity comes from your password and your wallet signature, so whichever computer you use, the same password with the same wallet gives you the same identity and your existing Bloxes are recognised immediately. Nothing needs re-pairing.
 :::
 
-:::caution The iOS app is being discontinued
-[FxBlox on the App Store](https://apps.apple.com/ca/app/fxblox/id6444862171) still works and should be at **version 2.0.1 or higher**, but it will stop receiving updates. Please move to a computer with Chrome or Edge when you can.
+:::caution Don't start on the iOS app
+The Android and iOS apps are being discontinued and will stop receiving updates, so please don't set up a new Blox with them. Use a computer with Chrome or Edge.
 :::
 
 ---
 
-# Mainnet Transition on iOS
+# Mainnet Transition for iPhone owners
 
-If you are transitioning from testnet on an iPhone, the Blox itself still needs a factory reset. The device steps below are the same regardless of which app you use afterwards.
+If you are transitioning from testnet and your phone is an iPhone, the Blox itself still needs a factory reset. Do the device steps below, then finish on a computer.
 
 :::warning Critical: Save Your Account ID
 Before doing anything else, **copy and save your Blox account ID** from the app. You will need it for claiming testnet tokens at [https://claim-ui.fula.network](https://claim-ui.fula.network).
@@ -87,8 +87,7 @@ On the **5th time** you plug it back:
 
 After the Blox starts **flashing cyan**:
 
-1. Open **[https://docs.fx.land/fxblox-web/](https://docs.fx.land/fxblox-web/)** on a computer with Chrome or Edge — or on an Android phone — and follow the [FxBlox App Setup](/functionyard/fxblox-app) guide.
- - If you are staying on the legacy iOS app, update it from the App Store to version 2.0.1 or higher first. The app is reset during the update; that is expected.
+1. On a **computer** (Windows, macOS or Linux) open **[https://docs.fx.land/fxblox-web/](https://docs.fx.land/fxblox-web/)** in Chrome or Edge and follow the [FxBlox App Setup](/functionyard/fxblox-app) guide. Your iPhone is not needed for this step.
 2. Connect the Blox to your internet/WiFi
 3. The app should now show **"Connected"**
 4. **Wait 2 hours** for the Blox to get fully updated
@@ -147,12 +146,12 @@ You have successfully transitioned to mainnet! Your rewards will now accumulate
 ## Troubleshooting
 
 **App Issues:**
-- On the web app, reload the tab; if a "new version available" prompt appears, accept it
-- On the legacy iOS app, ensure you're using the latest version from the App Store and try force-closing and reopening it
+- Reload the tab; if a "new version available" prompt appears, accept it
+- If the app shows an "unsupported browser" page, you are on iOS — switch to a computer with Chrome or Edge
 
 **Blox Connection Issues:**
 - Verify WiFi credentials are correct
-- Ensure the Blox and the device running the app are on the same network
+- Ensure the Blox and the computer running the app are on the same network
 - Check router settings for device blocking
 
 **Reset Problems:**

diff --git a/docs/functionyard/mainnet-transition/new-installation.md b/docs/functionyard/mainnet-transition/new-installation.md
@@ -23,8 +23,8 @@ This guide is for users who are setting up their Blox device for the **first tim
 The full walkthrough, with screenshots, is on the [FxBlox App Setup](/functionyard/fxblox-app) page. The setup process is guided and straightforward.
 :::
 
-:::caution iPhone and iPad
-The web app cannot run on an iPhone or iPad — every iOS browser uses Apple's WebKit engine, which has no Web Bluetooth or local-network access. Use a computerwith Chrome or Edge, or an Android phone. See [iPhone & iPad](/functionyard/mainnet-transition/ios).
+:::caution iOS is not supported
+The app does not support iPhone or iPad — every iOS browser uses Apple's WebKit engine, which has no Web Bluetooth or local-network access. **Use a computer** (Windows, macOS or Linux) with Chrome or Edge. Unlike the old mobile apps, the web app runs on a desktop or laptop, so you no longer need a phone at all. See [iPhone & iPad](/functionyard/mainnet-transition/ios).
 :::
 
 ## Step 2: Skip Testnet

diff --git a/docs/getting-started-testnet.md b/docs/getting-started-testnet.md
@@ -34,7 +34,7 @@ At a high level, follow these steps to connect your Blox to the network:
 ![Blox Setup Flow](/img/welcome/getting-started.jpeg)
 
 :::info The FxBlox app runs in your browser
-Set your Blox up at **[https://docs.fx.land/fxblox-web/](https://docs.fx.land/fxblox-web/)** using Chrome or Edge, on a computer or an Android phone — there is nothing to install. The Android and iOS apps are being discontinued. See [FxBlox App Setup](/functionyard/fxblox-app) for the full walkthrough.
+Set your Blox up at **[https://docs.fx.land/fxblox-web/](https://docs.fx.land/fxblox-web/)** using Chrome or Edge on a computer (Windows, macOS or Linux), or on an Android phone — there is nothing to install. iPhone and iPad are not supported. The Android and iOS apps are being discontinued. See [FxBlox App Setup](/functionyard/fxblox-app) for the full walkthrough.
 :::
 
 :::info