iOS - Avalonia GUI (native preview): report bugs and feedback here

[laqieer]

The native iOS / iPadOS build of the cross-platform Avalonia GUI has just landed as an experimental preview (#1859), the iOS counterpart of the Android head. This thread is the place to report bugs and share feedback.

What it is

A native iOS app (FEBuilderGBA.iOS) that reuses the same shared Avalonia editor UI + single-view shell + first-run config/ extraction as the Android head - the runtime seams are platform-agnostic and shared. CI builds it on macOS (Xcode 26.5) and produces an unsigned .ipa.

Preview status: the app builds and its config bundling is verified in CI, but the on-device runtime (touch UX, file pickers, and iOS's AOT/trim execution - mitigated with the Mono interpreter) is not yet validated. Expect rough edges.

How to install (important)

The CI/release .ipa is unsigned (no Apple Developer signing on this project), so it is NOT directly installable on a stock device. To run it you must re-sign it with your own Apple ID using a sideloading tool:

• AltStore or Sideloadly (re-sign with your Apple ID), or Apple Configurator.
• Download FEBuilderGBA-ios-unsigned-ipa.zip from the latest release (attached when the macOS build succeeds - it is a soft/advisory asset), unzip to get the .ipa, then sideload it.
• Known limitation: like Android, config/patch2 and the FE-Repo resources are not bundled on iOS.

How to report a bug (reply below)

Please include:

• Device + iOS/iPadOS version (e.g. iPhone 15, iOS 26.2)
• How you installed (AltStore / Sideloadly / Apple Configurator) + the ver_* release
• ROM version if relevant (FE6 / FE7J / FE7U / FE8J / FE8U)
• Steps to reproduce, expected vs actual, and a screenshot / screen recording
• If it crashed on launch, note whether config extraction or the first editor was involved

Background + design details: docs/IOS.md. Thanks for helping validate the iOS preview on real devices!

---

Copilot CLI: 1.0.69-1
Model: Claude Opus 4.8 (claude-opus-4.8)