# karttiktungenwar/note_app architecture

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

- Interactive diagram: https://gitdiagram.com/karttiktungenwar/note_app
- Repository: https://github.com/karttiktungenwar/note_app

## Overview

Note App is a Flutter note-taking client with authentication and note CRUD. The documented user workflow is to sign in, retain a session token locally, then create, view, update, search, or delete notes; the README says the app integrates with a REST backend for user data and notes. The tree shows separate presentation, domain, data, networking, and local-storage areas. Dart implementation excerpts were not provided, so internal call ownership is unverified; dashed edges mark likely links, while README-backed product relationships are solid.

Main entry points: [`lib/src/features/notes/presentation/screens/notes_page.dart`](https://github.com/karttiktungenwar/note_app/blob/main/lib/src/features/notes/presentation/screens/notes_page.dart) (Notes screen), [`lib/src/features/notes/data/repository/note_repository_impl.dart`](https://github.com/karttiktungenwar/note_app/blob/main/lib/src/features/notes/data/repository/note_repository_impl.dart) (Note repository), [`lib/src/features/login/data/repository/login_auth_repository_impl.dart`](https://github.com/karttiktungenwar/note_app/blob/main/lib/src/features/login/data/repository/login_auth_repository_impl.dart) (Auth repository), [`lib/main.dart`](https://github.com/karttiktungenwar/note_app/blob/main/lib/main.dart) (App entry)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Flutter App"]
  node_entry["App entry<br/>[main.dart]"]
end

subgraph group_auth["Authentication"]
  node_login_ui["Login screen<br/>[login_screen.dart]"]
  node_login_bloc["Login state"]
  node_auth_usecases["Auth actions"]
  node_auth_repo["Auth repository"]
  node_auth_remote["Remote auth"]
  node_auth_local["Local auth"]
end

subgraph group_notes["Notes"]
  node_notes_page["Notes screen<br/>[notes_page.dart]"]
  node_note_bloc["Notes state<br/>[note_bloc.dart]"]
  node_note_list["Note list<br/>[note_list.dart]"]
  node_note_item["Note item<br/>[note_item.dart]"]
  node_note_form["Note form<br/>[note_form.dart]"]
  node_note_usecases["Note actions"]
  node_note_repo["Note repository"]
  node_note_local["Local notes source"]
end

subgraph group_infra["Data and Services"]
  node_token_store["Secure token store"]
  node_login_api{{"Login API"}}
  node_note_db[("Notes database<br/>[app_database.dart]")]
  node_api_service["REST client<br/>[api_service.dart]"]
  node_backend{{"REST backend"}}
end

node_user(("Note taker"))

node_user -->|"uses"| node_entry
node_entry -.->|"offers sign-in"| node_login_ui
node_login_ui -.->|"dispatches events"| node_login_bloc
node_login_bloc -.->|"invokes"| node_auth_usecases
node_auth_usecases -.->|"requests auth"| node_auth_repo
node_auth_repo -.->|"uses"| node_auth_remote
node_auth_repo -.->|"uses"| node_auth_local
node_auth_remote -->|"sends login"| node_login_api
node_login_api -->|"authenticates"| node_backend
node_auth_local -->|"stores token"| node_token_store
node_user -->|"manages notes"| node_notes_page
node_notes_page -.->|"dispatches actions"| node_note_bloc
node_notes_page -.->|"presents notes"| node_note_list
node_note_list -.->|"renders"| node_note_item
node_notes_page -.->|"edits notes"| node_note_form
node_note_bloc -.->|"invokes"| node_note_usecases
node_note_usecases -.->|"requests CRUD"| node_note_repo
node_note_repo -.->|"uses"| node_note_local
node_note_local -.->|"reads and writes"| node_note_db
node_note_repo -->|"persists notes"| node_backend
node_note_repo -.->|"uses REST client"| node_api_service
node_api_service -.->|"exchanges data"| node_backend

click node_entry "https://github.com/karttiktungenwar/note_app/blob/main/lib/main.dart"
click node_login_ui "https://github.com/karttiktungenwar/note_app/blob/main/lib/src/features/login/presentation/screens/login_screen.dart"
click node_login_bloc "https://github.com/karttiktungenwar/note_app/blob/main/lib/src/features/login/presentation/bloc/login_auth_bloc.dart"
click node_auth_usecases "https://github.com/karttiktungenwar/note_app/tree/main/lib/src/features/login/domain/usecase"
click node_auth_repo "https://github.com/karttiktungenwar/note_app/blob/main/lib/src/features/login/data/repository/login_auth_repository_impl.dart"
click node_auth_remote "https://github.com/karttiktungenwar/note_app/blob/main/lib/src/features/login/data/data_source/login_auth_remote_data_source.dart"
click node_auth_local "https://github.com/karttiktungenwar/note_app/blob/main/lib/src/features/login/data/data_source/login_auth_local_data_source.dart"
click node_token_store "https://github.com/karttiktungenwar/note_app/blob/main/lib/src/core/local_storage/secure_storage_service.dart"
click node_notes_page "https://github.com/karttiktungenwar/note_app/blob/main/lib/src/features/notes/presentation/screens/notes_page.dart"
click node_note_bloc "https://github.com/karttiktungenwar/note_app/blob/main/lib/src/features/notes/presentation/bloc/note_bloc.dart"
click node_note_list "https://github.com/karttiktungenwar/note_app/blob/main/lib/src/features/notes/presentation/widgets/note_list.dart"
click node_note_item "https://github.com/karttiktungenwar/note_app/blob/main/lib/src/features/notes/presentation/widgets/note_item.dart"
click node_note_form "https://github.com/karttiktungenwar/note_app/blob/main/lib/src/features/notes/presentation/widgets/note_form.dart"
click node_note_usecases "https://github.com/karttiktungenwar/note_app/tree/main/lib/src/features/notes/domain/usecase"
click node_note_repo "https://github.com/karttiktungenwar/note_app/blob/main/lib/src/features/notes/data/repository/note_repository_impl.dart"
click node_note_local "https://github.com/karttiktungenwar/note_app/blob/main/lib/src/features/notes/data/data_source/note_local_data_source.dart"
click node_note_db "https://github.com/karttiktungenwar/note_app/blob/main/lib/src/core/database/app_database.dart"
click node_api_service "https://github.com/karttiktungenwar/note_app/blob/main/lib/src/core/network/api_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_entry toneBlue
class node_login_ui,node_login_bloc,node_auth_usecases,node_auth_repo,node_auth_remote,node_auth_local toneAmber
class node_notes_page,node_note_bloc,node_note_list,node_note_item,node_note_form,node_note_usecases,node_note_repo,node_note_local toneMint
class node_token_store,node_login_api,node_note_db,node_api_service,node_backend toneRose
class node_user toneIndigo
```

## Components

### Flutter App

- [App entry](https://github.com/karttiktungenwar/note_app/blob/main/lib/main.dart): `lib/main.dart`

### Authentication

- [Login screen](https://github.com/karttiktungenwar/note_app/blob/main/lib/src/features/login/presentation/screens/login_screen.dart): `lib/src/features/login/presentation/screens/login_screen.dart`
- [Login state](https://github.com/karttiktungenwar/note_app/blob/main/lib/src/features/login/presentation/bloc/login_auth_bloc.dart): `lib/src/features/login/presentation/bloc/login_auth_bloc.dart`
- [Auth actions](https://github.com/karttiktungenwar/note_app/tree/main/lib/src/features/login/domain/usecase): `lib/src/features/login/domain/usecase`
- [Auth repository](https://github.com/karttiktungenwar/note_app/blob/main/lib/src/features/login/data/repository/login_auth_repository_impl.dart): `lib/src/features/login/data/repository/login_auth_repository_impl.dart`
- [Remote auth](https://github.com/karttiktungenwar/note_app/blob/main/lib/src/features/login/data/data_source/login_auth_remote_data_source.dart): `lib/src/features/login/data/data_source/login_auth_remote_data_source.dart`
- [Local auth](https://github.com/karttiktungenwar/note_app/blob/main/lib/src/features/login/data/data_source/login_auth_local_data_source.dart): `lib/src/features/login/data/data_source/login_auth_local_data_source.dart`

### Notes

- [Notes screen](https://github.com/karttiktungenwar/note_app/blob/main/lib/src/features/notes/presentation/screens/notes_page.dart): `lib/src/features/notes/presentation/screens/notes_page.dart`
- [Notes state](https://github.com/karttiktungenwar/note_app/blob/main/lib/src/features/notes/presentation/bloc/note_bloc.dart): `lib/src/features/notes/presentation/bloc/note_bloc.dart`
- [Note list](https://github.com/karttiktungenwar/note_app/blob/main/lib/src/features/notes/presentation/widgets/note_list.dart): `lib/src/features/notes/presentation/widgets/note_list.dart`
- [Note item](https://github.com/karttiktungenwar/note_app/blob/main/lib/src/features/notes/presentation/widgets/note_item.dart): `lib/src/features/notes/presentation/widgets/note_item.dart`
- [Note form](https://github.com/karttiktungenwar/note_app/blob/main/lib/src/features/notes/presentation/widgets/note_form.dart): `lib/src/features/notes/presentation/widgets/note_form.dart`
- [Note actions](https://github.com/karttiktungenwar/note_app/tree/main/lib/src/features/notes/domain/usecase): `lib/src/features/notes/domain/usecase`
- [Note repository](https://github.com/karttiktungenwar/note_app/blob/main/lib/src/features/notes/data/repository/note_repository_impl.dart): `lib/src/features/notes/data/repository/note_repository_impl.dart`
- [Local notes source](https://github.com/karttiktungenwar/note_app/blob/main/lib/src/features/notes/data/data_source/note_local_data_source.dart): `lib/src/features/notes/data/data_source/note_local_data_source.dart`

### Data and Services

- [Secure token store](https://github.com/karttiktungenwar/note_app/blob/main/lib/src/core/local_storage/secure_storage_service.dart): `lib/src/core/local_storage/secure_storage_service.dart`
- **Login API**
- [Notes database](https://github.com/karttiktungenwar/note_app/blob/main/lib/src/core/database/app_database.dart): `lib/src/core/database/app_database.dart`
- [REST client](https://github.com/karttiktungenwar/note_app/blob/main/lib/src/core/network/api_service.dart): `lib/src/core/network/api_service.dart`
- **REST backend**

### Other components

- **Note taker**

## Connections

- Note taker → App entry: uses (evidence: `README.md`)
- App entry → Login screen: offers sign-in
- Login screen → Login state: dispatches events
- Login state → Auth actions: invokes
- Auth actions → Auth repository: requests auth
- Auth repository → Remote auth: uses
- Auth repository → Local auth: uses
- Remote auth → Login API: sends login (evidence: `README.md`)
- Login API → REST backend: authenticates (evidence: `README.md`)
- Local auth → Secure token store: stores token (evidence: `README.md`)
- Note taker → Notes screen: manages notes (evidence: `README.md`)
- Notes screen → Notes state: dispatches actions
- Notes screen → Note list: presents notes
- Note list → Note item: renders
- Notes screen → Note form: edits notes
- Notes state → Note actions: invokes
- Note actions → Note repository: requests CRUD
- Note repository → Local notes source: uses
- Local notes source → Notes database: reads and writes
- Note repository → REST backend: persists notes (evidence: `README.md`)
- Note repository → REST client: uses REST client
- REST client → REST backend: exchanges data
