Skip to content

Commit c1df47b

Browse files
ehsan6shaclaude
andauthored
docs: lead with the FxBlox web app, mark the mobile apps as being discontinued (#175)
The FxBlox app now runs in the browser at https://docs.fx.land/fxblox-web/. Every setup path in the docs still told users to install a phone app. - fxblox-app.md: rewritten as a web-app-first walkthrough matching the real screens (welcome, browser check, identity, Bluetooth/LAN/hotspot, authorizer + format, Wi-Fi, finish), with four new screenshots. Adds "already set up from the phone?" (same password + wallet = same identity, no re-pairing), replaces the obsolete log-out-and-re-add loop with the multi-select flow, and keeps the store links in a clearly-labelled "Legacy mobile apps" section. Anchors #add-multiple-fxbloxes and #format-drive preserved for inbound links from join.md and fxblox-hardware-rk1.md; fixes the page's own broken #add-multiple-fxbloxs self-link. Version claims corrected to 2.0.1+. - mainnet-transition/: content made platform-neutral, file paths and every front-matter id unchanged so no URL moves. android-connected/-disconnected now split on Blox state rather than phone OS; ios.md says plainly that the web app cannot run on iOS (every iOS browser is WebKit, no Web Bluetooth or local-network access) and points to a desktop with Chrome or Edge. - disconnected-blox.md: "reinstall from your app store" becomes "Clear app storage"; Bluetooth recovery points at the web app's Settings > Bluetooth. - announcementBar, a "Web App" navbar item, and a sidebar link to the web app. - Smaller fixes in getting-started-testnet, fxblox-hardware-rpi, switch-chain and add-storage. FxFotos/FxFiles store links are deliberately untouched. Verified with a local docusaurus build (onBrokenLinks: throw) - passes. Claude-Session: https://claude.ai/code/session_01YJyqpFReP1wbz86nsqsoXq Co-authored-by: Claude Opus 5 (1M context) <noreply@anthropic.com>
1 parent 1f5434c commit c1df47b

18 files changed

Lines changed: 360 additions & 274 deletions

‎docs/functionyard/add-storage.md‎

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -89,7 +89,7 @@ In the following commands, replace `sdx` with the device name(s) found in the ou
8989
6. Assign your drive the `GPT` partition standard with `sudo parted /dev/sdx mklabel gpt`
9090
7. Partition your drive with `sudo parted -a opt /dev/sdx mkpart primary ext4 0% 100%`
9191
8. Format the newly created partition with `sudo mkfs.ext4 /dev/sdx1`
92-
9. Wait for it to complete. Then restart FxBlox app.
92+
9. Wait for it to complete. Then restart the FxBlox app (in the web app, reload the tab).
9393
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.
9494

9595
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.
137137
:::
138138
19. Wait for it to complete and safely eject drive.
139139
20. Connect your drive to the FxBlox.
140-
21. **Close FxBlox app**. Now open your Fxblox app now and see your total maximum storage increase in the FxBlox app.
140+
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.
141141

142142
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.**
143143

@@ -192,12 +192,12 @@ Ext4 is a linux standard that Windows does not support without some third-party
192192

193193
11. Connect your drive to the FxBlox
194194

195-
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.
195+
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.
196196

197197
## Troubleshoot
198198
- **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.
199199
- **Storage capacity not updating** This could be for a variety of issues:
200-
- Try closing/opening your app a couple of times, but also press the `retry` buttons a once or twice in between.
200+
- 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.
201201
- Restart the FxBlox by unplug-plugging it back in.
202202
- 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.
203203
- **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.

‎docs/functionyard/fxblox-app.md‎

Lines changed: 146 additions & 71 deletions
Large diffs are not rendered by default.

‎docs/functionyard/hardware/fxblox-hardware-rpi.md‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -54,7 +54,7 @@ In update process the LED blinks red and green. This phase is very critical, and
5454

5555
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.
5656

57-
**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)
57+
**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)
5858

5959
- 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.
6060

@@ -67,7 +67,7 @@ If this is your very first time setting up your FxBlox Lite (RPI), you will not
6767

