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