You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
Commit 2b3d9f9
Browse filesBrowse the repository at this point in the historyBrowse files
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
Copy file name to clipboardExpand all lines: docs/functionyard/fxblox-app.md
+8-6Lines changed: 8 additions & 6 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -14,10 +14,10 @@ The FxBlox app now runs **in your browser**. There is nothing to install and not
14
14
- 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.
15
15
:::
16
16
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.
19
19
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.)
21
21
:::
22
22
23
23
:::warning
@@ -157,10 +157,12 @@ The Blox reconnects to the network and saves chain history automatically.
157
157
158
158
## Troubleshooting
159
159
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.
161
161
-**"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.
162
162
-**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.
164
166
-**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.
165
167
-**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.
166
168
-**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
183
185
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.
184
186
:::
185
187
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.
187
189
188
190
- Android: [FxBlox on Google Play](https://play.google.com/store/apps/details?id=land.fx.blox) (version 2.0.1 or higher)
189
191
- iOS: [FxBlox on the App Store](https://apps.apple.com/ca/app/fxblox/id6444862171) (version 2.0.1 or higher)
Copy file name to clipboardExpand all lines: docs/functionyard/mainnet-transition/android-connected.md
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -17,7 +17,7 @@ This guide is for users whose FxBlox app shows their Blox as **connected**.
17
17
18
18
## Step 1: Open the app
19
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.
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.
21
21
22
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.
Copy file name to clipboardExpand all lines: docs/functionyard/mainnet-transition/existing-testnet.md
+2-2Lines changed: 2 additions & 2 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -28,7 +28,7 @@ Your FxBlox app shows your Blox as disconnected, or you're having connection iss
28
28
→ **[Follow the Blox Disconnected guide](/functionyard/mainnet-transition/android-disconnected)**
29
29
30
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.
31
+
iOS is not supported — do the transition from a **computer** with Chrome or Edge. See **[iPhone & iPad](/functionyard/mainnet-transition/ios)**.
32
32
:::
33
33
34
34
## Pre-Transition Checklist
@@ -75,7 +75,7 @@ A: The process takes 2-3 hours total, including waiting time for device updates.
75
75
A: The transition to mainnet is intended to be permanent. Contact support if you need to revert.
76
76
77
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).
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).
Copy file name to clipboardExpand all lines: docs/functionyard/mainnet-transition/index.md
+2-2Lines changed: 2 additions & 2 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -11,7 +11,7 @@ Welcome to the Mainnet Transition guide! This section will help you smoothly tra
11
11
12
12
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.
13
13
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.
15
15
16
16
:::caution The Android and iOS apps are being discontinued
17
17
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:
33
33
34
34
### Using an iPhone or iPad?
35
35
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
Copy file name to clipboardExpand all lines: docs/functionyard/mainnet-transition/ios.md
+15-16Lines changed: 15 additions & 16 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -5,29 +5,29 @@ id: ios
5
5
6
6
# iPhone & iPad
7
7
8
-
## The web app does not run on iOS
8
+
## iOS is not supported — use a computer
9
9
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**.
11
11
12
12
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.
13
13
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.
18
16
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.
20
20
:::
21
21
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.
24
24
:::
25
25
26
26
---
27
27
28
-
# Mainnet Transition on iOS
28
+
# Mainnet Transition for iPhone owners
29
29
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.
31
31
32
32
:::warning Critical: Save Your Account ID
33
33
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:
87
87
88
88
After the Blox starts **flashing cyan**:
89
89
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.
92
91
2. Connect the Blox to your internet/WiFi
93
92
3. The app should now show **"Connected"**
94
93
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
147
146
## Troubleshooting
148
147
149
148
**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
152
151
153
152
**Blox Connection Issues:**
154
153
- 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
Copy file name to clipboardExpand all lines: docs/functionyard/mainnet-transition/new-installation.md
+2-2Lines changed: 2 additions & 2 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -23,8 +23,8 @@ This guide is for users who are setting up their Blox device for the **first tim
23
23
The full walkthrough, with screenshots, is on the [FxBlox App Setup](/functionyard/fxblox-app) page. The setup process is guided and straightforward.
24
24
:::
25
25
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 computerwith 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).
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.
0 commit comments