# codex-eso/taskbuddy architecture

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

- Interactive diagram: https://gitdiagram.com/codex-eso/taskbuddy
- Repository: https://github.com/codex-eso/taskbuddy

## Overview

TaskBuddy is a task-management web app: users gain access, browse tasks by status, open a task to edit or change its state, and add tasks; the Express API validates and persists task data in MongoDB. The graph also shows the documented-by-code service-worker registration. The README contains no product documentation, and several UI modules are unsampled, so their behavior and connections are left unspecified.

Main entry points: [`src/App.tsx`](https://github.com/codex-eso/taskbuddy/blob/master/src/App.tsx) (App workflow), [`routes/tasks.ts`](https://github.com/codex-eso/taskbuddy/blob/master/routes/tasks.ts) (Task endpoints), [`src/components/states/ActiveTaskState.tsx`](https://github.com/codex-eso/taskbuddy/blob/master/src/components/states/ActiveTaskState.tsx) (Active task view), [`src/components/inputs/TaskInput.tsx`](https://github.com/codex-eso/taskbuddy/blob/master/src/components/inputs/TaskInput.tsx) (Task editor)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Task interface"]
  node_app["App workflow<br/>[App.tsx]"]
  node_tasklist["Task list item<br/>[TaskState.tsx]"]
  node_active["Active task view"]
  node_taskinput["Task editor<br/>[TaskInput.tsx]"]
  node_actioncontrols["Task action controls"]
  node_taskactions["Task mutations<br/>[actions.ts]"]
  node_otherui["Other UI controls"]
end

subgraph group_api["Task API"]
  node_apiclient["HTTP client<br/>[axiosApi.ts]"]
  node_taskroutes["Task endpoints<br/>[tasks.ts]"]
  node_server["Server bootstrap<br/>[server.ts]"]
  node_mongodb[("Task collection")]
end

subgraph group_model["Task domain"]
  node_tasktype["Task shape<br/>[tasksProp.ts]"]
  node_actionprops["Action props<br/>[actionProps.ts]"]
end

subgraph group_runtime["Browser runtime"]
  node_browser(("Browser"))
  node_entry["Client entry<br/>[main.tsx]"]
  node_serviceworker["Service worker<br/>[serviceWorker.js]"]
end

node_user(("User"))

node_user -->|"uses"| node_app
node_entry -->|"renders"| node_app
node_app -->|"renders"| node_tasklist
node_app -->|"renders"| node_active
node_app -->|"renders"| node_otherui
node_active -->|"renders"| node_taskinput
node_active -->|"renders"| node_actioncontrols
node_actioncontrols -->|"calls"| node_taskactions
node_taskinput -->|"calls"| node_apiclient
node_taskactions -->|"calls"| node_apiclient
node_app -->|"loads tasks"| node_apiclient
node_app -->|"uses type"| node_tasktype
node_active -->|"uses type"| node_tasktype
node_server -->|"mounts routes"| node_taskroutes
node_taskroutes -->|"reads and writes"| node_mongodb
node_taskinput -->|"HTTP requests"| node_taskroutes
node_taskactions -->|"HTTP requests"| node_taskroutes
node_app -->|"HTTP requests"| node_taskroutes
node_browser -.->|"loads"| node_entry
node_entry -->|"registers"| node_serviceworker

click node_app "https://github.com/codex-eso/taskbuddy/blob/master/src/App.tsx"
click node_tasklist "https://github.com/codex-eso/taskbuddy/blob/master/src/components/states/TaskState.tsx"
click node_active "https://github.com/codex-eso/taskbuddy/blob/master/src/components/states/ActiveTaskState.tsx"
click node_taskinput "https://github.com/codex-eso/taskbuddy/blob/master/src/components/inputs/TaskInput.tsx"
click node_actioncontrols "https://github.com/codex-eso/taskbuddy/tree/master/src/components/states/actions"
click node_taskactions "https://github.com/codex-eso/taskbuddy/blob/master/src/components/states/actions/actions.ts"
click node_tasktype "https://github.com/codex-eso/taskbuddy/blob/master/src/components/tasksProp.ts"
click node_actionprops "https://github.com/codex-eso/taskbuddy/blob/master/src/components/states/actions/actionProps.ts"
click node_apiclient "https://github.com/codex-eso/taskbuddy/blob/master/routes/axiosApi.ts"
click node_taskroutes "https://github.com/codex-eso/taskbuddy/blob/master/routes/tasks.ts"
click node_server "https://github.com/codex-eso/taskbuddy/blob/master/server.ts"
click node_entry "https://github.com/codex-eso/taskbuddy/blob/master/src/main.tsx"
click node_serviceworker "https://github.com/codex-eso/taskbuddy/blob/master/public/serviceWorker.js"
click node_otherui "https://github.com/codex-eso/taskbuddy/tree/master/src/components"

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_active,node_taskinput,node_actioncontrols,node_taskactions,node_otherui,node_user toneBlue
class node_apiclient,node_taskroutes,node_server,node_mongodb toneAmber
class node_tasktype,node_actionprops toneMint
class node_browser,node_entry,node_serviceworker toneRose
```

## Components

### Task interface

- [App workflow](https://github.com/codex-eso/taskbuddy/blob/master/src/App.tsx): `src/App.tsx`
- [Task list item](https://github.com/codex-eso/taskbuddy/blob/master/src/components/states/TaskState.tsx): `src/components/states/TaskState.tsx`
- [Active task view](https://github.com/codex-eso/taskbuddy/blob/master/src/components/states/ActiveTaskState.tsx): `src/components/states/ActiveTaskState.tsx`
- [Task editor](https://github.com/codex-eso/taskbuddy/blob/master/src/components/inputs/TaskInput.tsx): `src/components/inputs/TaskInput.tsx`
- [Task action controls](https://github.com/codex-eso/taskbuddy/tree/master/src/components/states/actions): `src/components/states/actions`
- [Task mutations](https://github.com/codex-eso/taskbuddy/blob/master/src/components/states/actions/actions.ts): `src/components/states/actions/actions.ts`
- [Other UI controls](https://github.com/codex-eso/taskbuddy/tree/master/src/components): `src/components`

### Task API

- [HTTP client](https://github.com/codex-eso/taskbuddy/blob/master/routes/axiosApi.ts): `routes/axiosApi.ts`
- [Task endpoints](https://github.com/codex-eso/taskbuddy/blob/master/routes/tasks.ts): `routes/tasks.ts`
- [Server bootstrap](https://github.com/codex-eso/taskbuddy/blob/master/server.ts): `server.ts`
- **Task collection**

### Task domain

- [Task shape](https://github.com/codex-eso/taskbuddy/blob/master/src/components/tasksProp.ts): `src/components/tasksProp.ts`
- [Action props](https://github.com/codex-eso/taskbuddy/blob/master/src/components/states/actions/actionProps.ts): `src/components/states/actions/actionProps.ts`

### Browser runtime

- **Browser**
- [Client entry](https://github.com/codex-eso/taskbuddy/blob/master/src/main.tsx): `src/main.tsx`
- [Service worker](https://github.com/codex-eso/taskbuddy/blob/master/public/serviceWorker.js): `public/serviceWorker.js`

### Other components

- **User**

## Connections

- User → App workflow: uses
- Client entry → App workflow: renders (evidence: `src/main.tsx`)
- App workflow → Task list item: renders (evidence: `src/App.tsx`)
- App workflow → Active task view: renders (evidence: `src/App.tsx`)
- App workflow → Other UI controls: renders (evidence: `src/App.tsx`)
- Active task view → Task editor: renders (evidence: `src/components/states/ActiveTaskState.tsx`)
- Active task view → Task action controls: renders (evidence: `src/components/states/ActiveTaskState.tsx`)
- Task action controls → Task mutations: calls (evidence: `src/components/states/actions/actions.ts`)
- Task editor → HTTP client: calls (evidence: `src/components/inputs/TaskInput.tsx`)
- Task mutations → HTTP client: calls (evidence: `src/components/states/actions/actions.ts`)
- App workflow → HTTP client: loads tasks (evidence: `src/App.tsx`)
- App workflow → Task shape: uses type (evidence: `src/App.tsx`)
- Active task view → Task shape: uses type (evidence: `src/components/states/ActiveTaskState.tsx`)
- Server bootstrap → Task endpoints: mounts routes (evidence: `server.ts`)
- Task endpoints → Task collection: reads and writes (evidence: `routes/tasks.ts`)
- Task editor → Task endpoints: HTTP requests (evidence: `src/components/inputs/TaskInput.tsx`)
- Task mutations → Task endpoints: HTTP requests (evidence: `src/components/states/actions/actions.ts`)
- App workflow → Task endpoints: HTTP requests (evidence: `src/App.tsx`)
- Browser → Client entry: loads
- Client entry → Service worker: registers (evidence: `src/main.tsx`)
