# raghunandan1451/dtd-tasks architecture

> Architecture diagram of the GitHub repository raghunandan1451/dtd-tasks, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/raghunandan1451/dtd-tasks
- Repository: https://github.com/raghunandan1451/dtd-tasks

## Overview

DTDTasks is a productivity app whose users navigate to tools, create or manage personal data, then save or export it. Its major areas include a home timeline, QR generation, notes, expense tracking and visual boards; desktop mode adds a user-chosen folder for persistent files. The sampled code shows route dispatch, notes hydration and export orchestration, plus board-edit handling and IndexedDB adapters. Other feature internals are represented by their exact directories because their implementation was not sampled; edges are limited to documented or excerpt-visible relationships.

Main entry points: [`src/App.tsx`](https://github.com/raghunandan1451/dtd-tasks/blob/main/src/App.tsx) (Routes and layout), [`src/features/finance`](https://github.com/raghunandan1451/dtd-tasks/tree/main/src/features/finance) (Expense tracker), [`src/main.tsx`](https://github.com/raghunandan1451/dtd-tasks/blob/main/src/main.tsx) (React entry), [`src/features/home/lib/useHomeDownload.ts`](https://github.com/raghunandan1451/dtd-tasks/blob/main/src/features/home/lib/useHomeDownload.ts) (Home export)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["App shell"]
  node_entry["React entry<br/>[main.tsx]"]
  node_router["Routes and layout<br/>[App.tsx]"]
end

subgraph group_personal["Personal tools"]
  node_home["Home timeline"]
  node_home_export["Home export<br/>[useHomeDownload.ts]"]
  node_qr["QR generator"]
  node_notes["Notes manager<br/>[FileManager.tsx]"]
  node_notes_tree["Notes tree and editor"]
end

subgraph group_finance["Finance"]
  node_finance_tracker["Expense tracker"]
  node_finance_setup["Finance setup<br/>[GroupManager.tsx]"]
  node_budget["Budget planning"]
  node_finance_upload["Finance restore"]
end

subgraph group_boards["Visual boards"]
  node_boards_page["Boards page<br/>[NodesPage.tsx]"]
  node_board_editor["Board editor<br/>[useBoardEditor.ts]"]
  node_flow_handlers["Canvas interactions<br/>[useFlowHandlers.ts]"]
end

subgraph group_persistence["Persistence and desktop"]
  node_storage_api["Storage adapters"]
  node_indexeddb[("Browser database<br/>[database.ts]")]
  node_desktop_gate["Desktop folder gate<br/>[DesktopGate.tsx]"]
  node_electron["Desktop runtime<br/>[main.ts]"]
  node_folder_service["Folder file service<br/>[folderService.ts]"]
  node_user_folder[("Chosen data folder")]
end

node_user(("App user"))

node_user -->|"opens"| node_entry
node_entry -->|"renders"| node_router
node_router -->|"routes to"| node_home
node_router -->|"routes to"| node_qr
node_router -->|"routes to"| node_notes
node_router -->|"routes to"| node_finance_tracker
node_router -->|"routes to"| node_boards_page
node_notes -->|"renders"| node_notes_tree
node_home -->|"uses download hook"| node_home_export
node_home_export -->|"hydrates finance"| node_finance_tracker
node_home_export -->|"hydrates notes"| node_notes
node_finance_setup -->|"updates finance state"| node_finance_tracker
node_finance_upload -->|"restores state"| node_finance_tracker
node_board_editor -.->|"uses handlers"| node_flow_handlers
node_storage_api -->|"reads and writes"| node_indexeddb
node_entry -->|"conditionally renders"| node_desktop_gate
node_desktop_gate -.->|"uses desktop bridge"| node_electron
node_electron -->|"calls file operations"| node_folder_service
node_electron -->|"manages data in"| node_user_folder

click node_entry "https://github.com/raghunandan1451/dtd-tasks/blob/main/src/main.tsx"
click node_router "https://github.com/raghunandan1451/dtd-tasks/blob/main/src/App.tsx"
click node_home "https://github.com/raghunandan1451/dtd-tasks/tree/main/src/features/home"
click node_home_export "https://github.com/raghunandan1451/dtd-tasks/blob/main/src/features/home/lib/useHomeDownload.ts"
click node_qr "https://github.com/raghunandan1451/dtd-tasks/tree/main/src/features/qr_generator"
click node_notes "https://github.com/raghunandan1451/dtd-tasks/blob/main/src/features/markdown/FileManager.tsx"
click node_notes_tree "https://github.com/raghunandan1451/dtd-tasks/tree/main/src/features/markdown"
click node_finance_tracker "https://github.com/raghunandan1451/dtd-tasks/tree/main/src/features/finance"
click node_finance_setup "https://github.com/raghunandan1451/dtd-tasks/blob/main/src/features/finance/base_setup/GroupManager.tsx"
click node_budget "https://github.com/raghunandan1451/dtd-tasks/tree/main/src/features/finance/budget_planning"
click node_finance_upload "https://github.com/raghunandan1451/dtd-tasks/blob/main/src/features/finance/hooks/useFinanceUploadHandler.ts"
click node_boards_page "https://github.com/raghunandan1451/dtd-tasks/blob/main/src/features/nodes/NodesPage.tsx"
click node_board_editor "https://github.com/raghunandan1451/dtd-tasks/blob/main/src/features/nodes/lib/useBoardEditor.ts"
click node_flow_handlers "https://github.com/raghunandan1451/dtd-tasks/blob/main/src/features/nodes/lib/useFlowHandlers.ts"
click node_storage_api "https://github.com/raghunandan1451/dtd-tasks/blob/main/src/lib/storage/indexedDbStorage.ts"
click node_indexeddb "https://github.com/raghunandan1451/dtd-tasks/blob/main/src/lib/db/database.ts"
click node_desktop_gate "https://github.com/raghunandan1451/dtd-tasks/blob/main/src/features/desktop/DesktopGate.tsx"
click node_electron "https://github.com/raghunandan1451/dtd-tasks/blob/main/electron/main.ts"
click node_folder_service "https://github.com/raghunandan1451/dtd-tasks/blob/main/electron/folderService.ts"

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_router,node_user toneBlue
class node_home,node_home_export,node_qr,node_notes,node_notes_tree toneAmber
class node_finance_tracker,node_finance_setup,node_budget,node_finance_upload toneMint
class node_boards_page,node_board_editor,node_flow_handlers toneRose
class node_storage_api,node_indexeddb,node_desktop_gate,node_electron,node_folder_service,node_user_folder toneIndigo
```

## Components

### App shell

- [React entry](https://github.com/raghunandan1451/dtd-tasks/blob/main/src/main.tsx): `src/main.tsx`
- [Routes and layout](https://github.com/raghunandan1451/dtd-tasks/blob/main/src/App.tsx): `src/App.tsx`

### Personal tools

- [Home timeline](https://github.com/raghunandan1451/dtd-tasks/tree/main/src/features/home): `src/features/home`
- [Home export](https://github.com/raghunandan1451/dtd-tasks/blob/main/src/features/home/lib/useHomeDownload.ts): `src/features/home/lib/useHomeDownload.ts`
- [QR generator](https://github.com/raghunandan1451/dtd-tasks/tree/main/src/features/qr_generator): `src/features/qr_generator`
- [Notes manager](https://github.com/raghunandan1451/dtd-tasks/blob/main/src/features/markdown/FileManager.tsx): `src/features/markdown/FileManager.tsx`
- [Notes tree and editor](https://github.com/raghunandan1451/dtd-tasks/tree/main/src/features/markdown): `src/features/markdown`

### Finance

- [Expense tracker](https://github.com/raghunandan1451/dtd-tasks/tree/main/src/features/finance): `src/features/finance`
- [Finance setup](https://github.com/raghunandan1451/dtd-tasks/blob/main/src/features/finance/base_setup/GroupManager.tsx): `src/features/finance/base_setup/GroupManager.tsx`
- [Budget planning](https://github.com/raghunandan1451/dtd-tasks/tree/main/src/features/finance/budget_planning): `src/features/finance/budget_planning`
- [Finance restore](https://github.com/raghunandan1451/dtd-tasks/blob/main/src/features/finance/hooks/useFinanceUploadHandler.ts): `src/features/finance/hooks/useFinanceUploadHandler.ts`

### Visual boards

- [Boards page](https://github.com/raghunandan1451/dtd-tasks/blob/main/src/features/nodes/NodesPage.tsx): `src/features/nodes/NodesPage.tsx`
- [Board editor](https://github.com/raghunandan1451/dtd-tasks/blob/main/src/features/nodes/lib/useBoardEditor.ts): `src/features/nodes/lib/useBoardEditor.ts`
- [Canvas interactions](https://github.com/raghunandan1451/dtd-tasks/blob/main/src/features/nodes/lib/useFlowHandlers.ts): `src/features/nodes/lib/useFlowHandlers.ts`

### Persistence and desktop

- [Storage adapters](https://github.com/raghunandan1451/dtd-tasks/blob/main/src/lib/storage/indexedDbStorage.ts): `src/lib/storage/indexedDbStorage.ts`
- [Browser database](https://github.com/raghunandan1451/dtd-tasks/blob/main/src/lib/db/database.ts): `src/lib/db/database.ts`
- [Desktop folder gate](https://github.com/raghunandan1451/dtd-tasks/blob/main/src/features/desktop/DesktopGate.tsx): `src/features/desktop/DesktopGate.tsx`
- [Desktop runtime](https://github.com/raghunandan1451/dtd-tasks/blob/main/electron/main.ts): `electron/main.ts`
- [Folder file service](https://github.com/raghunandan1451/dtd-tasks/blob/main/electron/folderService.ts): `electron/folderService.ts`
- **Chosen data folder**

### Other components

- **App user**

## Connections

- App user → React entry: opens (evidence: `src/main.tsx`)
- React entry → Routes and layout: renders (evidence: `src/main.tsx`)
- Routes and layout → Home timeline: routes to (evidence: `src/App.tsx`)
- Routes and layout → QR generator: routes to (evidence: `src/App.tsx`)
- Routes and layout → Notes manager: routes to (evidence: `src/App.tsx`)
- Routes and layout → Expense tracker: routes to (evidence: `src/App.tsx`)
- Routes and layout → Boards page: routes to (evidence: `src/App.tsx`)
- Notes manager → Notes tree and editor: renders (evidence: `src/features/markdown/FileManager.tsx`)
- Home timeline → Home export: uses download hook (evidence: `src/features/home/lib/useHomeDownload.ts`)
- Home export → Expense tracker: hydrates finance (evidence: `src/features/home/lib/useHomeDownload.ts`)
- Home export → Notes manager: hydrates notes (evidence: `src/features/home/lib/useHomeDownload.ts`)
- Finance setup → Expense tracker: updates finance state (evidence: `src/features/finance/base_setup/GroupManager.tsx`)
- Finance restore → Expense tracker: restores state (evidence: `src/features/finance/hooks/useFinanceUploadHandler.ts`)
- Board editor → Canvas interactions: uses handlers
- Storage adapters → Browser database: reads and writes (evidence: `src/lib/storage/indexedDbStorage.ts`)
- React entry → Desktop folder gate: conditionally renders (evidence: `src/main.tsx`)
- Desktop folder gate → Desktop runtime: uses desktop bridge
- Desktop runtime → Folder file service: calls file operations (evidence: `electron/main.ts`)
- Desktop runtime → Chosen data folder: manages data in (evidence: `README.md`)
