# Desktop Offline Mode {#desktop-offline-mode}


Track time offline and sync when connectivity returns.


## How Offline Mode Works {#how-offline-mode-works}


1. Desktop app detects loss of API connectivity
2. Timer continues running locally
3. Time entries, screenshots, and activity data are stored locally
4. When connection restores, data syncs automatically





```mermaid
stateDiagram-v2
    [*] --> Online: Connected
    Online --> Offline: Connection lost
    Offline --> Syncing: Connection restored
    Syncing --> Online: Sync complete
    Online --> [*]: App closed
```






## Local Storage {#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 {#whats-stored-offline}


| Data            | Stored | Synced on Reconnect |
| --------------- | ------ | ------------------- |
| Time entries    | ✅     | ✅                  |
| Screenshots     | ✅     | ✅                  |
| Activity levels | ✅     | ✅                  |
| Task selection  | ✅     | ✅                  |
| Project changes | ❌     | ❌                  |


## Sync Process {#sync-process}


When connectivity returns:

1. Queue processor starts
2. Oldest entries synced first
3. Progress indicator shown
4. Conflicts resolved (server wins)
5. Local queue cleared


## Limitations {#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 {#related-pages}


- [Desktop Timer](https://sourcey-gauzy.pages.dev/desktop/desktop-timer/index.md) — timer features
- [Desktop Troubleshooting](https://sourcey-gauzy.pages.dev/troubleshooting/desktop-app-issues/index.md) — issues