# cattr-app/desktop-application architecture

> Architecture diagram of the GitHub repository cattr-app/desktop-application, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-05). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/cattr-app/desktop-application
- Repository: https://github.com/cattr-app/desktop-application

## Overview

Cattr Desktop is an Electron time-tracking client. Users authenticate, select tasks and track time; the main process records intervals locally and supports offline operation and later synchronization with Cattr. The map separates the Vue workflow, IPC routing, domain controllers, tracking/OS integration and persistence. The excerpts establish only selected call paths; other documented capabilities are shown without speculative connections.

Main entry points: [`app/src/base/task-tracker.js`](https://github.com/cattr-app/desktop-application/blob/main/app/src/base/task-tracker.js) (Tracking engine), [`app/src/models/index.js`](https://github.com/cattr-app/desktop-application/blob/main/app/src/models/index.js) (SQLite database), [`app/src/routes/tasks.js`](https://github.com/cattr-app/desktop-application/blob/main/app/src/routes/tasks.js) (Task routes), [`app/src/controller/tasks.js`](https://github.com/cattr-app/desktop-application/blob/main/app/src/controller/tasks.js) (Task controller)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_renderer["Desktop interface"]
  node_renderer_entry["Renderer bootstrap<br/>[app.js]"]
  node_app_shell["App shell<br/>[App.vue]"]
  node_login["Login<br/>[Login.vue]"]
  node_user_view["User workspace<br/>[User.vue]"]
  node_task_tracker_ui["Tracking controls<br/>[Tracker.vue]"]
  node_task_pages["Task management<br/>[List.vue]"]
  node_offline_sync_ui["Offline sync<br/>[OfflineSync.vue]"]
  node_settings_ui["User settings<br/>[Settings.vue]"]
end

subgraph group_main["Electron and IPC"]
  node_electron["Electron app<br/>[app.js]"]
  node_ipc_routes["IPC routes<br/>[index.js]"]
  node_task_routes["Task routes<br/>[tasks.js]"]
  node_auth_routes["Authentication routes<br/>[authentication.js]"]
end

subgraph group_domain["Tracking domain"]
  node_auth["Authentication<br/>[authentication.js]"]
  node_task_controller["Task controller<br/>[tasks.js]"]
  node_time_controller["Time controller<br/>[time.js]"]
  node_interval_controller["Interval controller<br/>[time-intervals.js]"]
  node_tracker["Tracking engine<br/>[task-tracker.js]"]
  node_tracking_features["Tracking features"]
  node_offline_mode["Offline mode<br/>[offline-mode.js]"]
  node_os_integration["OS integration<br/>[os-integration.js]"]
  node_preferences["User preferences"]
  node_api["Cattr API client<br/>[api.js]"]
  node_screenshots["Screenshot capture<br/>[screenshot.js]"]
end

subgraph group_persistence["Local persistence"]
  node_models["Data models<br/>[task.js]"]
  node_database[("SQLite database<br/>[index.js]")]
end

node_user(("Desktop user"))
node_backend["Cattr service"]

node_user -->|"uses"| node_renderer_entry
node_renderer_entry -->|"mounts"| node_app_shell
node_app_shell -->|"routes to"| node_login
node_app_shell -->|"routes to"| node_user_view
node_user_view -->|"renders"| node_task_tracker_ui
node_app_shell -->|"captures via"| node_screenshots
node_electron -->|"initializes"| node_database
node_electron -->|"configures"| node_ipc_routes
node_electron -->|"loads"| node_os_integration
node_ipc_routes -.->|"registers"| node_task_routes
node_task_routes -->|"calls"| node_task_controller
node_task_routes -->|"calls"| node_time_controller
node_task_routes -->|"uses"| node_tracker
node_task_routes -->|"reads"| node_preferences
node_auth_routes -->|"calls"| node_auth
node_auth -->|"requests"| node_api
node_auth -->|"uses"| node_offline_mode
node_auth -->|"uses"| node_tracking_features
node_task_controller -->|"requests"| node_api
node_task_controller -->|"queries"| node_database
node_time_controller -->|"uses"| node_task_controller
node_time_controller -->|"queries"| node_database
node_interval_controller -->|"requests"| node_api
node_interval_controller -->|"queries"| node_database
node_tracker -->|"uses"| node_task_controller
node_tracker -->|"uses"| node_time_controller
node_tracker -->|"uses"| node_interval_controller
node_tracker -->|"checks"| node_offline_mode
node_tracker -->|"checks"| node_tracking_features
node_tracker -->|"captures"| node_screenshots
node_os_integration -->|"uses"| node_tracker
node_os_integration -->|"reads"| node_preferences
node_tracking_features -->|"queries"| node_database
node_database -->|"loads"| node_models
node_api -.->|"communicates"| node_backend
node_offline_sync_ui -.->|"sync requests"| node_interval_controller
node_settings_ui -.->|"updates"| node_preferences

click node_electron "https://github.com/cattr-app/desktop-application/blob/main/app/src/app.js"
click node_renderer_entry "https://github.com/cattr-app/desktop-application/blob/main/app/renderer/js/app.js"
click node_app_shell "https://github.com/cattr-app/desktop-application/blob/main/app/renderer/js/components/App.vue"
click node_login "https://github.com/cattr-app/desktop-application/blob/main/app/renderer/js/components/auth/Login.vue"
click node_user_view "https://github.com/cattr-app/desktop-application/blob/main/app/renderer/js/components/user/User.vue"
click node_task_tracker_ui "https://github.com/cattr-app/desktop-application/blob/main/app/renderer/js/components/user/tasks/Tracker.vue"
click node_task_pages "https://github.com/cattr-app/desktop-application/blob/main/app/renderer/js/components/user/tasks/List.vue"
click node_offline_sync_ui "https://github.com/cattr-app/desktop-application/blob/main/app/renderer/js/components/user/pages/OfflineSync.vue"
click node_settings_ui "https://github.com/cattr-app/desktop-application/blob/main/app/renderer/js/components/user/pages/Settings.vue"
click node_ipc_routes "https://github.com/cattr-app/desktop-application/blob/main/app/src/routes/index.js"
click node_task_routes "https://github.com/cattr-app/desktop-application/blob/main/app/src/routes/tasks.js"
click node_auth_routes "https://github.com/cattr-app/desktop-application/blob/main/app/src/routes/authentication.js"
click node_auth "https://github.com/cattr-app/desktop-application/blob/main/app/src/base/authentication.js"
click node_task_controller "https://github.com/cattr-app/desktop-application/blob/main/app/src/controller/tasks.js"
click node_time_controller "https://github.com/cattr-app/desktop-application/blob/main/app/src/controller/time.js"
click node_interval_controller "https://github.com/cattr-app/desktop-application/blob/main/app/src/controller/time-intervals.js"
click node_tracker "https://github.com/cattr-app/desktop-application/blob/main/app/src/base/task-tracker.js"
click node_tracking_features "https://github.com/cattr-app/desktop-application/blob/main/app/src/controller/tracking-features.js"
click node_offline_mode "https://github.com/cattr-app/desktop-application/blob/main/app/src/base/offline-mode.js"
click node_os_integration "https://github.com/cattr-app/desktop-application/blob/main/app/src/base/os-integration.js"
click node_preferences "https://github.com/cattr-app/desktop-application/blob/main/app/src/base/user-preferences.js"
click node_api "https://github.com/cattr-app/desktop-application/blob/main/app/src/base/api.js"
click node_models "https://github.com/cattr-app/desktop-application/blob/main/app/src/models/task.js"
click node_database "https://github.com/cattr-app/desktop-application/blob/main/app/src/models/index.js"
click node_screenshots "https://github.com/cattr-app/desktop-application/blob/main/app/src/utils/screenshot.js"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_renderer_entry,node_app_shell,node_login,node_user_view,node_task_tracker_ui,node_task_pages,node_offline_sync_ui,node_settings_ui,node_user toneBlue
class node_electron,node_ipc_routes,node_task_routes,node_auth_routes toneAmber
class node_auth,node_task_controller,node_time_controller,node_interval_controller,node_tracker,node_tracking_features,node_offline_mode,node_os_integration,node_preferences,node_api,node_screenshots toneMint
class node_models,node_database toneRose
class node_backend toneIndigo
```

## Components

### Desktop interface

- [Renderer bootstrap](https://github.com/cattr-app/desktop-application/blob/main/app/renderer/js/app.js): `app/renderer/js/app.js`
- [App shell](https://github.com/cattr-app/desktop-application/blob/main/app/renderer/js/components/App.vue): `app/renderer/js/components/App.vue`
- [Login](https://github.com/cattr-app/desktop-application/blob/main/app/renderer/js/components/auth/Login.vue): `app/renderer/js/components/auth/Login.vue`
- [User workspace](https://github.com/cattr-app/desktop-application/blob/main/app/renderer/js/components/user/User.vue): `app/renderer/js/components/user/User.vue`
- [Tracking controls](https://github.com/cattr-app/desktop-application/blob/main/app/renderer/js/components/user/tasks/Tracker.vue): `app/renderer/js/components/user/tasks/Tracker.vue`
- [Task management](https://github.com/cattr-app/desktop-application/blob/main/app/renderer/js/components/user/tasks/List.vue): `app/renderer/js/components/user/tasks/List.vue`
- [Offline sync](https://github.com/cattr-app/desktop-application/blob/main/app/renderer/js/components/user/pages/OfflineSync.vue): `app/renderer/js/components/user/pages/OfflineSync.vue`
- [User settings](https://github.com/cattr-app/desktop-application/blob/main/app/renderer/js/components/user/pages/Settings.vue): `app/renderer/js/components/user/pages/Settings.vue`

### Electron and IPC

- [Electron app](https://github.com/cattr-app/desktop-application/blob/main/app/src/app.js): `app/src/app.js`
- [IPC routes](https://github.com/cattr-app/desktop-application/blob/main/app/src/routes/index.js): `app/src/routes/index.js`
- [Task routes](https://github.com/cattr-app/desktop-application/blob/main/app/src/routes/tasks.js): `app/src/routes/tasks.js`
- [Authentication routes](https://github.com/cattr-app/desktop-application/blob/main/app/src/routes/authentication.js): `app/src/routes/authentication.js`

### Tracking domain

- [Authentication](https://github.com/cattr-app/desktop-application/blob/main/app/src/base/authentication.js): `app/src/base/authentication.js`
- [Task controller](https://github.com/cattr-app/desktop-application/blob/main/app/src/controller/tasks.js): `app/src/controller/tasks.js`
- [Time controller](https://github.com/cattr-app/desktop-application/blob/main/app/src/controller/time.js): `app/src/controller/time.js`
- [Interval controller](https://github.com/cattr-app/desktop-application/blob/main/app/src/controller/time-intervals.js): `app/src/controller/time-intervals.js`
- [Tracking engine](https://github.com/cattr-app/desktop-application/blob/main/app/src/base/task-tracker.js): `app/src/base/task-tracker.js`
- [Tracking features](https://github.com/cattr-app/desktop-application/blob/main/app/src/controller/tracking-features.js): `app/src/controller/tracking-features.js`
- [Offline mode](https://github.com/cattr-app/desktop-application/blob/main/app/src/base/offline-mode.js): `app/src/base/offline-mode.js`
- [OS integration](https://github.com/cattr-app/desktop-application/blob/main/app/src/base/os-integration.js): `app/src/base/os-integration.js`
- [User preferences](https://github.com/cattr-app/desktop-application/blob/main/app/src/base/user-preferences.js): `app/src/base/user-preferences.js`
- [Cattr API client](https://github.com/cattr-app/desktop-application/blob/main/app/src/base/api.js): `app/src/base/api.js`
- [Screenshot capture](https://github.com/cattr-app/desktop-application/blob/main/app/src/utils/screenshot.js): `app/src/utils/screenshot.js`

### Local persistence

- [Data models](https://github.com/cattr-app/desktop-application/blob/main/app/src/models/task.js): `app/src/models/task.js`
- [SQLite database](https://github.com/cattr-app/desktop-application/blob/main/app/src/models/index.js): `app/src/models/index.js`

### Other components

- **Desktop user**
- **Cattr service**

## Connections

- Desktop user → Renderer bootstrap: uses (evidence: `README.md`)
- Renderer bootstrap → App shell: mounts (evidence: `app/renderer/js/app.js`)
- App shell → Login: routes to
- App shell → User workspace: routes to
- User workspace → Tracking controls: renders (evidence: `app/renderer/js/components/user/User.vue`)
- App shell → Screenshot capture: captures via (evidence: `app/renderer/js/components/App.vue`)
- Electron app → SQLite database: initializes (evidence: `app/src/app.js`)
- Electron app → IPC routes: configures (evidence: `app/src/app.js`)
- Electron app → OS integration: loads (evidence: `app/src/app.js`)
- IPC routes → Task routes: registers
- Task routes → Task controller: calls (evidence: `app/src/routes/tasks.js`)
- Task routes → Time controller: calls (evidence: `app/src/routes/tasks.js`)
- Task routes → Tracking engine: uses (evidence: `app/src/routes/tasks.js`)
- Task routes → User preferences: reads (evidence: `app/src/routes/tasks.js`)
- Authentication routes → Authentication: calls (evidence: `app/src/routes/authentication.js`)
- Authentication → Cattr API client: requests (evidence: `app/src/base/authentication.js`)
- Authentication → Offline mode: uses (evidence: `app/src/base/authentication.js`)
- Authentication → Tracking features: uses (evidence: `app/src/base/authentication.js`)
- Task controller → Cattr API client: requests (evidence: `app/src/controller/tasks.js`)
- Task controller → SQLite database: queries (evidence: `app/src/controller/tasks.js`)
- Time controller → Task controller: uses (evidence: `app/src/controller/time.js`)
- Time controller → SQLite database: queries (evidence: `app/src/controller/time.js`)
- Interval controller → Cattr API client: requests (evidence: `app/src/controller/time-intervals.js`)
- Interval controller → SQLite database: queries (evidence: `app/src/controller/time-intervals.js`)
- Tracking engine → Task controller: uses (evidence: `app/src/base/task-tracker.js`)
- Tracking engine → Time controller: uses (evidence: `app/src/base/task-tracker.js`)
- Tracking engine → Interval controller: uses (evidence: `app/src/base/task-tracker.js`)
- Tracking engine → Offline mode: checks (evidence: `app/src/base/task-tracker.js`)
- Tracking engine → Tracking features: checks (evidence: `app/src/base/task-tracker.js`)
- Tracking engine → Screenshot capture: captures (evidence: `app/src/base/task-tracker.js`)
- OS integration → Tracking engine: uses (evidence: `app/src/base/os-integration.js`)
- OS integration → User preferences: reads (evidence: `app/src/base/os-integration.js`)
- Tracking features → SQLite database: queries (evidence: `app/src/controller/tracking-features.js`)
- SQLite database → Data models: loads (evidence: `app/src/models/index.js`)
- Cattr API client → Cattr service: communicates
- Offline sync → Interval controller: sync requests
- User settings → User preferences: updates
