# muquew/task-tracer architecture

> Architecture diagram of the GitHub repository muquew/task-tracer, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-29). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/muquew/task-tracer
- Repository: https://github.com/muquew/task-tracer

## Overview

Task Tracer is a local-first, installable task workspace implemented primarily in a single HTML file. Its main workflow is capturing tasks, organizing and planning them, acting on routines and reminders, then reviewing progress or protecting task data. The README documents these capabilities; source excerpts do not expose the internals of index.html, so links among its feature areas are kept at the documented workflow level.

Main entry points: [`index.html`](https://github.com/muquew/task-tracer/blob/main/index.html) (Task Tracer app), [`sw.js`](https://github.com/muquew/task-tracer/blob/main/sw.js) (Offline service worker), [`manifest.json`](https://github.com/muquew/task-tracer/blob/main/manifest.json) (Install and share metadata), [`resources`](https://github.com/muquew/task-tracer/tree/main/resources) (English and Chinese text)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_capture["Capture and organize"]
  node_capture["Task capture<br/>[index.html]"]
  node_organize["Projects, tags, search<br/>[index.html]"]
  node_smartviews["Saved smart views<br/>[index.html]"]
end

subgraph group_planning["Planning and execution"]
  node_views["List, calendar, timeline<br/>[index.html]"]
  node_today["Today Plan and batches<br/>[index.html]"]
  node_taskactions["Task actions and undo<br/>[index.html]"]
  node_recurrence["Recurring routines<br/>[index.html]"]
end

subgraph group_insight["Reminders and review"]
  node_reminders["Reminders and snooze<br/>[index.html]"]
  node_statistics["Statistics and review<br/>[index.html]"]
end

subgraph group_data["Local data"]
  node_backup["Import, export, backup<br/>[index.html]"]
  node_storage[("Browser task storage<br/>[index.html]")]
end

subgraph group_pwa["Offline app shell"]
  node_manifest["Install and share metadata<br/>[manifest.json]"]
  node_worker["Offline service worker<br/>[sw.js]"]
  node_translations["English and Chinese text"]
end

node_person(("Task workspace user"))
node_app["Task Tracer app<br/>[index.html]"]
node_browser["Browser platform"]
node_notifications["Browser notifications"]

node_person -->|"opens"| node_app
node_app -->|"offers capture"| node_capture
node_app -->|"organizes tasks"| node_organize
node_app -->|"saves filters"| node_smartviews
node_app -->|"presents tasks"| node_views
node_app -->|"plans today"| node_today
node_app -->|"updates tasks"| node_taskactions
node_app -->|"manages repeats"| node_recurrence
node_app -->|"checks reminders"| node_reminders
node_app -->|"reviews progress"| node_statistics
node_app -->|"imports and exports"| node_backup
node_app -->|"reads and writes"| node_storage
node_app -->|"loads language text"| node_translations
node_app -->|"uses browser APIs"| node_browser
node_app -.->|"requests notifications"| node_notifications
node_browser -->|"installs app"| node_manifest
node_browser -->|"runs worker"| node_worker
node_worker -->|"caches app shell"| node_browser
node_worker -->|"serves offline"| node_app
node_notifications -.->|"delivers click"| node_worker

click node_app "https://github.com/muquew/task-tracer/blob/main/index.html"
click node_capture "https://github.com/muquew/task-tracer/blob/main/index.html"
click node_organize "https://github.com/muquew/task-tracer/blob/main/index.html"
click node_smartviews "https://github.com/muquew/task-tracer/blob/main/index.html"
click node_views "https://github.com/muquew/task-tracer/blob/main/index.html"
click node_today "https://github.com/muquew/task-tracer/blob/main/index.html"
click node_taskactions "https://github.com/muquew/task-tracer/blob/main/index.html"
click node_recurrence "https://github.com/muquew/task-tracer/blob/main/index.html"
click node_reminders "https://github.com/muquew/task-tracer/blob/main/index.html"
click node_statistics "https://github.com/muquew/task-tracer/blob/main/index.html"
click node_backup "https://github.com/muquew/task-tracer/blob/main/index.html"
click node_storage "https://github.com/muquew/task-tracer/blob/main/index.html"
click node_manifest "https://github.com/muquew/task-tracer/blob/main/manifest.json"
click node_worker "https://github.com/muquew/task-tracer/blob/main/sw.js"
click node_translations "https://github.com/muquew/task-tracer/tree/main/resources"

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_capture,node_organize,node_smartviews,node_browser,node_notifications toneBlue
class node_views,node_today,node_taskactions,node_recurrence toneAmber
class node_reminders,node_statistics toneMint
class node_backup,node_storage,node_person,node_app toneRose
class node_manifest,node_worker,node_translations toneIndigo
```

## Components

### Capture and organize

- [Task capture](https://github.com/muquew/task-tracer/blob/main/index.html): `index.html`
- [Projects, tags, search](https://github.com/muquew/task-tracer/blob/main/index.html): `index.html`
- [Saved smart views](https://github.com/muquew/task-tracer/blob/main/index.html): `index.html`

### Planning and execution

- [List, calendar, timeline](https://github.com/muquew/task-tracer/blob/main/index.html): `index.html`
- [Today Plan and batches](https://github.com/muquew/task-tracer/blob/main/index.html): `index.html`
- [Task actions and undo](https://github.com/muquew/task-tracer/blob/main/index.html): `index.html`
- [Recurring routines](https://github.com/muquew/task-tracer/blob/main/index.html): `index.html`

### Reminders and review

- [Reminders and snooze](https://github.com/muquew/task-tracer/blob/main/index.html): `index.html`
- [Statistics and review](https://github.com/muquew/task-tracer/blob/main/index.html): `index.html`

### Local data

- [Import, export, backup](https://github.com/muquew/task-tracer/blob/main/index.html): `index.html`
- [Browser task storage](https://github.com/muquew/task-tracer/blob/main/index.html): `index.html`

### Offline app shell

- [Install and share metadata](https://github.com/muquew/task-tracer/blob/main/manifest.json): `manifest.json`
- [Offline service worker](https://github.com/muquew/task-tracer/blob/main/sw.js): `sw.js`
- [English and Chinese text](https://github.com/muquew/task-tracer/tree/main/resources): `resources`

### Other components

- **Task workspace user**
- [Task Tracer app](https://github.com/muquew/task-tracer/blob/main/index.html): `index.html`
- **Browser platform**
- **Browser notifications**

## Connections

- Task workspace user → Task Tracer app: opens
- Task Tracer app → Task capture: offers capture
- Task Tracer app → Projects, tags, search: organizes tasks
- Task Tracer app → Saved smart views: saves filters
- Task Tracer app → List, calendar, timeline: presents tasks
- Task Tracer app → Today Plan and batches: plans today
- Task Tracer app → Task actions and undo: updates tasks
- Task Tracer app → Recurring routines: manages repeats
- Task Tracer app → Reminders and snooze: checks reminders
- Task Tracer app → Statistics and review: reviews progress
- Task Tracer app → Import, export, backup: imports and exports
- Task Tracer app → Browser task storage: reads and writes
- Task Tracer app → English and Chinese text: loads language text
- Task Tracer app → Browser platform: uses browser APIs
- Task Tracer app → Browser notifications: requests notifications
- Browser platform → Install and share metadata: installs app
- Browser platform → Offline service worker: runs worker
- Offline service worker → Browser platform: caches app shell
- Offline service worker → Task Tracer app: serves offline
- Browser notifications → Offline service worker: delivers click