functionland · ehsan6sha · Aug 30, 2026 · Aug 30, 2026
diff --git a/docs/functionyard/add-storage.md b/docs/functionyard/add-storage.md
@@ -89,7 +89,7 @@ In the following commands, replace `sdx` with the device name(s) found in the ou
 6. Assign your drive the `GPT` partition standard with `sudo parted /dev/sdx mklabel gpt`
 7. Partition your drive with `sudo parted -a opt /dev/sdx mkpart primary ext4 0% 100%`
 8. Format the newly created partition with `sudo mkfs.ext4 /dev/sdx1`
-9. Wait for it to complete. Then restart FxBlox app.
+9. Wait for it to complete. Then restart the FxBlox app (in the web app, reload the tab).
 10. You should now see that your total maximum storage has increased by the size of the drive you installed. You may also need to hit the refresh button.
 
 If you have any issues, checkout the [Troubleshoot](#troubleshoot) section for more information.
@@ -137,7 +137,7 @@ After partitioning is complete. Now we can format using the `e2fsprogs` command.
 :::
 19. Wait for it to complete and safely eject drive.
 20. Connect your drive to the FxBlox.
-21. **Close FxBlox app**. Now open your Fxblox app now and see your total maximum storage increase in the FxBlox app. 
+21. **Restart the FxBlox app** (in the web app, reload the tab; on the mobile app, close and re-open it). You should now see your total maximum storage increase. 
 
 If the drive does not show within the next 5 minutes there maybe a variety of issues occurring. **Checkout the [Troubleshooting](#troubleshoot) section for more details.**
 
@@ -192,12 +192,12 @@ Ext4 is a linux standard that Windows does not support without some third-party
 
 11. Connect your drive to the FxBlox
 
-12. Close FxBlox app if its currently opened, otherwise open your Fxblox app now and see your total maximum storage increase in the FxBlox app.
+12. Restart the FxBlox app (in the web app, reload the tab; on the mobile app, close and re-open it) and see your total maximum storage increase.
 
 ## Troubleshoot
 - **Drive not recognized in Windows.** If your windows computer doesn't see the connected drive, try restarting your computer first. Then look into potentially installing drivers for the storage device.
 - **Storage capacity not updating** This could be for a variety of issues:
- - Try closing/opening your app a couple of times, but also press the `retry` buttons a once or twice in between.
+ - Try reloading the app a couple of times (reload the tab in the web app), but also press the `retry` buttons a once or twice in between.
  - Restart the FxBlox by unplug-plugging it back in.
  - The usb3 drive is connected to a usb2 port. On a **FxBlox Lite**, the top two ports are USB2.0 and the bottom is USB3.0. On a **FxBlox Lite Plus**, the top port is USB2.0 and the bottom two are USB3.0.
 - **Additional storage devices not showing up under `Device` Tab.** This is a known bug, as of app version 1.6.2. Currently, newly added storage gets added to the total instead of as a separate device.

diff --git a/docs/functionyard/fxblox-app.md b/docs/functionyard/fxblox-app.md
diff --git a/docs/functionyard/hardware/fxblox-hardware-rpi.md b/docs/functionyard/hardware/fxblox-hardware-rpi.md
@@ -54,7 +54,7 @@ In update process the LED blinks red and green. This phase is very critical, and
 
 Please wait for `10-15 minutes` before doing anything. You may think it is done or stuck or it is turned off, but be sure that it is processing the update for `10-15 minutes` after the first boot. At the end of process the LED starts blinking light blue (cyan) consistently if an external storage is plugged to the blox or it has internal storage (XL orders). If no external storage is plugged, then you cannot see this sequence until you plug one.
 
-**Use FxBlox App**: After the lights become a flashing blue, you can start setting up the Blox with the application. Follow on-screen instructions in the app. Please make sure follow instructions as detailed in the [documentation](../fxblox-app.md)
+**Use the FxBlox App**: After the lights become a flashing blue, you can start setting up the Blox from your browser at [https://docs.fx.land/fxblox-web/](https://docs.fx.land/fxblox-web/) (Chrome or Edge). Follow the on-screen instructions, and make sure to follow the steps as detailed in the [documentation](../fxblox-app.md)
 
 - If at the end of setup through the FxBlox app, you see a message that the app could not connect to Blox, Close the app, unplug and re-plug the blox and wait for 1 minute and open the app.
 
@@ -67,7 +67,7 @@ If this is your very first time setting up your FxBlox Lite (RPI), you will not
 
 To automatically get that version, you need to connect the Blox to the wifi first. You can do so by following these steps:
 
-1. Download the latest iOS/Android app.
+1. Open the FxBlox app at [https://docs.fx.land/fxblox-web/](https://docs.fx.land/fxblox-web/) in Chrome or Edge (see [FxBlox App Setup](../fxblox-app.md)).
 2. Follow prompts to create password and connect Metamask.
 3. On the authorize blox screen wait for 15 seconds and a "skip" button appears in the bottom left. click that to skip the authorization and then click yes to confirm. [** * **](#troubleshoot)
 4. Connect Blox to wifi. [** * **](#troubleshoot)

diff --git a/docs/functionyard/mainnet-transition/android-connected.md b/docs/functionyard/mainnet-transition/android-connected.md
@@ -1,29 +1,31 @@
 ---
-title: Android - Blox Connected
+title: Blox Connected
 id: android-connected
 ---
 
-# Android Mainnet Transition - Blox Connected
+# Mainnet Transition - Blox Connected
 
-This guide is for Android users whose Blox app shows as **connected** to their Blox device.
+This guide is for users whose FxBlox app shows their Blox as **connected**.
 
-<div style={{backgroundColor: '#e8f5e8', padding: '15px', borderRadius: '8px', margin: '20px 0'}}>
-<strong>✅ Prerequisites:</strong>
-<ul>
-<li>Your Blox app shows "Connected" status</li>
-<li>FxBlox app version 2.0.1 or higher</li>
-<li>Your Blox account ID saved for token claiming</li>
-</ul>
-</div>
+:::info Prerequisites
+- Your app shows "Connected" status
+- You are using the web app at [https://docs.fx.land/fxblox-web/](https://docs.fx.land/fxblox-web/), or the legacy mobile app at version 2.0.1 or higher
+- Your Blox account ID is saved for token claiming
+:::
 
 <img src="/img/mainnet-transition/blox_connected.jpg" alt="Blox Connected Status" style={{maxWidth: '250px'}} />
 
-## Step 1: Update Your App
+## 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.
 
-Ensure your FxBlox app is updated to at least **version 2.0.1**.
+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.
 
-1. Check your app version in **Settings > About** (at the bottom of the screen)
-2. Update from Google Play Store if needed
+You can check the version at any time in **Settings > About**.
+
+:::info Still on the mobile app?
+Make sure it is at least **version 2.0.1** — update it from your app store. The Android and iOS apps are being discontinued, so please move to the web app when you can.
+:::
 
 <img src="/img/mainnet-transition/version_check.jpg" alt="Version Check" style={{maxWidth: '250px'}} />
 
@@ -37,12 +39,12 @@ Default selection is **Skale**. If you have an authorization code, change to **B
 2. Ensure you are on the correct chain (Base/Skale)
 3. Click the **"Add and Switch to Skale/Base"** button
 4. This will open MetaMask
-5. In MetaMask, ensure you are on the same chain selected in the Blox app
+5. In MetaMask, ensure you are on the same chain selected in the FxBlox app
 
-## Step 3: Close and Restart Apps
+## Step 3: Restart
 
-1. **Close both** FxBlox app and MetaMask completely
-2. **Re-open** the FxBlox app
+1. **Close MetaMask** completely
+2. **Reload the FxBlox tab** (or, on the mobile app, close and re-open it)
 
 ## Step 4: Switch to Mainnet
 

diff --git a/docs/functionyard/mainnet-transition/android-disconnected.md b/docs/functionyard/mainnet-transition/android-disconnected.md
@@ -1,30 +1,27 @@
 ---
-title: Android - Blox Disconnected
+title: Blox Disconnected
 id: android-disconnected
 ---
 
-# Android Mainnet Transition - Blox Disconnected
+# Mainnet Transition - Blox Disconnected
 
-This guide is for Android users whose Blox app shows as **disconnected** from their Blox device.
+This guide is for users whose FxBlox app shows their Blox as **disconnected**.
 
-<div style={{backgroundColor: '#fff3cd', padding: '15px', borderRadius: '8px', margin: '20px 0'}}>
-<strong>⚠️ Prerequisites:</strong>
-<ul>
-<li>Your Blox app shows "Disconnected" status</li>
-<li>You've tried unplugging/replugging and clicking retry without success</li>
-<li>FxBlox app version 2.0.1 or higher</li>
-<li>Your Blox account ID saved for token claiming</li>
-</ul>
-</div>
+:::caution Prerequisites
+- Your app shows "Disconnected" status
+- You've tried unplugging/replugging and clicking retry without success
+- You are using the web app at [https://docs.fx.land/fxblox-web/](https://docs.fx.land/fxblox-web/), or the legacy mobile app at version 2.0.1 or higher
+- Your Blox account ID is saved for token claiming
+:::
 
 <img src="/img/mainnet-transition/blox_disconnected.jpg" alt="Blox Disconnected Status" style={{maxWidth: '250px'}} />
 
 ## Step 1: Verify Internet Connection
 
 First, ensure your Blox is connected to the internet:
 
-1. Go to **Settings > Blox Discovery** (ensure your mobile is on the same WiFi network as your Blox)
-2. If Blox is connected to internet, the page should show it
+1. Go to **Settings > Blox discovery** and search the network (make sure your computer or phone is on the same Wi-Fi as the Blox)
+2. If the Blox is on the network, it will be listed there
 3. You can also check from your router admin panel
 
 <img src="/img/mainnet-transition/blox_discovery.jpg" alt="Blox Discovery" style={{maxWidth: '250px'}} />
@@ -70,7 +67,7 @@ Purple and blue LEDs indicate the factory reset is in progress. Be patient durin
 
 After the Blox starts **flashing cyan**:
 
-1. Use the FxBlox app to set up your Blox
+1. Open the FxBlox web app at **[https://docs.fx.land/fxblox-web/](https://docs.fx.land/fxblox-web/)** in Chrome or Edge and set your Blox up again — the full walkthrough is on the [FxBlox App Setup](/functionyard/fxblox-app) page
 2. Connect it to your internet/WiFi
 3. The app should now show **"Connected"**
 4. **Wait 2 hours** for the Blox to get fully updated
@@ -83,7 +80,7 @@ The 2-hour waiting period is crucial for the Blox to download and install all ne
 
 Once your Blox shows as connected and has been updated for 2 hours:
 
-1. Follow the instructions in the **[Android - Blox Connected](/functionyard/mainnet-transition/android-connected)** section
+1. Follow the instructions in the **[Blox Connected](/functionyard/mainnet-transition/android-connected)** section
 2. This includes chain selection, app restart, and pool joining
 
 ## LED Status Reference
@@ -93,7 +90,7 @@ Once your Blox shows as connected and has been updated for 2 hours:
 | 🟢 Green | Power on | Normal |
 | 🟡 Yellow | Booting | Wait for it to turn off |
 | 🟣 Purple + 🔵 Blue | Factory reset | Wait 10 minutes |
-| 🔵 Cyan (flashing) | Ready for setup | Use app to configure |
+| 🔵 Cyan (flashing) | Ready for setup | Use the app to configure |
 
 :::success Success Indicator
 When your app shows "Connected" status after the reset and 2-hour wait period, you're ready to proceed with the mainnet transition!
@@ -111,6 +108,6 @@ When your app shows "Connected" status after the reset and 2-hour wait period, y
 **If still showing disconnected after reset:**
 - Verify WiFi credentials are correct
 - Check router settings for device blocking
-- Ensure Blox and phone are on same network
+- Ensure the Blox and the device running the app are on the same network
 
 **Need more help?** Visit our [Support page](/functionyard/support) for additional assistance.
diff --git a/docs/functionyard/mainnet-transition/existing-testnet.md b/docs/functionyard/mainnet-transition/existing-testnet.md
@@ -7,62 +7,42 @@ id: existing-testnet
 
 This guide is for users who have **already joined the testnet** and want to transition to mainnet.
 
-<div style={{backgroundColor: '#fff3cd', padding: '15px', borderRadius: '8px', margin: '20px 0'}}>
-<strong>⚠️ Critical First Step</strong>
-<br />
-Before proceeding, <strong>copy and save your Blox account ID</strong> for future claiming of earned testnet tokens. You will need this for the claim process at <a href="https://claim-ui.fula.network" target="_blank">https://claim-ui.fula.network</a>
-</div>
-
-## Choose Your Device Path
+:::warning Critical First Step
+Before proceeding, **copy and save your Blox account ID** for future claiming of earned testnet tokens. You will need this for the claim process at [https://claim-ui.fula.network](https://claim-ui.fula.network).
+:::
 
-The transition process varies depending on your device type and current Blox connection status. Select the path that matches your situation:
+## Choose Your Path
 
-### 📱 Android Users
+The transition process depends on your Blox's current connection status. Select the path that matches your situation:
 
-Your next steps depend on whether your Blox is currently connected or disconnected in the app:
+### Blox is connected
 
-<div style={{display: 'flex', gap: '20px', flexWrap: 'wrap', margin: '20px 0'}}>
+Your FxBlox app shows your Blox as connected and working properly.
 
-<div style={{flex: '1', minWidth: '300px', backgroundColor: '#e8f5e8', padding: '20px', borderRadius: '8px', border: '2px solid #28a745'}}>
-<h4>✅ Blox is Connected</h4>
-<p>Your FxBlox app shows your Blox as connected and working properly.</p>
-<a href="/functionyard/mainnet-transition/android-connected" style={{backgroundColor: '#28a745', color: 'white', padding: '10px 20px', borderRadius: '5px', textDecoration: 'none', display: 'inline-block'}}>
-→ Follow Android Connected Guide
-</a>
-</div>
+→ **[Follow the Blox Connected guide](/functionyard/mainnet-transition/android-connected)**
 
-<div style={{flex: '1', minWidth: '300px', backgroundColor: '#fff3cd', padding: '20px', borderRadius: '8px', border: '2px solid #ffc107'}}>
-<h4>⚠️ Blox is Disconnected</h4>
-<p>Your FxBlox app shows your Blox as disconnected or you're having connection issues.</p>
-<a href="/functionyard/mainnet-transition/android-disconnected" style={{backgroundColor: '#ffc107', color: 'black', padding: '10px 20px', borderRadius: '5px', textDecoration: 'none', display: 'inline-block'}}>
-→ Follow Android Disconnected Guide
-</a>
-</div>
+### Blox is disconnected
 
-</div>
+Your FxBlox app shows your Blox as disconnected, or you're having connection issues.
 
-### 🍎 iOS Users
+→ **[Follow the Blox Disconnected guide](/functionyard/mainnet-transition/android-disconnected)**
 
-<div style={{backgroundColor: '#f8d7da', padding: '20px', borderRadius: '8px', border: '2px solid #dc3545', margin: '20px 0'}}>
-<h4>📱 iOS Requires Full Reset</h4>
-<p>iOS users need to reset both the Blox device and the application. Make sure you have your Blox account ID saved before proceeding!</p>
-<a href="/functionyard/mainnet-transition/ios" style={{backgroundColor: '#dc3545', color: 'white', padding: '10px 20px', borderRadius: '5px', textDecoration: 'none', display: 'inline-block'}}>
-→ Follow iOS Transition Guide
-</a>
-</div>
+:::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.
+:::
 
 ## Pre-Transition Checklist
 
 Before starting your transition, ensure you have:
 
 - [ ] **Saved your Blox account ID** from the current app
-- [ ] **Updated your FxBlox app** to version 2.0.1 or higher
+- [ ] **Opened the web app** at [https://docs.fx.land/fxblox-web/](https://docs.fx.land/fxblox-web/) in Chrome or Edge — or, if you are staying on the legacy mobile app, updated it to version 2.0.1 or higher
 - [ ] **Stable internet connection** for your Blox device
-- [ ] **MetaMask app** installed on your device (if not already installed)
+- [ ] **MetaMask** available (browser extension on desktop, app on Android)
 - [ ] **2+ hours of time** available for the complete process
 
-:::info App Version Check
-You can check your app version in **Settings > About** at the bottom of the screen.
+:::info Version Check
+The web app is always current — just reload the tab. On the legacy mobile app you can check the version in **Settings > About** at the bottom of the screen.
 :::
 
 ![Version Check](/img/mainnet-transition/version_check.jpg)
@@ -85,23 +65,26 @@ Your testnet rewards will be claimable separately through the claim portal. The
 **Q: Will I lose my testnet rewards?**
 A: No, if you saved your Blox account ID, you can claim testnet rewards at [https://claim-ui.fula.network](https://claim-ui.fula.network)
 
+**Q: Do I have to set my Blox up again to use the web app?**
+A: No. Your identity comes from your password plus your wallet signature, exactly as on the phone. Sign in with the same password and the same wallet and your Blox is recognised straight away.
+
 **Q: How long does the transition take?**
 A: The process takes 2-3 hours total, including waiting time for device updates.
 
 **Q: Can I go back to testnet?**
 A: The transition to mainnet is intended to be permanent. Contact support if you need to revert.
 
-**Q: What if my device type isn't listed?**
-A: These guides cover Android and iOS. For other devices, contact our [Support team](/functionyard/support).
+**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).
 
 ---
 
 ## Need Help?
 
-If you're unsure about your device type or connection status:
+If you're unsure about your connection status:
 
-1. **Check your device**: Look at your phone/tablet settings to confirm Android or iOS
-2. **Check connection status**: Open your FxBlox app and look at the main screen
+1. **Open the app** and look at the main screen — it shows Connected or Disconnected
+2. **Check from your router** admin panel to see whether the Blox is on your network
 3. **Contact support**: Visit our [Support page](/functionyard/support) for assistance
 
-**Ready to start?** Choose your device path above and follow the detailed instructions!
+**Ready to start?** Choose your path above and follow the detailed instructions!