# silentst/reactive_widget architecture

> Architecture diagram of the GitHub repository silentst/reactive_widget, 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/silentst/reactive_widget
- Repository: https://github.com/silentst/reactive_widget

## Overview

This is a small Flutter state-management library. Its documented workflow connects a ReactiveWidget view to a ReactiveWidgetModel, which owns ReactiveContainers; ReactiveBuilderWidget observes a container and rebuilds the relevant UI. ReactiveContainer also supports synchronous/asynchronous updates and optional value history. The tree includes a multi-container builder, but no excerpts or README details establish how it works or what calls it, so it is shown without inferred relationships.

Main entry points: [`lib/reactive/reactive_builder.dart`](https://github.com/silentst/reactive_widget/blob/main/lib/reactive/reactive_builder.dart) (ReactiveBuilderWidget), [`lib/reactive/reactive_widget.dart`](https://github.com/silentst/reactive_widget/blob/main/lib/reactive/reactive_widget.dart) (ReactiveWidget), [`lib/reactive/reactive_widget_model.dart`](https://github.com/silentst/reactive_widget/blob/main/lib/reactive/reactive_widget_model.dart) (ReactiveWidgetModel), [`lib/reactive/reactive_container.dart`](https://github.com/silentst/reactive_widget/blob/main/lib/reactive/reactive_container.dart) (ReactiveContainer)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_view_model["View model"]
  node_reactive_widget["ReactiveWidget"]
  node_widget_model["ReactiveWidgetModel"]
end

subgraph group_state["Reactive state"]
  node_container["ReactiveContainer"]
end

subgraph group_builders["UI builders"]
  node_builder["ReactiveBuilderWidget"]
  node_multi_builder["Multi reactive builder"]
end

node_flutter_app(("Flutter app"))

node_flutter_app -->|"uses as view"| node_reactive_widget
node_reactive_widget -->|"builds model"| node_widget_model
node_widget_model -->|"owns state"| node_container
node_builder -->|"observes values"| node_container
node_builder -->|"renders UI"| node_flutter_app

click node_reactive_widget "https://github.com/silentst/reactive_widget/blob/main/lib/reactive/reactive_widget.dart"
click node_widget_model "https://github.com/silentst/reactive_widget/blob/main/lib/reactive/reactive_widget_model.dart"
click node_container "https://github.com/silentst/reactive_widget/blob/main/lib/reactive/reactive_container.dart"
click node_builder "https://github.com/silentst/reactive_widget/blob/main/lib/reactive/reactive_builder.dart"
click node_multi_builder "https://github.com/silentst/reactive_widget/blob/main/lib/reactive/multi_reactive_builder.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_reactive_widget,node_widget_model toneBlue
class node_container toneAmber
class node_builder,node_multi_builder toneMint
class node_flutter_app toneIndigo
```

## Components

### View model

- [ReactiveWidget](https://github.com/silentst/reactive_widget/blob/main/lib/reactive/reactive_widget.dart): `lib/reactive/reactive_widget.dart`
- [ReactiveWidgetModel](https://github.com/silentst/reactive_widget/blob/main/lib/reactive/reactive_widget_model.dart): `lib/reactive/reactive_widget_model.dart`

### Reactive state

- [ReactiveContainer](https://github.com/silentst/reactive_widget/blob/main/lib/reactive/reactive_container.dart): `lib/reactive/reactive_container.dart`

### UI builders

- [ReactiveBuilderWidget](https://github.com/silentst/reactive_widget/blob/main/lib/reactive/reactive_builder.dart): `lib/reactive/reactive_builder.dart`
- [Multi reactive builder](https://github.com/silentst/reactive_widget/blob/main/lib/reactive/multi_reactive_builder.dart): `lib/reactive/multi_reactive_builder.dart`

### Other components

- **Flutter app**

## Connections

- Flutter app → ReactiveWidget: uses as view (evidence: `README.md`)
- ReactiveWidget → ReactiveWidgetModel: builds model (evidence: `README.md`)
- ReactiveWidgetModel → ReactiveContainer: owns state (evidence: `README.md`)
- ReactiveBuilderWidget → ReactiveContainer: observes values (evidence: `README.md`)
- ReactiveBuilderWidget → Flutter app: renders UI (evidence: `README.md`)
