# llaollao902/todo_list_app architecture

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

- Interactive diagram: https://gitdiagram.com/llaollao902/todo_list_app
- Repository: https://github.com/llaollao902/todo_list_app

## Overview

This is a Flutter task-management app backed by Cloud Firestore. Users create, edit, complete, filter, organize, and delete tasks; the list reflects Firestore changes in real time across connected clients. The map separates screens and reusable UI from state, persistence, and the task model. README statements support the documented data-flow and CRUD edges; implementation details not shown in the excerpts are left unlinked or marked unverified.

Main entry points: [`lib/screens/task_list_screen.dart`](https://github.com/llaollao902/todo_list_app/blob/main/lib/screens/task_list_screen.dart) (Task list), [`lib/providers/task_provider.dart`](https://github.com/llaollao902/todo_list_app/blob/main/lib/providers/task_provider.dart) (Task provider), [`lib/main.dart`](https://github.com/llaollao902/todo_list_app/blob/main/lib/main.dart) (App entry), [`lib/screens/form_task_screen.dart`](https://github.com/llaollao902/todo_list_app/blob/main/lib/screens/form_task_screen.dart) (Task form)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["App UI"]
  node_app["App entry<br/>[main.dart]"]
  node_task_list["Task list"]
  node_task_form["Task form"]
  node_task_tile["Task tile<br/>[task_tile.dart]"]
  node_list_controls["List controls"]
  node_form_widgets["Form widgets"]
  node_undo_ui["Undo UI<br/>[undo_snackbar.dart]"]
  node_delete_dialog["Delete dialog"]
end

subgraph group_state["State and model"]
  node_provider["Task provider<br/>[task_provider.dart]"]
  node_task_model["Task model<br/>[task.dart]"]
end

subgraph group_data["Persistence"]
  node_service["Task service<br/>[task_service.dart]"]
  node_firestore[("Cloud Firestore")]
end

node_user(("User"))
node_other_client(("Other app clients"))

node_user -.->|"uses"| node_app
node_app -.->|"opens"| node_task_list
node_app -.->|"opens"| node_task_form
node_task_list -->|"renders updates"| node_provider
node_provider -->|"subscribes to stream"| node_firestore
node_provider -->|"converts documents"| node_task_model
node_service -->|"performs CRUD"| node_firestore
node_other_client -->|"writes changes"| node_firestore
node_firestore -->|"streams changes"| node_provider
node_task_list -.->|"shows tasks"| node_task_tile
node_task_list -.->|"offers filtering"| node_list_controls
node_task_form -.->|"uses fields"| node_form_widgets
node_task_list -->|"offers undo"| node_undo_ui
node_task_list -.->|"confirms deletion"| node_delete_dialog

click node_app "https://github.com/llaollao902/todo_list_app/blob/main/lib/main.dart"
click node_task_list "https://github.com/llaollao902/todo_list_app/blob/main/lib/screens/task_list_screen.dart"
click node_task_form "https://github.com/llaollao902/todo_list_app/blob/main/lib/screens/form_task_screen.dart"
click node_task_tile "https://github.com/llaollao902/todo_list_app/blob/main/lib/widgets/task_tile.dart"
click node_list_controls "https://github.com/llaollao902/todo_list_app/blob/main/lib/widgets/filter_sort_bar.dart"
click node_form_widgets "https://github.com/llaollao902/todo_list_app/tree/main/lib/widgets/task_form"
click node_undo_ui "https://github.com/llaollao902/todo_list_app/blob/main/lib/widgets/undo_snackbar.dart"
click node_delete_dialog "https://github.com/llaollao902/todo_list_app/blob/main/lib/widgets/delete_confirm_dialog.dart"
click node_provider "https://github.com/llaollao902/todo_list_app/blob/main/lib/providers/task_provider.dart"
click node_task_model "https://github.com/llaollao902/todo_list_app/blob/main/lib/models/task.dart"
click node_service "https://github.com/llaollao902/todo_list_app/blob/main/lib/services/task_service.dart"

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_list,node_task_form,node_task_tile,node_list_controls,node_form_widgets,node_undo_ui,node_delete_dialog,node_user,node_other_client toneBlue
class node_provider,node_task_model toneAmber
class node_service,node_firestore toneMint
```

## Components

### App UI

- [App entry](https://github.com/llaollao902/todo_list_app/blob/main/lib/main.dart): `lib/main.dart`
- [Task list](https://github.com/llaollao902/todo_list_app/blob/main/lib/screens/task_list_screen.dart): `lib/screens/task_list_screen.dart`
- [Task form](https://github.com/llaollao902/todo_list_app/blob/main/lib/screens/form_task_screen.dart): `lib/screens/form_task_screen.dart`
- [Task tile](https://github.com/llaollao902/todo_list_app/blob/main/lib/widgets/task_tile.dart): `lib/widgets/task_tile.dart`
- [List controls](https://github.com/llaollao902/todo_list_app/blob/main/lib/widgets/filter_sort_bar.dart): `lib/widgets/filter_sort_bar.dart`
- [Form widgets](https://github.com/llaollao902/todo_list_app/tree/main/lib/widgets/task_form): `lib/widgets/task_form`
- [Undo UI](https://github.com/llaollao902/todo_list_app/blob/main/lib/widgets/undo_snackbar.dart): `lib/widgets/undo_snackbar.dart`
- [Delete dialog](https://github.com/llaollao902/todo_list_app/blob/main/lib/widgets/delete_confirm_dialog.dart): `lib/widgets/delete_confirm_dialog.dart`

### State and model

- [Task provider](https://github.com/llaollao902/todo_list_app/blob/main/lib/providers/task_provider.dart): `lib/providers/task_provider.dart`
- [Task model](https://github.com/llaollao902/todo_list_app/blob/main/lib/models/task.dart): `lib/models/task.dart`

### Persistence

- [Task service](https://github.com/llaollao902/todo_list_app/blob/main/lib/services/task_service.dart): `lib/services/task_service.dart`
- **Cloud Firestore**

### Other components

- **User**
- **Other app clients**

## Connections

- User → App entry: uses
- App entry → Task list: opens
- App entry → Task form: opens
- Task list → Task provider: renders updates (evidence: `README.md`)
- Task provider → Cloud Firestore: subscribes to stream (evidence: `README.md`)
- Task provider → Task model: converts documents (evidence: `README.md`)
- Task service → Cloud Firestore: performs CRUD (evidence: `README.md`)
- Other app clients → Cloud Firestore: writes changes (evidence: `README.md`)
- Cloud Firestore → Task provider: streams changes (evidence: `README.md`)
- Task list → Task tile: shows tasks
- Task list → List controls: offers filtering
- Task form → Form widgets: uses fields
- Task list → Undo UI: offers undo (evidence: `README.md`)
- Task list → Delete dialog: confirms deletion
