Desktop Offline Mode
Track time offline and sync when connectivity returns.
How Offline Mode Works
- Desktop app detects loss of API connectivity
- Timer continues running locally
- Time entries, screenshots, and activity data are stored locally
- When connection restores, data syncs automatically
Local Storage
During offline mode, data is stored in:
| Platform | Location |
|---|---|
| Windows | %APPDATA%/gauzy-desktop/queue/ |
| macOS | ~/Library/Application Support/gauzy-desktop/queue/ |
| Linux | ~/.config/gauzy-desktop/queue/ |
What's Stored Offline
| Data | Stored | Synced on Reconnect |
|---|---|---|
| Time entries | ✅ | ✅ |
| Screenshots | ✅ | ✅ |
| Activity levels | ✅ | ✅ |
| Task selection | ✅ | ✅ |
| Project changes | ❌ | ❌ |
Sync Process
When connectivity returns:
- Queue processor starts
- Oldest entries synced first
- Progress indicator shown
- Conflicts resolved (server wins)
- Local queue cleared
Limitations
- Cannot create new tasks/projects offline
- Cannot view team data offline
- Maximum offline duration: configurable (default 24 hours)
- Screenshot uploads may be slow on large queues
Related Pages
- Desktop Timer — timer features
- Desktop Troubleshooting — issues