6868
To automatically get that version, you need to connect the Blox to the wifi first. You can do so by following these steps:
6969

70-
1. Download the latest iOS/Android app.
70+
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)).
7171
2. Follow prompts to create password and connect Metamask.
7272
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)
7373
4. Connect Blox to wifi. [** * **](#troubleshoot)

‎docs/functionyard/mainnet-transition/android-connected.md‎

Lines changed: 21 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -1,29 +1,31 @@
11
---
2-
title: Android - Blox Connected
2+
title: Blox Connected
33
id: android-connected
44
---
55

6-
# Android Mainnet Transition - Blox Connected
6+
# Mainnet Transition - Blox Connected
77

8-
This guide is for Android users whose Blox app shows as **connected** to their Blox device.
8+
This guide is for users whose FxBlox app shows their Blox as **connected**.
99

10-
<div style={{backgroundColor: '#e8f5e8', padding: '15px', borderRadius: '8px', margin: '20px 0'}}>
11-
<strong>✅ Prerequisites:</strong>
12-
<ul>
13-
<li>Your Blox app shows "Connected" status</li>
14-
<li>FxBlox app version 2.0.1 or higher</li>
15-
<li>Your Blox account ID saved for token claiming</li>
16-
</ul>
17-
</div>
10+
:::info Prerequisites
11+
- Your app shows "Connected" status
12+
- 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
13+
- Your Blox account ID is saved for token claiming
14+
:::
1815

1916
<img src="/img/mainnet-transition/blox_connected.jpg" alt="Blox Connected Status" style={{maxWidth: '250px'}} />
2017

21-
## Step 1: Update Your App
18+
## Step 1: Open the app
19+
20+
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.
2221

23-
Ensure your FxBlox app is updated to at least **version 2.0.1**.
22+
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.
2423

25-
1. Check your app version in **Settings > About** (at the bottom of the screen)
26-
2. Update from Google Play Store if needed
24+
You can check the version at any time in **Settings > About**.
25+
26+
:::info Still on the mobile app?
27+
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.
28+
:::
2729

2830
<img src="/img/mainnet-transition/version_check.jpg" alt="Version Check" style={{maxWidth: '250px'}} />
2931

@@ -37,12 +39,12 @@ Default selection is **Skale**. If you have an authorization code, change to **B
3739
2. Ensure you are on the correct chain (Base/Skale)
3840
3. Click the **"Add and Switch to Skale/Base"** button
3941
4. This will open MetaMask
40-
5. In MetaMask, ensure you are on the same chain selected in the Blox app
42+
5. In MetaMask, ensure you are on the same chain selected in the FxBlox app
4143

42-
## Step 3: Close and Restart Apps
44+
## Step 3: Restart
4345

44-
1. **Close both** FxBlox app and MetaMask completely
45-
2. **Re-open** the FxBlox app
46+
1. **Close MetaMask** completely
47+
2. **Reload the FxBlox tab** (or, on the mobile app, close and re-open it)
4648

4749
## Step 4: Switch to Mainnet
4850

‎docs/functionyard/mainnet-transition/android-disconnected.md‎

Lines changed: 15 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -1,30 +1,27 @@
11
---
2-
title: Android - Blox Disconnected
2+
title: Blox Disconnected
33
id: android-disconnected
44
---
55

6-
# Android Mainnet Transition - Blox Disconnected
6+
# Mainnet Transition - Blox Disconnected
77

8-
This guide is for Android users whose Blox app shows as **disconnected** from their Blox device.
8+
This guide is for users whose FxBlox app shows their Blox as **disconnected**.
99

10-
<div style={{backgroundColor: '#fff3cd', padding: '15px', borderRadius: '8px', margin: '20px 0'}}>
11-
<strong>⚠️ Prerequisites:</strong>
12-
<ul>
13-
<li>Your Blox app shows "Disconnected" status</li>
14-
<li>You've tried unplugging/replugging and clicking retry without success</li>
15-
<li>FxBlox app version 2.0.1 or higher</li>
16-
<li>Your Blox account ID saved for token claiming</li>
17-
</ul>
18-
</div>
10+
:::caution Prerequisites
11+
- Your app shows "Disconnected" status
12+
- You've tried unplugging/replugging and clicking retry without success
13+
- 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
14+
- Your Blox account ID is saved for token claiming
15+
:::
1916

2017
<img src="/img/mainnet-transition/blox_disconnected.jpg" alt="Blox Disconnected Status" style={{maxWidth: '250px'}} />
2118

2219
## Step 1: Verify Internet Connection
2320

2421
First, ensure your Blox is connected to the internet:
2522

26-
1. Go to **Settings > Blox Discovery** (ensure your mobile is on the same WiFi network as your Blox)
27-
2. If Blox is connected to internet, the page should show it
23+
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)
24+
2. If the Blox is on the network, it will be listed there
2825
3. You can also check from your router admin panel
2926

