# vanshraj07/taskflow architecture

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

- Interactive diagram: https://gitdiagram.com/vanshraj07/taskflow
- Repository: https://github.com/vanshraj07/taskflow

## Overview

TaskFlow is a collaborative Kanban app: users authenticate, enter a workspace dashboard, open a board, and manage tasks with comments and live updates. The frontend routes and authentication flow are excerpted; the README documents the broader workspace, task, dashboard, and real-time capabilities. Backend excerpts show MongoDB use and some task and notification behavior, but not every route, so undocumented implementation links are omitted.

Main entry points: [`backend/server.py`](https://github.com/vanshraj07/taskflow/blob/main/backend/server.py) (TaskFlow API), [`frontend/src/App.js`](https://github.com/vanshraj07/taskflow/blob/main/frontend/src/App.js) (Route shell), [`frontend/src/pages/BoardPage.js`](https://github.com/vanshraj07/taskflow/blob/main/frontend/src/pages/BoardPage.js) (Kanban board), [`frontend/src/pages/DashboardPage.js`](https://github.com/vanshraj07/taskflow/blob/main/frontend/src/pages/DashboardPage.js) (Workspace dashboard)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Web application"]
  node_app["Route shell<br/>[App.js]"]
  node_auth_page["Sign in<br/>[AuthPage.js]"]
  node_auth_state["Auth state<br/>[AuthContext.js]"]
end

subgraph group_collaboration["Team workflows"]
  node_dashboard["Workspace dashboard<br/>[DashboardPage.js]"]
  node_shell["Workspace shell<br/>[AppShell.js]"]
  node_board["Kanban board<br/>[BoardPage.js]"]
  node_task_modal["Task editor<br/>[TaskModal.js]"]
  node_realtime_ui["Live event client<br/>[RealtimeContext.js]"]
end

subgraph group_backend["API services"]
  node_api_client["HTTP client<br/>[api.js]"]
  node_api["TaskFlow API<br/>[server.py]"]
  node_auth_service["Identity service<br/>[server.py]"]
  node_workspace_service["Workspace service<br/>[server.py]"]
  node_task_service["Tasks and comments<br/>[server.py]"]
  node_ws_manager["WebSocket manager<br/>[server.py]"]
end

subgraph group_data["Persistence"]
  node_mongo[("MongoDB")]
end

node_user(("Team member"))

node_user -->|"uses"| node_app
node_app -->|"routes to"| node_auth_page
node_app -->|"routes to"| node_dashboard
node_app -->|"routes to"| node_board
node_app -->|"provides"| node_auth_state
node_auth_page -->|"submits credentials"| node_auth_state
node_auth_state -->|"calls"| node_api_client
node_api_client -->|"sends HTTP requests"| node_api
node_dashboard -->|"loads workspaces"| node_api
node_dashboard -->|"opens workspace"| node_board
node_board -->|"edits tasks"| node_task_modal
node_task_modal -->|"calls task endpoints"| node_api_client
node_shell -->|"supports invitations and notifications"| node_api
node_board -->|"receives live updates"| node_realtime_ui
node_realtime_ui -->|"exchanges events"| node_ws_manager
node_api -->|"routes auth requests"| node_auth_service
node_api -->|"routes workspace requests"| node_workspace_service
node_api -->|"routes task and comment requests"| node_task_service
node_task_service -->|"broadcasts task changes"| node_ws_manager
node_auth_service -->|"reads and writes users"| node_mongo
node_task_service -->|"reads and writes task data"| node_mongo
node_workspace_service -.->|"stores workspaces"| node_mongo
node_api -->|"stores notifications"| node_mongo

click node_app "https://github.com/vanshraj07/taskflow/blob/main/frontend/src/App.js"
click node_auth_page "https://github.com/vanshraj07/taskflow/blob/main/frontend/src/pages/AuthPage.js"
click node_auth_state "https://github.com/vanshraj07/taskflow/blob/main/frontend/src/contexts/AuthContext.js"
click node_dashboard "https://github.com/vanshraj07/taskflow/blob/main/frontend/src/pages/DashboardPage.js"
click node_shell "https://github.com/vanshraj07/taskflow/blob/main/frontend/src/components/AppShell.js"
click node_board "https://github.com/vanshraj07/taskflow/blob/main/frontend/src/pages/BoardPage.js"
click node_task_modal "https://github.com/vanshraj07/taskflow/blob/main/frontend/src/components/TaskModal.js"
click node_realtime_ui "https://github.com/vanshraj07/taskflow/blob/main/frontend/src/contexts/RealtimeContext.js"
click node_api_client "https://github.com/vanshraj07/taskflow/blob/main/frontend/src/lib/api.js"
click node_api "https://github.com/vanshraj07/taskflow/blob/main/backend/server.py"
click node_auth_service "https://github.com/vanshraj07/taskflow/blob/main/backend/server.py"
click node_workspace_service "https://github.com/vanshraj07/taskflow/blob/main/backend/server.py"
click node_task_service "https://github.com/vanshraj07/taskflow/blob/main/backend/server.py"
click node_ws_manager "https://github.com/vanshraj07/taskflow/blob/main/backend/server.py"

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_auth_page,node_auth_state toneBlue
class node_dashboard,node_shell,node_board,node_task_modal,node_realtime_ui toneAmber
class node_api_client,node_api,node_auth_service,node_workspace_service,node_task_service,node_ws_manager toneMint
class node_mongo toneRose
class node_user toneIndigo
```

## Components

### Web application

- [Route shell](https://github.com/vanshraj07/taskflow/blob/main/frontend/src/App.js): `frontend/src/App.js`
- [Sign in](https://github.com/vanshraj07/taskflow/blob/main/frontend/src/pages/AuthPage.js): `frontend/src/pages/AuthPage.js`
- [Auth state](https://github.com/vanshraj07/taskflow/blob/main/frontend/src/contexts/AuthContext.js): `frontend/src/contexts/AuthContext.js`

### Team workflows

- [Workspace dashboard](https://github.com/vanshraj07/taskflow/blob/main/frontend/src/pages/DashboardPage.js): `frontend/src/pages/DashboardPage.js`
- [Workspace shell](https://github.com/vanshraj07/taskflow/blob/main/frontend/src/components/AppShell.js): `frontend/src/components/AppShell.js`
- [Kanban board](https://github.com/vanshraj07/taskflow/blob/main/frontend/src/pages/BoardPage.js): `frontend/src/pages/BoardPage.js`
- [Task editor](https://github.com/vanshraj07/taskflow/blob/main/frontend/src/components/TaskModal.js): `frontend/src/components/TaskModal.js`
- [Live event client](https://github.com/vanshraj07/taskflow/blob/main/frontend/src/contexts/RealtimeContext.js): `frontend/src/contexts/RealtimeContext.js`

### API services

- [HTTP client](https://github.com/vanshraj07/taskflow/blob/main/frontend/src/lib/api.js): `frontend/src/lib/api.js`
- [TaskFlow API](https://github.com/vanshraj07/taskflow/blob/main/backend/server.py): `backend/server.py`
- [Identity service](https://github.com/vanshraj07/taskflow/blob/main/backend/server.py): `backend/server.py`
- [Workspace service](https://github.com/vanshraj07/taskflow/blob/main/backend/server.py): `backend/server.py`
- [Tasks and comments](https://github.com/vanshraj07/taskflow/blob/main/backend/server.py): `backend/server.py`
- [WebSocket manager](https://github.com/vanshraj07/taskflow/blob/main/backend/server.py): `backend/server.py`

### Persistence

- **MongoDB**

### Other components

- **Team member**

## Connections

- Team member → Route shell: uses (evidence: `README.md`)
- Route shell → Sign in: routes to (evidence: `frontend/src/App.js`)
- Route shell → Workspace dashboard: routes to (evidence: `frontend/src/App.js`)
- Route shell → Kanban board: routes to (evidence: `frontend/src/App.js`)
- Route shell → Auth state: provides (evidence: `frontend/src/App.js`)
- Sign in → Auth state: submits credentials (evidence: `frontend/src/pages/AuthPage.js`)
- Auth state → HTTP client: calls (evidence: `frontend/src/contexts/AuthContext.js`)
- HTTP client → TaskFlow API: sends HTTP requests (evidence: `README.md`)
- Workspace dashboard → TaskFlow API: loads workspaces (evidence: `README.md`)
- Workspace dashboard → Kanban board: opens workspace (evidence: `README.md`)
- Kanban board → Task editor: edits tasks (evidence: `README.md`)
- Task editor → HTTP client: calls task endpoints (evidence: `frontend/src/components/TaskModal.js`)
- Workspace shell → TaskFlow API: supports invitations and notifications (evidence: `README.md`)
- Kanban board → Live event client: receives live updates (evidence: `README.md`)
- Live event client → WebSocket manager: exchanges events (evidence: `README.md`)
- TaskFlow API → Identity service: routes auth requests (evidence: `backend/server.py`)
- TaskFlow API → Workspace service: routes workspace requests (evidence: `README.md`)
- TaskFlow API → Tasks and comments: routes task and comment requests (evidence: `README.md`)
- Tasks and comments → WebSocket manager: broadcasts task changes (evidence: `backend/server.py`)
- Identity service → MongoDB: reads and writes users (evidence: `backend/server.py`)
- Tasks and comments → MongoDB: reads and writes task data (evidence: `backend/server.py`)
- Workspace service → MongoDB: stores workspaces
- TaskFlow API → MongoDB: stores notifications (evidence: `backend/server.py`)
