# brianegan/flutter_architecture_samples architecture

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

- Interactive diagram: https://gitdiagram.com/brianegan/flutter_architecture_samples
- Repository: https://github.com/brianegan/flutter_architecture_samples

## Overview

This repository is a set of Flutter TodoMVC samples comparing state-management and application-architecture approaches. The documented user workflow is interacting with the todo app; each sample demonstrates a different way to manage state and update widgets. The supplied tree contains platform runners but not the Dart application sources, so sample-specific implementation details and internal call paths cannot be verified; the graph uses README-documented relationships and sample directory paths.

Main entry points: [`vanilla`](https://github.com/brianegan/flutter_architecture_samples/tree/main/vanilla) (Vanilla state), [`inherited_widget`](https://github.com/brianegan/flutter_architecture_samples/tree/main/inherited_widget) (InheritedWidget), [`change_notifier_provider`](https://github.com/brianegan/flutter_architecture_samples/tree/main/change_notifier_provider) (ChangeNotifier Provider), [`freezed_provider_value_notifier`](https://github.com/brianegan/flutter_architecture_samples/tree/main/freezed_provider_value_notifier) (Freezed ValueNotifier)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_product["Todo product"]
  node_todo["TodoMVC app"]
end

subgraph group_samples["Architecture samples"]
  node_vanilla["Vanilla state"]
  node_inherited["InheritedWidget"]
  node_provider["ChangeNotifier Provider"]
  node_freezed["Freezed ValueNotifier"]
  node_bloc["BLoC streams"]
  node_bloclib["Bloc library"]
  node_mobx["MobX"]
  node_redux["Redux"]
  node_simplebloc["Simple BLoC"]
  node_signals["Signals"]
  node_mvi["MVI"]
  node_scoped["scoped_model"]
end

subgraph group_state["State approaches"]
  node_statepatterns["State management"]
end

node_user(("Todo user"))

node_user -->|"uses"| node_todo
node_vanilla -->|"implements"| node_todo
node_inherited -->|"implements"| node_todo
node_provider -->|"implements"| node_todo
node_freezed -->|"implements"| node_todo
node_bloc -->|"implements"| node_todo
node_bloclib -->|"implements"| node_todo
node_mobx -->|"implements"| node_todo
node_redux -->|"implements"| node_todo
node_simplebloc -->|"implements"| node_todo
node_signals -->|"implements"| node_todo
node_mvi -->|"implements"| node_todo
node_scoped -->|"implements"| node_todo
node_vanilla -->|"manages state"| node_statepatterns
node_inherited -->|"passes app state"| node_statepatterns
node_provider -->|"manages state"| node_statepatterns
node_freezed -->|"uses ValueNotifier"| node_statepatterns
node_bloc -->|"streams state"| node_statepatterns
node_bloclib -->|"manages state"| node_statepatterns
node_mobx -->|"uses reactions"| node_statepatterns
node_redux -->|"manages state"| node_statepatterns
node_simplebloc -->|"streams state"| node_statepatterns
node_signals -->|"manages state"| node_statepatterns
node_mvi -->|"applies MVI"| node_statepatterns
node_scoped -->|"holds app state"| node_statepatterns

click node_vanilla "https://github.com/brianegan/flutter_architecture_samples/tree/main/vanilla"
click node_inherited "https://github.com/brianegan/flutter_architecture_samples/tree/main/inherited_widget"
click node_provider "https://github.com/brianegan/flutter_architecture_samples/tree/main/change_notifier_provider"
click node_freezed "https://github.com/brianegan/flutter_architecture_samples/tree/main/freezed_provider_value_notifier"
click node_bloc "https://github.com/brianegan/flutter_architecture_samples/tree/main/bloc_flutter"
click node_bloclib "https://github.com/brianegan/flutter_architecture_samples/tree/main/bloc_library"
click node_mobx "https://github.com/brianegan/flutter_architecture_samples/tree/main/mobx"
click node_redux "https://github.com/brianegan/flutter_architecture_samples/tree/main/redux"
click node_simplebloc "https://github.com/brianegan/flutter_architecture_samples/tree/main/simple_bloc_flutter"
click node_signals "https://github.com/brianegan/flutter_architecture_samples/tree/main/signals"
click node_mvi "https://github.com/brianegan/flutter_architecture_samples/tree/main/mvi_flutter"
click node_scoped "https://github.com/brianegan/flutter_architecture_samples/tree/main/scoped_model"

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_todo,node_user toneBlue
class node_vanilla,node_inherited,node_provider,node_freezed,node_bloc,node_bloclib,node_mobx,node_redux,node_simplebloc,node_signals,node_mvi,node_scoped toneAmber
class node_statepatterns toneMint
```

## Components

### Todo product

- **TodoMVC app**

### Architecture samples

- [Vanilla state](https://github.com/brianegan/flutter_architecture_samples/tree/main/vanilla): `vanilla`
- [InheritedWidget](https://github.com/brianegan/flutter_architecture_samples/tree/main/inherited_widget): `inherited_widget`
- [ChangeNotifier Provider](https://github.com/brianegan/flutter_architecture_samples/tree/main/change_notifier_provider): `change_notifier_provider`
- [Freezed ValueNotifier](https://github.com/brianegan/flutter_architecture_samples/tree/main/freezed_provider_value_notifier): `freezed_provider_value_notifier`
- [BLoC streams](https://github.com/brianegan/flutter_architecture_samples/tree/main/bloc_flutter): `bloc_flutter`
- [Bloc library](https://github.com/brianegan/flutter_architecture_samples/tree/main/bloc_library): `bloc_library`
- [MobX](https://github.com/brianegan/flutter_architecture_samples/tree/main/mobx): `mobx`
- [Redux](https://github.com/brianegan/flutter_architecture_samples/tree/main/redux): `redux`
- [Simple BLoC](https://github.com/brianegan/flutter_architecture_samples/tree/main/simple_bloc_flutter): `simple_bloc_flutter`
- [Signals](https://github.com/brianegan/flutter_architecture_samples/tree/main/signals): `signals`
- [MVI](https://github.com/brianegan/flutter_architecture_samples/tree/main/mvi_flutter): `mvi_flutter`
- [scoped_model](https://github.com/brianegan/flutter_architecture_samples/tree/main/scoped_model): `scoped_model`

### State approaches

- **State management**

### Other components

- **Todo user**

## Connections

- Todo user → TodoMVC app: uses (evidence: `README.md`)
- Vanilla state → TodoMVC app: implements (evidence: `README.md`)
- InheritedWidget → TodoMVC app: implements (evidence: `README.md`)
- ChangeNotifier Provider → TodoMVC app: implements (evidence: `README.md`)
- Freezed ValueNotifier → TodoMVC app: implements (evidence: `README.md`)
- BLoC streams → TodoMVC app: implements (evidence: `README.md`)
- Bloc library → TodoMVC app: implements (evidence: `README.md`)
- MobX → TodoMVC app: implements (evidence: `README.md`)
- Redux → TodoMVC app: implements (evidence: `README.md`)
- Simple BLoC → TodoMVC app: implements (evidence: `README.md`)
- Signals → TodoMVC app: implements (evidence: `README.md`)
- MVI → TodoMVC app: implements (evidence: `README.md`)
- scoped_model → TodoMVC app: implements (evidence: `README.md`)
- Vanilla state → State management: manages state (evidence: `README.md`)
- InheritedWidget → State management: passes app state (evidence: `README.md`)
- ChangeNotifier Provider → State management: manages state (evidence: `README.md`)
- Freezed ValueNotifier → State management: uses ValueNotifier (evidence: `README.md`)
- BLoC streams → State management: streams state (evidence: `README.md`)
- Bloc library → State management: manages state (evidence: `README.md`)
- MobX → State management: uses reactions (evidence: `README.md`)
- Redux → State management: manages state (evidence: `README.md`)
- Simple BLoC → State management: streams state (evidence: `README.md`)
- Signals → State management: manages state (evidence: `README.md`)
- MVI → State management: applies MVI (evidence: `README.md`)
- scoped_model → State management: holds app state (evidence: `README.md`)
