# bhavith-fs/tasknet architecture

> Architecture diagram of the GitHub repository bhavith-fs/tasknet, 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/bhavith-fs/tasknet
- Repository: https://github.com/bhavith-fs/tasknet

## Overview

TaskNest is a browser-based focus assistant. Users create tasks, start a task’s focus timer, receive activity/accountability checks during sessions, then see completion and progress feedback. The sampled JavaScript shows task and statistics persistence through localStorage, timer controls, visibility-based distraction handling, and completion sound. The README documents dashboard and accountability capabilities; omitted source excerpts limit confirmation of their precise internal wiring. The graph focuses on runtime behavior and excludes presentation-only files.

Main entry points: [`script.js`](https://github.com/bhavith-fs/tasknet/blob/main/script.js) (TaskNest app)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_task["Task management"]
  node_app["TaskNest app<br/>[script.js]"]
  node_tasklist["Task list<br/>[script.js]"]
  node_taskstore[("Task storage<br/>[script.js]")]
end

subgraph group_focus["Focus session"]
  node_timer["Focus timer<br/>[script.js]"]
  node_accountability["Accountability checks<br/>[script.js]"]
  node_distraction["Distraction awareness<br/>[script.js]"]
end

subgraph group_progress["Progress and feedback"]
  node_dashboard["Progress dashboard<br/>[script.js]"]
  node_statsstore[("Progress storage<br/>[script.js]")]
  node_completion["Completion feedback<br/>[script.js]"]
  node_sound["Completion sound<br/>[script.js]"]
end

subgraph group_platform["Browser support"]
  node_browser["Browser events"]
  node_localstorage[("localStorage")]
end

node_user(("User"))

node_user -->|"uses"| node_app
node_app -->|"adds tasks"| node_tasklist
node_tasklist -->|"saves tasks"| node_taskstore
node_taskstore -->|"writes data"| node_localstorage
node_app -->|"starts task timer"| node_timer
node_timer -->|"starts checks"| node_accountability
node_timer -->|"resets detection"| node_distraction
node_distraction -->|"observes visibility"| node_browser
node_timer -->|"completes session"| node_completion
node_completion -->|"plays sound"| node_sound
node_app -->|"updates progress"| node_dashboard
node_dashboard -->|"stores stats"| node_statsstore
node_statsstore -->|"writes data"| node_localstorage

click node_app "https://github.com/bhavith-fs/tasknet/blob/main/script.js"
click node_tasklist "https://github.com/bhavith-fs/tasknet/blob/main/script.js"
click node_taskstore "https://github.com/bhavith-fs/tasknet/blob/main/script.js"
click node_timer "https://github.com/bhavith-fs/tasknet/blob/main/script.js"
click node_accountability "https://github.com/bhavith-fs/tasknet/blob/main/script.js"
click node_distraction "https://github.com/bhavith-fs/tasknet/blob/main/script.js"
click node_dashboard "https://github.com/bhavith-fs/tasknet/blob/main/script.js"
click node_statsstore "https://github.com/bhavith-fs/tasknet/blob/main/script.js"
click node_completion "https://github.com/bhavith-fs/tasknet/blob/main/script.js"
click node_sound "https://github.com/bhavith-fs/tasknet/blob/main/script.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_app,node_tasklist,node_taskstore,node_user toneBlue
class node_timer,node_accountability,node_distraction toneAmber
class node_dashboard,node_statsstore,node_completion,node_sound toneMint
class node_browser,node_localstorage toneRose
```

## Components

### Task management

- [TaskNest app](https://github.com/bhavith-fs/tasknet/blob/main/script.js): `script.js`
- [Task list](https://github.com/bhavith-fs/tasknet/blob/main/script.js): `script.js`
- [Task storage](https://github.com/bhavith-fs/tasknet/blob/main/script.js): `script.js`

### Focus session

- [Focus timer](https://github.com/bhavith-fs/tasknet/blob/main/script.js): `script.js`
- [Accountability checks](https://github.com/bhavith-fs/tasknet/blob/main/script.js): `script.js`
- [Distraction awareness](https://github.com/bhavith-fs/tasknet/blob/main/script.js): `script.js`

### Progress and feedback

- [Progress dashboard](https://github.com/bhavith-fs/tasknet/blob/main/script.js): `script.js`
- [Progress storage](https://github.com/bhavith-fs/tasknet/blob/main/script.js): `script.js`
- [Completion feedback](https://github.com/bhavith-fs/tasknet/blob/main/script.js): `script.js`
- [Completion sound](https://github.com/bhavith-fs/tasknet/blob/main/script.js): `script.js`

### Browser support

- **Browser events**
- **localStorage**

### Other components

- **User**

## Connections

- User → TaskNest app: uses (evidence: `README.md`)
- TaskNest app → Task list: adds tasks (evidence: `script.js`)
- Task list → Task storage: saves tasks (evidence: `script.js`)
- Task storage → localStorage: writes data (evidence: `script.js`)
- TaskNest app → Focus timer: starts task timer (evidence: `script.js`)
- Focus timer → Accountability checks: starts checks (evidence: `script.js`)
- Focus timer → Distraction awareness: resets detection (evidence: `script.js`)
- Distraction awareness → Browser events: observes visibility (evidence: `script.js`)
- Focus timer → Completion feedback: completes session (evidence: `script.js`)
- Completion feedback → Completion sound: plays sound (evidence: `script.js`)
- TaskNest app → Progress dashboard: updates progress (evidence: `README.md`)
- Progress dashboard → Progress storage: stores stats (evidence: `script.js`)
- Progress storage → localStorage: writes data (evidence: `script.js`)
