# vishakhasatpute/task-tracker architecture

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

- Interactive diagram: https://gitdiagram.com/vishakhasatpute/task-tracker
- Repository: https://github.com/vishakhasatpute/task-tracker

## Overview

Task Tracker is a local project board that turns pasted ideas and synced meeting notes into editable project cards. Users can also create and organize cards by status, manage members and project types, and configure AI providers. The browser app talks to an Express API, which stores documents and settings in SQLite or Turso and calls the selected AI provider. The graph reflects documented capabilities and shown imports/calls; some UI and API details are unsampled, so their internal links are omitted where evidence is unavailable.

Main entry points: [`src/App.jsx`](https://github.com/vishakhasatpute/task-tracker/blob/main/src/App.jsx) (Project board), [`server/index.js`](https://github.com/vishakhasatpute/task-tracker/blob/main/server/index.js) (Express API), [`src/notesSync.js`](https://github.com/vishakhasatpute/task-tracker/blob/main/src/notesSync.js) (Notes folder sync), [`src/store.js`](https://github.com/vishakhasatpute/task-tracker/blob/main/src/store.js) (Document client)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Web app"]
  node_app["Project board<br/>[App.jsx]"]
  node_card_ops["Card management<br/>[App.jsx]"]
  node_settings_ui["Settings dialog<br/>[SettingsModal.jsx]"]
  node_auth_gate["Sign-in gate<br/>[auth.jsx]"]
  node_settings_client["Settings client<br/>[settings.js]"]
end

subgraph group_ingest["Drafting and sync"]
  node_idea_drafts["Idea drafting<br/>[claude.js]"]
  node_notes_sync["Notes folder sync<br/>[notesSync.js]"]
  node_assignees["Assignee handling<br/>[assignees.js]"]
end

subgraph group_api["API and security"]
  node_api_server["Express API<br/>[index.js]"]
  node_vercel_entry["Vercel function entry<br/>[index.js]"]
end

subgraph group_persistence["Persistence"]
  node_store_client["Document client<br/>[store.js]"]
  node_db_layer[("SQLite and Turso<br/>[db.js]")]
end

node_user(("Team member"))
node_ai_provider{{"AI provider"}}

node_user -->|"organizes projects"| node_app
node_app -->|"manages cards"| node_card_ops
node_app -->|"requests drafts"| node_idea_drafts
node_app -->|"starts sync"| node_notes_sync
node_notes_sync -->|"extracts projects"| node_idea_drafts
node_notes_sync -->|"reads assignees"| node_assignees
node_app -->|"reads assignees"| node_assignees
node_app -->|"opens dialog"| node_settings_ui
node_app -->|"loads settings"| node_settings_client
node_app -->|"creates store"| node_store_client
node_auth_gate -->|"checks session"| node_api_server
node_store_client -->|"requests documents"| node_api_server
node_api_server -->|"reads and writes"| node_db_layer
node_api_server -->|"sends prompts"| node_ai_provider
node_vercel_entry -->|"exports app"| node_api_server

click node_app "https://github.com/vishakhasatpute/task-tracker/blob/main/src/App.jsx"
click node_card_ops "https://github.com/vishakhasatpute/task-tracker/blob/main/src/App.jsx"
click node_settings_ui "https://github.com/vishakhasatpute/task-tracker/blob/main/src/SettingsModal.jsx"
click node_auth_gate "https://github.com/vishakhasatpute/task-tracker/blob/main/src/auth.jsx"
click node_idea_drafts "https://github.com/vishakhasatpute/task-tracker/blob/main/src/claude.js"
click node_notes_sync "https://github.com/vishakhasatpute/task-tracker/blob/main/src/notesSync.js"
click node_assignees "https://github.com/vishakhasatpute/task-tracker/blob/main/src/assignees.js"
click node_settings_client "https://github.com/vishakhasatpute/task-tracker/blob/main/src/settings.js"
click node_store_client "https://github.com/vishakhasatpute/task-tracker/blob/main/src/store.js"
click node_api_server "https://github.com/vishakhasatpute/task-tracker/blob/main/server/index.js"
click node_vercel_entry "https://github.com/vishakhasatpute/task-tracker/blob/main/api/index.js"
click node_db_layer "https://github.com/vishakhasatpute/task-tracker/blob/main/server/db.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_card_ops,node_settings_ui,node_auth_gate,node_settings_client toneBlue
class node_idea_drafts,node_notes_sync,node_assignees toneAmber
class node_api_server,node_vercel_entry toneMint
class node_store_client,node_db_layer toneRose
class node_user,node_ai_provider toneIndigo
```

## Components

### Web app

- [Project board](https://github.com/vishakhasatpute/task-tracker/blob/main/src/App.jsx): `src/App.jsx`
- [Card management](https://github.com/vishakhasatpute/task-tracker/blob/main/src/App.jsx): `src/App.jsx`
- [Settings dialog](https://github.com/vishakhasatpute/task-tracker/blob/main/src/SettingsModal.jsx): `src/SettingsModal.jsx`
- [Sign-in gate](https://github.com/vishakhasatpute/task-tracker/blob/main/src/auth.jsx): `src/auth.jsx`
- [Settings client](https://github.com/vishakhasatpute/task-tracker/blob/main/src/settings.js): `src/settings.js`

### Drafting and sync

- [Idea drafting](https://github.com/vishakhasatpute/task-tracker/blob/main/src/claude.js): `src/claude.js`
- [Notes folder sync](https://github.com/vishakhasatpute/task-tracker/blob/main/src/notesSync.js): `src/notesSync.js`
- [Assignee handling](https://github.com/vishakhasatpute/task-tracker/blob/main/src/assignees.js): `src/assignees.js`

### API and security

- [Express API](https://github.com/vishakhasatpute/task-tracker/blob/main/server/index.js): `server/index.js`
- [Vercel function entry](https://github.com/vishakhasatpute/task-tracker/blob/main/api/index.js): `api/index.js`

### Persistence

- [Document client](https://github.com/vishakhasatpute/task-tracker/blob/main/src/store.js): `src/store.js`
- [SQLite and Turso](https://github.com/vishakhasatpute/task-tracker/blob/main/server/db.js): `server/db.js`

### Other components

- **Team member**
- **AI provider**

## Connections

- Team member → Project board: organizes projects (evidence: `README.md`)
- Project board → Card management: manages cards (evidence: `README.md`)
- Project board → Idea drafting: requests drafts (evidence: `src/App.jsx`)
- Project board → Notes folder sync: starts sync (evidence: `src/App.jsx`)
- Notes folder sync → Idea drafting: extracts projects (evidence: `src/notesSync.js`)
- Notes folder sync → Assignee handling: reads assignees (evidence: `src/notesSync.js`)
- Project board → Assignee handling: reads assignees (evidence: `src/App.jsx`)
- Project board → Settings dialog: opens dialog (evidence: `src/App.jsx`)
- Project board → Settings client: loads settings (evidence: `src/App.jsx`)
- Project board → Document client: creates store (evidence: `src/App.jsx`)
- Sign-in gate → Express API: checks session (evidence: `src/auth.jsx`)
- Document client → Express API: requests documents (evidence: `src/store.js`)
- Express API → SQLite and Turso: reads and writes (evidence: `server/index.js`)
- Express API → AI provider: sends prompts (evidence: `server/index.js`)
- Vercel function entry → Express API: exports app (evidence: `api/index.js`)