3027
<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
7067

7168
After the Blox starts **flashing cyan**:
7269

73-
1. Use the FxBlox app to set up your Blox
70+
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
7471
2. Connect it to your internet/WiFi
7572
3. The app should now show **"Connected"**
7673
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
8380

8481
Once your Blox shows as connected and has been updated for 2 hours:
8582

86-
1. Follow the instructions in the **[Android - Blox Connected](/functionyard/mainnet-transition/android-connected)** section
83+
1. Follow the instructions in the **[Blox Connected](/functionyard/mainnet-transition/android-connected)** section
8784
2. This includes chain selection, app restart, and pool joining
8885

8986
## LED Status Reference
@@ -93,7 +90,7 @@ Once your Blox shows as connected and has been updated for 2 hours:
9390
| 🟢 Green | Power on | Normal |
9491
| 🟡 Yellow | Booting | Wait for it to turn off |
9592
| 🟣 Purple + 🔵 Blue | Factory reset | Wait 10 minutes |
96-
| 🔵 Cyan (flashing) | Ready for setup | Use app to configure |
93+
| 🔵 Cyan (flashing) | Ready for setup | Use the app to configure |
9794

9895
:::success Success Indicator
9996
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
111108
**If still showing disconnected after reset:**
112109
- Verify WiFi credentials are correct
113110
- Check router settings for device blocking
114-
- Ensure Blox and phone are on same network
111+
- Ensure the Blox and the device running the app are on the same network
115112

116113
**Need more help?** Visit our [Support page](/functionyard/support) for additional assistance.

‎docs/functionyard/mainnet-transition/existing-testnet.md‎

Lines changed: 27 additions & 44 deletions
Original file line numberDiff line numberDiff line change
@@ -7,62 +7,42 @@ id: existing-testnet
77

88
This guide is for users who have **already joined the testnet** and want to transition to mainnet.
99

10-
<div style={{backgroundColor: '#fff3cd', padding: '15px', borderRadius: '8px', margin: '20px 0'}}>
11-
<strong>⚠️ Critical First Step</strong>
12-
<br />
13-
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>
14-
</div>
15-
16-
## Choose Your Device Path
10+
:::warning Critical First Step
11+
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).
12+
:::
1713

18-
The transition process varies depending on your device type and current Blox connection status. Select the path that matches your situation:
14+
## Choose Your Path
1915

20-
### 📱 Android Users
16+
The transition process depends on your Blox's current connection status. Select the path that matches your situation:
2117

22-
Your next steps depend on whether your Blox is currently connected or disconnected in the app:
18+
### Blox is connected
2319

24-
<div style={{display: 'flex', gap: '20px', flexWrap: 'wrap', margin: '20px 0'}}>
20+
Your FxBlox app shows your Blox as connected and working properly.
2521

26-
<div style={{flex: '1', minWidth: '300px', backgroundColor: '#e8f5e8', padding: '20px', borderRadius: '8px', border: '2px solid #28a745'}}>
27-
<h4>✅ Blox is Connected</h4>
28-
<p>Your FxBlox app shows your Blox as connected and working properly.</p>
29-
<a href="/functionyard/mainnet-transition/android-connected" style={{backgroundColor: '#28a745', color: 'white', padding: '10px 20px', borderRadius: '5px', textDecoration: 'none', display: 'inline-block'}}>
30-
→ Follow Android Connected Guide
31-
</a>
32-
</div>
22+
→ **[Follow the Blox Connected guide](/functionyard/mainnet-transition/android-connected)**
3323

