App Features
Error Screen
Customize the native fallback shown when the main website frame cannot load and provide a retry action.
Before you start
- User-friendly offline copy
- Theme colors with accessible contrast
Configure and verify
Write the message
Use concise copy that explains the page could not load and that the user can retry.
Style both themes
Set background, message, retry text, and retry button colors for light and dark modes.
Save and rebuild
The native fallback is compiled into the shell and requires a new build.
Test offline behavior
Launch or navigate with airplane mode enabled, confirm the screen appears, restore connectivity, and choose Retry.
Test server failures
Also test DNS failure, invalid host, and a server error that prevents main-frame loading.
Scope
The native error screen responds to main-frame WebView failures. Website-rendered HTTP error pages can still display their own content.
Loading-state cleanup
Main-frame errors also clear the loading indicator and pull-to-refresh indicators.
Test before release
- Message is clear
- Retry has contrast
- Connectivity recovery works
- Loading overlays are cleared