Guide
Install as Web App
Guide to installing Zeity as a web app on various platforms for an enhanced user experience.
Install as Web App
You can install Zeity on your device for a better experience. This guide shows you how to install Zeity on different platforms.
Benefits of Installation
- 🚀 Faster Access: Quick access from your home screen or desktop
- 📴 Offline Support: Continue working without internet connection
- 🔔 Notifications: Receive updates and reminders
- 🖥️ Desktop Experience: Full-screen app experience
Installation on Desktop
Chrome / Edge / Brave (Windows, macOS, Linux)
- Open Zeity in your browser
- Look for the install icon (⊕) in the address bar
- Click the install icon
- Click Install in the popup dialog
Alternatively:
- Click the three-dot menu (⋮) in the top-right corner
- Select "Install Zeity..." or "Apps" → "Install Zeity"
- Confirm the installation
The app will appear in:
- Windows: Start Menu and Desktop
- macOS: Applications folder and Dock
- Linux: Applications menu
Firefox (Windows, macOS, Linux)
Firefox on desktop does not support app installation. Use Chrome, Edge, or Brave instead.
Safari (macOS)
Safari on macOS does not fully support app installation. Use Chrome or Edge for the best experience.
Installation on Mobile
Chrome (Android)
- Open Zeity in Chrome on your Android device
- Tap the three-dot menu (⋮) in the top-right corner
- Select "Add to Home screen" or "Install app"
- Enter a name for the app (or keep "Zeity")
- Tap Add or Install
The Zeity icon will appear on your home screen.
Samsung Internet (Android)
- Open Zeity in Samsung Internet
- Tap the menu icon (three lines) at the bottom
- Select "Add page to"
- Choose "Home screen"
- Tap Add
Safari (iOS/iPadOS)
- Open Zeity in Safari on your iPhone or iPad
- Tap the Share button (square with arrow pointing up)
- Scroll down and tap "Add to Home Screen"
- Edit the name if desired
- Tap Add in the top-right corner
The Zeity icon will appear on your home screen.
On iOS, only Safari supports PWA installation. Chrome and other browsers on iOS cannot install PWAs.
Launching the Installed App
Once installed, you can launch Zeity like any other app:
- Desktop: Click the Zeity icon in your applications menu, Start menu, or Dock
- Mobile: Tap the Zeity icon on your home screen
The app will open in standalone mode without browser UI elements.
Features Available in PWA Mode
Faster Performance
Optimized loading and caching for instant access
Offline Access
Continue tracking time even without internet
Notifications
Receive reminders and updates (when enabled)
Native Feel
Full-screen experience without browser controls
Uninstalling the PWA
Desktop
Chrome / Edge / Brave:
- Open the installed Zeity app
- Click the three-dot menu (⋮) in the top-right
- Select "Uninstall Zeity..."
- Confirm the uninstallation
Alternatively, right-click the app icon and select Uninstall.
Mobile
Android:
- Long-press the Zeity icon on your home screen
- Drag to "Uninstall" or tap "App info" → "Uninstall"
iOS/iPadOS:
- Long-press the Zeity icon on your home screen
- Tap "Remove App"
- Select "Delete App" and confirm
Updating the PWA
PWAs update automatically in the background. When you launch the app:
- The latest version downloads automatically
- You'll see a notification when an update is available
- Refresh or restart the app to use the new version
No manual updates required! Zeity updates seamlessly like a web app while giving you the benefits of a native app.
Troubleshooting
Install Button Not Appearing
Check requirements:
- Using a supported browser (Chrome, Edge, Brave on desktop)
- HTTPS connection is required
- Service worker is registered correctly
- Site is not already installed
Try:
- Clear browser cache and reload
- Check browser console for errors
- Use browser menu instead of install button
PWA Not Working Offline
Verify:
- You've opened the app at least once while online
- Service worker is registered and active
- Visit
chrome://serviceworker-internals/(Chrome) to check status
Fix:
- Reload the app while online
- Clear cache and re-register service worker
- Reinstall the PWA
App Icon Not Updating
After reinstalling or updating:
- Clear browser cache
- Uninstall and reinstall the PWA
- Check manifest.json is loading correctly