Check compatibility
Confirm the iOS version before signing anything.
- iOS / iPadOS 26.0 – 26.6.2: wallpaper and customization features work, but MobileGestalt tweaks do not.
- iOS / iPadOS 27.0 – 27.2.1: full feature set.
- iOS 27.3 beta 1 (24C5037i): supported by the project.
- Any other version is unsupported. Do not ask for extended support.
Version check
Open Settings → General → About and read the software version. If it is not listed above, stop here.
Back up your iPhone
Erosion touches system data and the project warns data loss is possible.
- Make a full iCloud backup, or connect to Finder / iTunes and create a local backup.
- Confirm the backup finished before installing anything.
- Keep the device unlocked and trusted during setup.
Sign the IPA
A certificate works, but App Group signing is the fragile part.
Erosion needs the App Group entitlement to reach its container. The upstream release notes say paid or enterprise certificates may sign App Groups incorrectly, so a certificate is not always the most reliable option.
- Certificate path: sign the IPA with a profile that includes App Groups, install it, and trust the developer profile.
- If App Group signing fails with a paid certificate, re-sign with SideStore or Impactor using your own Apple ID.
- Do not install with a different bundle identifier — the app depends on its original App Group.
App Group alert
On launch, Erosion checks its custom App Group ID. If it falls back to the default and shows an alert, tweaks will not work — re-sign with a valid App Group profile.
Install and trust the app
Finish the install and let iOS trust the signer.
- Install the signed IPA with your signing tool.
- Open Settings → General → VPN & Device Management and trust the developer profile.
- Enable Developer Mode and restart if iOS asks for it.
- Open Erosion from the Home Screen.
First launch
The first run prepares container access and can look frozen.
Opening Custom Wallpapers or Dialer Themer for the first time starts app-container detection. It takes about 30 seconds, shows a progress indicator in current builds, and only runs once.
- Keep the app open while the first detection finishes.
- If the App Group alert appears, stop and re-sign instead of continuing.
- Do not force-quit during the initial container scan.
Import a wallpaper
Use the on-device library or import a .tendies package.
- Open the Custom Wallpapers section.
- Choose a .tendies file downloaded from this site, or pick one from the in-app library.
- Apply the wallpaper and wait for the respring to finish.
- Open the lock-screen wallpaper editor and select the new wallpaper from Favorites.
Dialer themes
The same container access powers Dialer Themer. Set a theme only after the first container detection has completed.
Apply and respring
Applying writes the wallpaper descriptor and restarts the UI.
- Wait for Erosion to report success before closing it.
- If the wallpaper does not appear, run Reset Collections and apply again.
- Reboot the phone if the respring does not complete.
Explore tweaks carefully
Change one group at a time so you can revert it.
- Supported status bar and SpringBoard options work on iOS 27; iOS 26 has fewer options.
- MobileGestalt tweaks remain unavailable on iOS 26.
- Apply one change, verify it, then continue — this keeps rollback simple.
Troubleshoot common errors
Match the symptom to the fix before reinstalling.
- App Group alert or tweaks do nothing: re-sign with SideStore / Impactor using your own Apple ID.
- Wallpaper missing from Favorites: run Reset Collections, re-import, apply, and respring.
- App hangs on Custom Wallpapers: wait about 30 seconds for the first container scan.
- App will not install: confirm the iOS version is supported and the signing profile is valid.
- Boot loop or unexpected data loss: restore the backup from step 2 and stop applying changes.
Frequently asked questions
iOS / iPadOS 26.0 – 26.6.2 with limited functionality, 27.0 – 27.2.1, and iOS 27.3 beta 1 (24C5037i). Unlisted versions are not supported.
worse_query cannot write to MobileGestalt on iOS 26. Wallpaper, dialer, and the other customization features still work.
A certificate can work, but the upstream release notes warn that paid or enterprise certificates may break App Groups. If tweaks fail or the app shows the App Group alert, re-sign with SideStore, Impactor, or another tool using your own Apple ID.
The first container detection takes about 30 seconds and only runs once. Waiting is expected; force-quitting restarts it.
No. It uses the worse_query sandbox escape and does not install a persistent jailbreak, bootstrap, or daemon.
