# raktim-yoddha/taskmaster architecture

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

- Interactive diagram: https://gitdiagram.com/raktim-yoddha/taskmaster
- Repository: https://github.com/raktim-yoddha/taskmaster

## Overview

This is a Tauri desktop to-do and focus-timer app: the main window manages tasks, history, notes, settings, and timer modes, while a sticky widget provides a compact companion view. The React UI invokes Rust commands for shared overlay state, which is persisted and broadcast across windows; timer state is synchronized separately through events. The README is only a generic Tauri template and documents no product capabilities. Rust storage and several frontend integrations were not excerpted, so uncertain relationships are omitted.

Main entry points: [`src/components/AppDashboard.tsx`](https://github.com/raktim-yoddha/taskmaster/blob/master/src/components/AppDashboard.tsx) (Task Dashboard), [`src-tauri/src/lib.rs`](https://github.com/raktim-yoddha/taskmaster/blob/master/src-tauri/src/lib.rs) (Tauri Commands), [`src/App.tsx`](https://github.com/raktim-yoddha/taskmaster/blob/master/src/App.tsx) (Window App), [`src/components/SettingsModal.tsx`](https://github.com/raktim-yoddha/taskmaster/blob/master/src/components/SettingsModal.tsx) (Settings)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Desktop UI"]
  node_entry["React Entry<br/>[main.tsx]"]
  node_app["Window App<br/>[App.tsx]"]
  node_dashboard["Task Dashboard<br/>[AppDashboard.tsx]"]
  node_widget["Sticky Widget<br/>[StickyWidget.tsx]"]
  node_settings["Settings<br/>[SettingsModal.tsx]"]
  node_appearance["Appearance Settings"]
  node_select["Themed Select<br/>[ThemedSelect.tsx]"]
  node_segments["Segmented Control"]
end

subgraph group_domain["Focus and Planning"]
  node_timer["Timer Controls<br/>[FocusTimer.tsx]"]
  node_timerhook["Timer Engine<br/>[useTimer.ts]"]
  node_sound["Timer Sounds<br/>[sound.ts]"]
  node_history["Task History<br/>[HistoryView.tsx]"]
  node_notes["Notes<br/>[NotesView.tsx]"]
  node_types["Shared Models<br/>[types.ts]"]
end

subgraph group_native["Native State"]
  node_backend["Tauri Commands<br/>[lib.rs]"]
  node_models["Rust Models<br/>[models.rs]"]
  node_store[("State Store<br/>[store.rs]")]
end

subgraph group_updates["App Updates"]
  node_updater["Update Service<br/>[updater.ts]"]
  node_updateui["Update Dialog"]
end

node_user(("User"))
node_github["GitHub Releases"]

node_user -->|"opens app"| node_entry
node_entry -->|"renders"| node_app
node_app -->|"creates timer"| node_timerhook
node_app -->|"renders"| node_dashboard
node_dashboard -->|"opens widget"| node_widget
node_dashboard -->|"renders"| node_history
node_dashboard -->|"renders"| node_notes
node_dashboard -->|"renders"| node_timer
node_dashboard -->|"renders"| node_settings
node_dashboard -->|"checks updates"| node_updater
node_dashboard -->|"shows dialog"| node_updateui
node_settings -.->|"renders"| node_appearance
node_settings -->|"uses"| node_select
node_settings -->|"uses"| node_segments
node_appearance -->|"uses"| node_select
node_timer -.->|"uses"| node_timerhook
node_widget -->|"uses"| node_timerhook
node_timerhook -->|"plays sounds"| node_sound
node_app -->|"invokes commands"| node_backend
node_widget -->|"invokes commands"| node_backend
node_backend -->|"persists state"| node_store
node_backend -->|"uses models"| node_models
node_updater -->|"fetches releases"| node_github
node_updater -->|"requests update"| node_backend

click node_entry "https://github.com/raktim-yoddha/taskmaster/blob/master/src/main.tsx"
click node_app "https://github.com/raktim-yoddha/taskmaster/blob/master/src/App.tsx"
click node_dashboard "https://github.com/raktim-yoddha/taskmaster/blob/master/src/components/AppDashboard.tsx"
click node_widget "https://github.com/raktim-yoddha/taskmaster/blob/master/src/components/StickyWidget.tsx"
click node_settings "https://github.com/raktim-yoddha/taskmaster/blob/master/src/components/SettingsModal.tsx"
click node_appearance "https://github.com/raktim-yoddha/taskmaster/blob/master/src/components/AppearanceSettings.tsx"
click node_select "https://github.com/raktim-yoddha/taskmaster/blob/master/src/components/ThemedSelect.tsx"
click node_segments "https://github.com/raktim-yoddha/taskmaster/blob/master/src/components/SegmentedControl.tsx"
click node_timer "https://github.com/raktim-yoddha/taskmaster/blob/master/src/components/FocusTimer.tsx"
click node_timerhook "https://github.com/raktim-yoddha/taskmaster/blob/master/src/hooks/useTimer.ts"
click node_sound "https://github.com/raktim-yoddha/taskmaster/blob/master/src/utils/sound.ts"
click node_history "https://github.com/raktim-yoddha/taskmaster/blob/master/src/components/HistoryView.tsx"
click node_notes "https://github.com/raktim-yoddha/taskmaster/blob/master/src/components/NotesView.tsx"
click node_types "https://github.com/raktim-yoddha/taskmaster/blob/master/src/types.ts"
click node_backend "https://github.com/raktim-yoddha/taskmaster/blob/master/src-tauri/src/lib.rs"
click node_models "https://github.com/raktim-yoddha/taskmaster/blob/master/src-tauri/src/models.rs"
click node_store "https://github.com/raktim-yoddha/taskmaster/blob/master/src-tauri/src/store.rs"
click node_updater "https://github.com/raktim-yoddha/taskmaster/blob/master/src/utils/updater.ts"
click node_updateui "https://github.com/raktim-yoddha/taskmaster/blob/master/src/components/UpdateNotificationModal.tsx"

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_entry,node_app,node_dashboard,node_widget,node_settings,node_appearance,node_select,node_segments,node_user toneBlue
class node_timer,node_timerhook,node_sound,node_history,node_notes,node_types toneAmber
class node_backend,node_models,node_store toneMint
class node_updater,node_updateui toneRose
class node_github toneIndigo
```

## Components

### Desktop UI

- [React Entry](https://github.com/raktim-yoddha/taskmaster/blob/master/src/main.tsx): `src/main.tsx`
- [Window App](https://github.com/raktim-yoddha/taskmaster/blob/master/src/App.tsx): `src/App.tsx`
- [Task Dashboard](https://github.com/raktim-yoddha/taskmaster/blob/master/src/components/AppDashboard.tsx): `src/components/AppDashboard.tsx`
- [Sticky Widget](https://github.com/raktim-yoddha/taskmaster/blob/master/src/components/StickyWidget.tsx): `src/components/StickyWidget.tsx`
- [Settings](https://github.com/raktim-yoddha/taskmaster/blob/master/src/components/SettingsModal.tsx): `src/components/SettingsModal.tsx`
- [Appearance Settings](https://github.com/raktim-yoddha/taskmaster/blob/master/src/components/AppearanceSettings.tsx): `src/components/AppearanceSettings.tsx`
- [Themed Select](https://github.com/raktim-yoddha/taskmaster/blob/master/src/components/ThemedSelect.tsx): `src/components/ThemedSelect.tsx`
- [Segmented Control](https://github.com/raktim-yoddha/taskmaster/blob/master/src/components/SegmentedControl.tsx): `src/components/SegmentedControl.tsx`

### Focus and Planning

- [Timer Controls](https://github.com/raktim-yoddha/taskmaster/blob/master/src/components/FocusTimer.tsx): `src/components/FocusTimer.tsx`
- [Timer Engine](https://github.com/raktim-yoddha/taskmaster/blob/master/src/hooks/useTimer.ts): `src/hooks/useTimer.ts`
- [Timer Sounds](https://github.com/raktim-yoddha/taskmaster/blob/master/src/utils/sound.ts): `src/utils/sound.ts`
- [Task History](https://github.com/raktim-yoddha/taskmaster/blob/master/src/components/HistoryView.tsx): `src/components/HistoryView.tsx`
- [Notes](https://github.com/raktim-yoddha/taskmaster/blob/master/src/components/NotesView.tsx): `src/components/NotesView.tsx`
- [Shared Models](https://github.com/raktim-yoddha/taskmaster/blob/master/src/types.ts): `src/types.ts`

### Native State

- [Tauri Commands](https://github.com/raktim-yoddha/taskmaster/blob/master/src-tauri/src/lib.rs): `src-tauri/src/lib.rs`
- [Rust Models](https://github.com/raktim-yoddha/taskmaster/blob/master/src-tauri/src/models.rs): `src-tauri/src/models.rs`
- [State Store](https://github.com/raktim-yoddha/taskmaster/blob/master/src-tauri/src/store.rs): `src-tauri/src/store.rs`

### App Updates

- [Update Service](https://github.com/raktim-yoddha/taskmaster/blob/master/src/utils/updater.ts): `src/utils/updater.ts`
- [Update Dialog](https://github.com/raktim-yoddha/taskmaster/blob/master/src/components/UpdateNotificationModal.tsx): `src/components/UpdateNotificationModal.tsx`

### Other components

- **User**
- **GitHub Releases**

## Connections

- User → React Entry: opens app (evidence: `src/main.tsx`)
- React Entry → Window App: renders (evidence: `src/main.tsx`)
- Window App → Timer Engine: creates timer (evidence: `src/App.tsx`)
- Window App → Task Dashboard: renders (evidence: `src/App.tsx`)
- Task Dashboard → Sticky Widget: opens widget (evidence: `src/components/AppDashboard.tsx`)
- Task Dashboard → Task History: renders (evidence: `src/components/AppDashboard.tsx`)
- Task Dashboard → Notes: renders (evidence: `src/components/AppDashboard.tsx`)
- Task Dashboard → Timer Controls: renders (evidence: `src/components/AppDashboard.tsx`)
- Task Dashboard → Settings: renders (evidence: `src/components/AppDashboard.tsx`)
- Task Dashboard → Update Service: checks updates (evidence: `src/components/AppDashboard.tsx`)
- Task Dashboard → Update Dialog: shows dialog (evidence: `src/components/AppDashboard.tsx`)
- Settings → Appearance Settings: renders
- Settings → Themed Select: uses (evidence: `src/components/SettingsModal.tsx`)
- Settings → Segmented Control: uses (evidence: `src/components/SettingsModal.tsx`)
- Appearance Settings → Themed Select: uses (evidence: `src/components/AppearanceSettings.tsx`)
- Timer Controls → Timer Engine: uses
- Sticky Widget → Timer Engine: uses (evidence: `src/components/StickyWidget.tsx`)
- Timer Engine → Timer Sounds: plays sounds (evidence: `src/hooks/useTimer.ts`)
- Window App → Tauri Commands: invokes commands (evidence: `src/App.tsx`)
- Sticky Widget → Tauri Commands: invokes commands (evidence: `src/components/StickyWidget.tsx`)
- Tauri Commands → State Store: persists state (evidence: `src-tauri/src/lib.rs`)
- Tauri Commands → Rust Models: uses models (evidence: `src-tauri/src/lib.rs`)
- Update Service → GitHub Releases: fetches releases (evidence: `src/utils/updater.ts`)
- Update Service → Tauri Commands: requests update (evidence: `src/utils/updater.ts`)
