Skip to content

Commit 2b3d9f9

Browse files
ehsan6shaclaude
andcommitted
docs: tell iPhone users to use a computer, not the legacy iOS app
The previous wording listed the legacy iOS app as a third option for iPhone owners. That buried the actual answer and pointed people at an app that is being discontinued. The point worth making is that this is an improvement, not a regression: the old native apps only ran on a phone, so an iPhone owner 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 and no phone is needed at all. - iOS guidance across fxblox-app.md, mainnet-transition/{index,ios, new-installation,existing-testnet}.md now reads "iOS is not supported -- use a computer (Windows, macOS or Linux) with Chrome or Edge", and no longer offers the legacy iOS app as a route. - ios.md: retitled section, "Don't start on the iOS app" caution, and the transition steps now finish on a computer rather than on the iOS app. - Legacy mobile apps section is kept for people who already have the apps installed, with an explicit "don't set up a new Blox with them". - macOS spelled out everywhere alongside Windows and Linux, since an iPhone owner most often has a Mac. - New troubleshooting entry: on macOS, Chrome needs System Settings > Privacy & Security > Bluetooth *and* Local Network, or Web Bluetooth and the LAN path fail silently. Verified with a local docusaurus build (onBrokenLinks: throw) - passes. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01YJyqpFReP1wbz86nsqsoXq
1 parent c1df47b commit 2b3d9f9

7 files changed

Lines changed: 31 additions & 30 deletions

File tree

‎docs/functionyard/fxblox-app.md‎

Lines changed: 8 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -14,10 +14,10 @@ The FxBlox app now runs **in your browser**. There is nothing to install and not
1414
- 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.
1515
:::
1616

17-
:::caution iPhone and iPad
18-
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.
17+
:::caution iOS is not supported — use a computer
18+
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.
1919

20-
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.
20+
**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.)
2121
:::
2222

2323
:::warning
@@ -157,10 +157,12 @@ The Blox reconnects to the network and saves chain history automatically.
157157

158158
## Troubleshooting
159159

160-
- **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.
160+
- **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.
161161
- **"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.
162162
- **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.
163-
- **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.
163+
- **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).
164+
- **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.
165+
- **On Android**, the browser needs the location / nearby-devices permission before it can scan for Bluetooth devices.
164166
- **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.
165167
- **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.
166168
- **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
183185
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.
184186
:::
185187

186-
While they last, the mobile apps are still available:
188+
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.
187189

188190
- Android: [FxBlox on Google Play](https://play.google.com/store/apps/details?id=land.fx.blox) (version 2.0.1 or higher)
189191
- iOS: [FxBlox on the App Store](https://apps.apple.com/ca/app/fxblox/id6444862171) (version 2.0.1 or higher)

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

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -17,7 +17,7 @@ This guide is for users whose FxBlox app shows their Blox as **connected**.
1717

1818
## Step 1: Open the app
1919

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.
20+
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.
2121

2222
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.
2323

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

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -28,7 +28,7 @@ Your FxBlox app shows your Blox as disconnected, or you're having connection iss
2828
→ **[Follow the Blox Disconnected guide](/functionyard/mainnet-transition/android-disconnected)**
2929

3030
:::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.
31+
iOS is not supported — do the transition from a **computer** with Chrome or Edge. See **[iPhone & iPad](/functionyard/mainnet-transition/ios)**.
3232
:::
3333

3434
## Pre-Transition Checklist
@@ -75,7 +75,7 @@ A: The process takes 2-3 hours total, including waiting time for device updates.
7575
A: The transition to mainnet is intended to be permanent. Contact support if you need to revert.
7676

7777
**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).
78+
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).
7979

8080
---
8181

‎docs/functionyard/mainnet-transition/index.md‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -11,7 +11,7 @@ Welcome to the Mainnet Transition guide! This section will help you smoothly tra
1111

1212
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.
1313

14-
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.
14+
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.
1515

1616
:::caution The Android and iOS apps are being discontinued
1717
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:
3333

3434
### Using an iPhone or iPad?
3535

36-
- **[iPhone & iPad](/functionyard/mainnet-transition/ios)** — what to do, since the web app cannot run on iOS
36+
- **[iPhone & iPad](/functionyard/mainnet-transition/ios)** — iOS is not supported; use a computer with Chrome or Edge
3737

3838
## Important Notes
3939

‎docs/functionyard/mainnet-transition/ios.md‎

Lines changed: 15 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -5,29 +5,29 @@ id: ios
55

66
# iPhone & iPad
77

8-
## The web app does not run on iOS
8+
## iOS is not supported — use a computer
99

10-
The FxBlox app now runs in the browser, but **it cannot run on an iPhone or iPad**.
10+
The FxBlox app **does not support iPhone or iPad**.
1111

1212
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.
1313

14-
:::tip What to do instead
15-
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.
16-
2. **Or use an Android phone**, also with Chrome or Edge.
17-
3. **Or keep using the legacy iOS app** for now — see below.
14+
:::tip Use a computer instead
15+
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.
1816

19-
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.
17+
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.)
18+
19+
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.
2020
:::
2121

22-
:::caution The iOS app is being discontinued
23-
[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.
22+
:::caution Don't start on the iOS app
23+
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.
2424
:::
2525

2626
---
2727

28-
# Mainnet Transition on iOS
28+
# Mainnet Transition for iPhone owners
2929

30-
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.
30+
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.
3131

3232
:::warning Critical: Save Your Account ID
3333
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:
8787

8888
After the Blox starts **flashing cyan**:
8989

90-
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.
91-
- 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.
90+
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.
9291
2. Connect the Blox to your internet/WiFi
9392
3. The app should now show **"Connected"**
9493
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
147146
## Troubleshooting
148147

149148
**App Issues:**
150-
- On the web app, reload the tab; if a "new version available" prompt appears, accept it
151-
- On the legacy iOS app, ensure you're using the latest version from the App Store and try force-closing and reopening it
149+
- Reload the tab; if a "new version available" prompt appears, accept it
150+
- If the app shows an "unsupported browser" page, you are on iOS — switch to a computer with Chrome or Edge
152151

153152
**Blox Connection Issues:**
154153
- Verify WiFi credentials are correct
155-
- Ensure the Blox and the device running the app are on the same network
154+
- Ensure the Blox and the computer running the app are on the same network
156155
- Check router settings for device blocking
157156

158157
**Reset Problems:**

‎docs/functionyard/mainnet-transition/new-installation.md‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -23,8 +23,8 @@ This guide is for users who are setting up their Blox device for the **first tim
2323
The full walkthrough, with screenshots, is on the [FxBlox App Setup](/functionyard/fxblox-app) page. The setup process is guided and straightforward.
2424
:::
2525

26-
:::caution iPhone and iPad
27-
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 computer with Chrome or Edge, or an Android phone. See [iPhone & iPad](/functionyard/mainnet-transition/ios).
26+
:::caution iOS is not supported
27+
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).
2828
:::
2929

3030
## Step 2: Skip Testnet

‎docs/getting-started-testnet.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -34,7 +34,7 @@ At a high level, follow these steps to connect your Blox to the network:
3434
![Blox Setup Flow](/img/welcome/getting-started.jpeg)
3535

3636
:::info The FxBlox app runs in your browser
37-
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.
37+
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.
3838
:::
3939

4040
:::info

0 commit comments

Comments
 (0)