# quang-lam1412/todolist architecture

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

- Interactive diagram: https://gitdiagram.com/quang-lam1412/todolist
- Repository: https://github.com/quang-lam1412/todolist

## Overview

This is a small React to-do list app. A user enters tasks, views them split into incomplete and completed lists, and can edit, complete, or delete them; the list component owns state and persists changes in browser local storage. The graph includes the shared task shape and runtime prop validation as an internal layer. The README is empty, so capabilities and connections are based on the sampled source; performance reporting is also included because it is part of the runtime entry point.

Main entry points: [`my-app/src/components/TodoList/TodoList.tsx`](https://github.com/quang-lam1412/todolist/blob/main/my-app/src/components/TodoList/TodoList.tsx) (Todo controller), [`my-app/src/components/TaskInput/TaskInput.tsx`](https://github.com/quang-lam1412/todolist/blob/main/my-app/src/components/TaskInput/TaskInput.tsx) (Task input), [`my-app/src/components/TaskList/TaskList.tsx`](https://github.com/quang-lam1412/todolist/blob/main/my-app/src/components/TaskList/TaskList.tsx) (Task lists), [`my-app/src/@types/todo.type.ts`](https://github.com/quang-lam1412/todolist/blob/main/my-app/src/%40types/todo.type.ts) (Task type)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["App runtime"]
  node_entry["React entry<br/>[index.tsx]"]
  node_app["App shell<br/>[App.tsx]"]
  node_vitals["Vitals reporting<br/>[reportWebVitals.ts]"]
end

subgraph group_tasks["Task management"]
  node_todo["Todo controller<br/>[TodoList.tsx]"]
  node_input["Task input<br/>[TaskInput.tsx]"]
  node_lists["Task lists<br/>[TaskList.tsx]"]
  node_storage[("Browser storage")]
end

subgraph group_model["Task model"]
  node_tasktype["Task type<br/>[todo.type.ts]"]
  node_proptype["Task prop validation<br/>[todo.proptype.ts]"]
end

node_user(("User"))

node_entry -->|"renders"| node_app
node_entry -->|"reports metrics"| node_vitals
node_app -->|"renders"| node_todo
node_todo -->|"renders"| node_input
node_todo -->|"renders"| node_lists
node_todo -->|"reads and writes"| node_storage
node_input -->|"invokes callbacks"| node_todo
node_lists -->|"invokes callbacks"| node_todo
node_input -->|"uses type"| node_tasktype
node_lists -->|"uses type"| node_tasktype
node_todo -->|"uses type"| node_tasktype
node_input -->|"validates props"| node_proptype
node_lists -->|"validates props"| node_proptype
node_user -.->|"enters tasks"| node_input
node_user -.->|"manages tasks"| node_lists

click node_entry "https://github.com/quang-lam1412/todolist/blob/main/my-app/src/index.tsx"
click node_app "https://github.com/quang-lam1412/todolist/blob/main/my-app/src/App.tsx"
click node_vitals "https://github.com/quang-lam1412/todolist/blob/main/my-app/src/reportWebVitals.ts"
click node_todo "https://github.com/quang-lam1412/todolist/blob/main/my-app/src/components/TodoList/TodoList.tsx"
click node_input "https://github.com/quang-lam1412/todolist/blob/main/my-app/src/components/TaskInput/TaskInput.tsx"
click node_lists "https://github.com/quang-lam1412/todolist/blob/main/my-app/src/components/TaskList/TaskList.tsx"
click node_tasktype "https://github.com/quang-lam1412/todolist/blob/main/my-app/src/%40types/todo.type.ts"
click node_proptype "https://github.com/quang-lam1412/todolist/blob/main/my-app/src/PropTypes/todo.proptype.ts"

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_entry,node_app,node_vitals,node_user toneBlue
class node_todo,node_input,node_lists,node_storage toneAmber
class node_tasktype,node_proptype toneMint
```

## Components

### App runtime

- [React entry](https://github.com/quang-lam1412/todolist/blob/main/my-app/src/index.tsx): `my-app/src/index.tsx`
- [App shell](https://github.com/quang-lam1412/todolist/blob/main/my-app/src/App.tsx): `my-app/src/App.tsx`
- [Vitals reporting](https://github.com/quang-lam1412/todolist/blob/main/my-app/src/reportWebVitals.ts): `my-app/src/reportWebVitals.ts`

### Task management

- [Todo controller](https://github.com/quang-lam1412/todolist/blob/main/my-app/src/components/TodoList/TodoList.tsx): `my-app/src/components/TodoList/TodoList.tsx`
- [Task input](https://github.com/quang-lam1412/todolist/blob/main/my-app/src/components/TaskInput/TaskInput.tsx): `my-app/src/components/TaskInput/TaskInput.tsx`
- [Task lists](https://github.com/quang-lam1412/todolist/blob/main/my-app/src/components/TaskList/TaskList.tsx): `my-app/src/components/TaskList/TaskList.tsx`
- **Browser storage**

### Task model

- [Task type](https://github.com/quang-lam1412/todolist/blob/main/my-app/src/%40types/todo.type.ts): `my-app/src/@types/todo.type.ts`
- [Task prop validation](https://github.com/quang-lam1412/todolist/blob/main/my-app/src/PropTypes/todo.proptype.ts): `my-app/src/PropTypes/todo.proptype.ts`

### Other components

- **User**

## Connections

- React entry → App shell: renders (evidence: `my-app/src/index.tsx`)
- React entry → Vitals reporting: reports metrics (evidence: `my-app/src/index.tsx`)
- App shell → Todo controller: renders (evidence: `my-app/src/App.tsx`)
- Todo controller → Task input: renders (evidence: `my-app/src/components/TodoList/TodoList.tsx`)
- Todo controller → Task lists: renders (evidence: `my-app/src/components/TodoList/TodoList.tsx`)
- Todo controller → Browser storage: reads and writes (evidence: `my-app/src/components/TodoList/TodoList.tsx`)
- Task input → Todo controller: invokes callbacks (evidence: `my-app/src/components/TaskInput/TaskInput.tsx`)
- Task lists → Todo controller: invokes callbacks (evidence: `my-app/src/components/TaskList/TaskList.tsx`)
- Task input → Task type: uses type (evidence: `my-app/src/components/TaskInput/TaskInput.tsx`)
- Task lists → Task type: uses type (evidence: `my-app/src/components/TaskList/TaskList.tsx`)
- Todo controller → Task type: uses type (evidence: `my-app/src/components/TodoList/TodoList.tsx`)
- Task input → Task prop validation: validates props (evidence: `my-app/src/components/TaskInput/TaskInput.tsx`)
- Task lists → Task prop validation: validates props (evidence: `my-app/src/components/TaskList/TaskList.tsx`)
- User → Task input: enters tasks
- User → Task lists: manages tasks
