What is a PWA?
A Progressive Web App (PWA) is a web application that can be installed on your device and works like a native app:Home Screen Icon
Launch HAPI like any other app from your home screen
Full Screen Mode
No browser chrome, immersive experience
Offline Support
Basic functionality works without internet
Auto-Updates
Always get the latest version automatically
Installing HAPI PWA
Android (Chrome/Edge)
iOS (Safari)
Desktop (Chrome/Edge)
PWA Features
Offline Mode
When offline, HAPI can:- Display cached session lists
- Show previously loaded messages
- Queue actions for when you’re back online
You must load the app at least once online to enable offline functionality.
Auto-Update
HAPI automatically checks for updates:- Updates are checked hourly in the background
- When a new version is available, you’ll see a prompt
- Click “Reload” to get the latest version
Background Sync
Actions taken offline are synced when reconnected:- Pending messages are sent
- Permission decisions are relayed
- Session state is refreshed
Caching Strategy
HAPI uses intelligent caching for optimal performance:| Content | Strategy | Duration |
|---|---|---|
| App shell | Cache first | Until update |
| Sessions API | Network first | 5 minutes |
| Machines API | Network first | 10 minutes |
| Static assets | Cache first | Forever |
Push Notifications
HAPI supports push notifications to alert you when agents need attention.Enable Notifications
Notification Types
Permission Request
Agent needs your approval for a tool or file operation
Session Ready
Agent finished a task and awaits your input
Managing Your PWA
Check Install Status
HAPI shows different UI based on install status:- Not installed - Shows install prompt
- Installing - Shows progress indicator
- Installed - No prompt shown
Uninstalling
- Android
- iOS
- Desktop
- Long-press the HAPI icon
- Drag to “Uninstall” or tap the X
Clearing Cache
If you experience issues:Best Practices
Battery Optimization (Android)
On Android, disable battery optimization for HAPI to ensure:- Background sync works reliably
- Notifications arrive promptly
Data Usage
HAPI uses minimal data:- Initial load: ~500KB
- Cached after first load
- Only syncs changed data
Multiple Devices
You can install HAPI on multiple devices:- All devices use the same hub server
- Sessions sync across devices
- Same access token works everywhere
Browser Compatibility
| Browser | Platform | Support |
|---|---|---|
| Chrome | Android | ✅ Full support |
| Edge | Android | ✅ Full support |
| Safari | iOS | ⚠️ Limited (no background sync) |
| Chrome | Desktop | ✅ Full support |
| Edge | Desktop | ✅ Full support |
| Firefox | All | ⚠️ Partial (no install prompt) |
Troubleshooting
Install Button Not Showing
Install Button Not Showing
App Not Updating
App Not Updating
- Close the app completely
- Reopen and wait for update prompt
- If stuck, clear cache and reinstall
Offline Mode Not Working
Offline Mode Not Working
- Ensure you’ve loaded the app at least once online
- Check if ServiceWorker is registered (DevTools → Application)
- Clear cache and reload
iOS-Specific Issues
iOS-Specific Issues
- Must use Safari for installation
- No background sync on iOS (technical limitation)
- Limited offline capabilities compared to Android
- No push notifications (use Telegram instead)
Notifications Not Arriving
Notifications Not Arriving
- Check browser notification permissions
- Disable battery optimization (Android)
- Verify VAPID configuration on hub
- Consider using Telegram as fallback
Telegram Mini App Alternative
If PWA doesn’t suit your needs, consider the Telegram Mini App:Works Inside Telegram
No separate installation required
Same Features
Identical functionality to PWA
Integrated Notifications
Uses Telegram’s notification system
Better iOS Support
No Safari limitations
Related Features
Remote Control
Switch between local and remote modes
Telegram
Alternative mobile experience
Permissions
Approve agent actions on the go