# halilhub/-haliltodo architecture

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

- Interactive diagram: https://gitdiagram.com/halilhub/-haliltodo
- Repository: https://github.com/halilhub/-haliltodo

## Overview

hallil-todo is a task-planning web app. A user creates categorized, prioritized tasks, then completes, deletes, or reorders them; the React app sends task operations to an Express API, which persists them in SQLite. The UI separates active and completed tasks and also provides a Pomodoro timer, task-count statistics, and a theme toggle. The main API and component relationships are visible in the excerpts; broader capabilities are included only where documented. The timer’s audio notification is an external optional dependency.

Main entry points: [`frontend/src/App.jsx`](https://github.com/halilhub/-haliltodo/blob/main/frontend/src/App.jsx) (App state and API client), [`frontend/src/components/TaskItem.jsx`](https://github.com/halilhub/-haliltodo/blob/main/frontend/src/components/TaskItem.jsx) (Task card), [`frontend/src/components/TaskInput.jsx`](https://github.com/halilhub/-haliltodo/blob/main/frontend/src/components/TaskInput.jsx) (Task entry), [`frontend/src/components/TaskList.jsx`](https://github.com/halilhub/-haliltodo/blob/main/frontend/src/components/TaskList.jsx) (Active task list)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_task_ui["Task interface"]
  node_app["App state and API client<br/>[App.jsx]"]
  node_task_input["Task entry<br/>[TaskInput.jsx]"]
  node_task_list["Active task list<br/>[TaskList.jsx]"]
  node_task_item["Task card<br/>[TaskItem.jsx]"]
end

subgraph group_productivity["Focus and display"]
  node_theme["Theme toggle<br/>[ThemeToggle.jsx]"]
  node_pomodoro["Pomodoro timer<br/>[Pomodoro.jsx]"]
  node_stats["Task statistics<br/>[Stats.jsx]"]
end

subgraph group_api["Task API"]
  node_server["Express server<br/>[index.js]"]
  node_task_routes["Task routes<br/>[taskRoutes.js]"]
  node_task_controller["Task operations<br/>[taskController.js]"]
end

subgraph group_persistence["SQLite persistence"]
  node_db_setup["SQLite connection<br/>[setup.js]"]
  node_sqlite[("Task database")]
end

node_user(("User"))
node_audio["Notification audio"]

node_user -->|"enters task"| node_task_input
node_user -->|"manages tasks"| node_task_item
node_app -->|"renders"| node_task_input
node_task_input -->|"submits task"| node_app
node_app -->|"renders active tasks"| node_task_list
node_task_list -->|"renders cards"| node_task_item
node_app -->|"renders completed tasks"| node_task_item
node_task_item -->|"requests task changes"| node_app
node_app -->|"sends task API requests"| node_server
node_server -->|"mounts routes"| node_task_routes
node_task_routes -->|"dispatches requests"| node_task_controller
node_task_controller -->|"queries database"| node_db_setup
node_db_setup -->|"opens file"| node_sqlite
node_app -->|"renders"| node_theme
node_app -->|"renders"| node_pomodoro
node_pomodoro -.->|"plays alert"| node_audio
node_app -->|"passes tasks"| node_stats

click node_app "https://github.com/halilhub/-haliltodo/blob/main/frontend/src/App.jsx"
click node_task_input "https://github.com/halilhub/-haliltodo/blob/main/frontend/src/components/TaskInput.jsx"
click node_task_list "https://github.com/halilhub/-haliltodo/blob/main/frontend/src/components/TaskList.jsx"
click node_task_item "https://github.com/halilhub/-haliltodo/blob/main/frontend/src/components/TaskItem.jsx"
click node_theme "https://github.com/halilhub/-haliltodo/blob/main/frontend/src/components/ThemeToggle.jsx"
click node_pomodoro "https://github.com/halilhub/-haliltodo/blob/main/frontend/src/components/Pomodoro.jsx"
click node_stats "https://github.com/halilhub/-haliltodo/blob/main/frontend/src/components/Stats.jsx"
click node_server "https://github.com/halilhub/-haliltodo/blob/main/backend/src/index.js"
click node_task_routes "https://github.com/halilhub/-haliltodo/blob/main/backend/src/routes/taskRoutes.js"
click node_task_controller "https://github.com/halilhub/-haliltodo/blob/main/backend/src/controllers/taskController.js"
click node_db_setup "https://github.com/halilhub/-haliltodo/blob/main/backend/src/db/setup.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_task_input,node_task_list,node_task_item,node_user toneBlue
class node_theme,node_pomodoro,node_stats toneAmber
class node_server,node_task_routes,node_task_controller toneMint
class node_db_setup,node_sqlite toneRose
class node_audio toneIndigo
```

## Components

### Task interface

- [App state and API client](https://github.com/halilhub/-haliltodo/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Task entry](https://github.com/halilhub/-haliltodo/blob/main/frontend/src/components/TaskInput.jsx): `frontend/src/components/TaskInput.jsx`
- [Active task list](https://github.com/halilhub/-haliltodo/blob/main/frontend/src/components/TaskList.jsx): `frontend/src/components/TaskList.jsx`
- [Task card](https://github.com/halilhub/-haliltodo/blob/main/frontend/src/components/TaskItem.jsx): `frontend/src/components/TaskItem.jsx`

### Focus and display

- [Theme toggle](https://github.com/halilhub/-haliltodo/blob/main/frontend/src/components/ThemeToggle.jsx): `frontend/src/components/ThemeToggle.jsx`
- [Pomodoro timer](https://github.com/halilhub/-haliltodo/blob/main/frontend/src/components/Pomodoro.jsx): `frontend/src/components/Pomodoro.jsx`
- [Task statistics](https://github.com/halilhub/-haliltodo/blob/main/frontend/src/components/Stats.jsx): `frontend/src/components/Stats.jsx`

### Task API

- [Express server](https://github.com/halilhub/-haliltodo/blob/main/backend/src/index.js): `backend/src/index.js`
- [Task routes](https://github.com/halilhub/-haliltodo/blob/main/backend/src/routes/taskRoutes.js): `backend/src/routes/taskRoutes.js`
- [Task operations](https://github.com/halilhub/-haliltodo/blob/main/backend/src/controllers/taskController.js): `backend/src/controllers/taskController.js`

### SQLite persistence

- [SQLite connection](https://github.com/halilhub/-haliltodo/blob/main/backend/src/db/setup.js): `backend/src/db/setup.js`
- **Task database**

### Other components

- **User**
- **Notification audio**

## Connections

- User → Task entry: enters task (evidence: `README.md`)
- User → Task card: manages tasks (evidence: `README.md`)
- App state and API client → Task entry: renders (evidence: `frontend/src/App.jsx`)
- Task entry → App state and API client: submits task (evidence: `frontend/src/App.jsx`)
- App state and API client → Active task list: renders active tasks (evidence: `frontend/src/App.jsx`)
- Active task list → Task card: renders cards (evidence: `frontend/src/components/TaskList.jsx`)
- App state and API client → Task card: renders completed tasks (evidence: `frontend/src/App.jsx`)
- Task card → App state and API client: requests task changes (evidence: `frontend/src/App.jsx`)
- App state and API client → Express server: sends task API requests (evidence: `frontend/src/App.jsx`)
- Express server → Task routes: mounts routes (evidence: `backend/src/index.js`)
- Task routes → Task operations: dispatches requests (evidence: `backend/src/routes/taskRoutes.js`)
- Task operations → SQLite connection: queries database (evidence: `backend/src/controllers/taskController.js`)
- SQLite connection → Task database: opens file (evidence: `backend/src/db/setup.js`)
- App state and API client → Theme toggle: renders (evidence: `frontend/src/App.jsx`)
- App state and API client → Pomodoro timer: renders (evidence: `frontend/src/App.jsx`)
- Pomodoro timer → Notification audio: plays alert (evidence: `frontend/src/components/Pomodoro.jsx`)
- App state and API client → Task statistics: passes tasks (evidence: `frontend/src/App.jsx`)