34-
<div style={{flex: '1', minWidth: '300px', backgroundColor: '#fff3cd', padding: '20px', borderRadius: '8px', border: '2px solid #ffc107'}}>
35-
<h4>⚠️ Blox is Disconnected</h4>
36-
<p>Your FxBlox app shows your Blox as disconnected or you're having connection issues.</p>
37-
<a href="/functionyard/mainnet-transition/android-disconnected" style={{backgroundColor: '#ffc107', color: 'black', padding: '10px 20px', borderRadius: '5px', textDecoration: 'none', display: 'inline-block'}}>
38-
→ Follow Android Disconnected Guide
39-
</a>
40-
</div>
24+
### Blox is disconnected
4125

42-
</div>
26+
Your FxBlox app shows your Blox as disconnected, or you're having connection issues.
4327

44-
### 🍎 iOS Users
28+
→ **[Follow the Blox Disconnected guide](/functionyard/mainnet-transition/android-disconnected)**
4529

46-
<div style={{backgroundColor: '#f8d7da', padding: '20px', borderRadius: '8px', border: '2px solid #dc3545', margin: '20px 0'}}>
47-
<h4>📱 iOS Requires Full Reset</h4>
48-
<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>
49-
<a href="/functionyard/mainnet-transition/ios" style={{backgroundColor: '#dc3545', color: 'white', padding: '10px 20px', borderRadius: '5px', textDecoration: 'none', display: 'inline-block'}}>
50-
→ Follow iOS Transition Guide
51-
</a>
52-
</div>
30+
:::caution Using an iPhone or iPad?
31+
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.
32+
:::
5333

5434
## Pre-Transition Checklist
5535

5636
Before starting your transition, ensure you have:
5737

5838
- [ ] **Saved your Blox account ID** from the current app
59-
- [ ] **Updated your FxBlox app** to version 2.0.1 or higher
39+
- [ ] **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
6040
- [ ] **Stable internet connection** for your Blox device
61-
- [ ] **MetaMask app** installed on your device (if not already installed)
41+
- [ ] **MetaMask** available (browser extension on desktop, app on Android)
6242
- [ ] **2+ hours of time** available for the complete process
6343

64-
:::info App Version Check
65-
You can check your app version in **Settings > About** at the bottom of the screen.
44+
:::info Version Check
45+
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.
6646
:::
6747

6848
![Version Check](/img/mainnet-transition/version_check.jpg)
@@ -85,23 +65,26 @@ Your testnet rewards will be claimable separately through the claim portal. The
8565
**Q: Will I lose my testnet rewards?**
8666
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)
8767

68+
**Q: Do I have to set my Blox up again to use the web app?**
69+
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.
70+
8871
**Q: How long does the transition take?**
8972
A: The process takes 2-3 hours total, including waiting time for device updates.
9073

9174
**Q: Can I go back to testnet?**
9275
A: The transition to mainnet is intended to be permanent. Contact support if you need to revert.
9376

94-
**Q: What if my device type isn't listed?**
95-
A: These guides cover Android and iOS. For other devices, contact our [Support team](/functionyard/support).
77+
**Q: I only have an iPhone. What now?**
78+
A: Use a computer with Chrome or Edge, or an Android phone. See [iPhone & iPad](/functionyard/mainnet-transition/ios).
9679

9780
---
9881

9982
## Need Help?
10083

101-
If you're unsure about your device type or connection status:
84+
If you're unsure about your connection status:
10285

103-
1. **Check your device**: Look at your phone/tablet settings to confirm Android or iOS
104-
2. **Check connection status**: Open your FxBlox app and look at the main screen
86+
1. **Open the app** and look at the main screen — it shows Connected or Disconnected
87+
2. **Check from your router** admin panel to see whether the Blox is on your network
10588
3. **Contact support**: Visit our [Support page](/functionyard/support) for assistance
10689

107-
**Ready to start?** Choose your device path above and follow the detailed instructions!
90+
**Ready to start?** Choose your path above and follow the detailed instructions!

0 commit comments

Comments
 (0)