Duit is a backend side UI framework for Flutter. It is used for creating widgets and server-side state management.
The framework consists of several parts:
- Flutter package (this repository)
- Go backend adapter
- Node JS backend adapter
The framework ensures that the layout model is received from the server, interacts with the backend via the Action API, and embeds custom components into the widget hierarchy processing pipeline. Duit is flexible and extensible, which allows it to create rich UI dynamically.
- Initial connection to the server and receiving a layout
- Support for different network protocols (http, websocket)
- Pointed widget state update (updating only those widgets for which the server returned an "update")
- Actions API. A special protocol that allows the server to specify dependencies for an action associated with a widget.
- Ability to add your own custom widgets on the Flutter and backend side.
The flutter_duit library depends on the duit_kernel package, which contains basic model definitions for implementing framework entities and developing third-party packages and extensions. Carefully study the version compatibility table if you are going to directly add duit_kernel to your project (needed to implement custom widgets and extensions).
| Lib versions | Kernel versions |
|---|---|
| <= v1.5.0 | v1.0.1 |
| >= v1.6.0 | v1.1.0 |
| >= v1.7.0 | v1.1.1 |
| >= v1.9.0 | v1.2.0 |
| >= v1.11.0 | v1.3.0 |
| >= v1.12.0 | v1.4.0 |
| >= v2.0.0 | v2.0.1 |
| >= v2.2.0 | v2.1.1 |
- If you want to use the advanced features of the framework, you should install a dependency on the duit_kernel package, which provides definitions of the basic abstractions on the basis of which custom widgets and third-party extensions are implemented.
flutter pub add duit_kernel
- Create DuitDriver instance.
It is responsible for displaying the UI, updating the state of widgets, and calling widget-related actions.
final driver = DuitDriver(
"/layout1",
transportOptions: HttpTransportOptions(
defaultHeaders: {"Content-Type": "application/json"},
baseUrl: "http://localhost:8999",
),
);- Embed the DuitViewHost widget into your application in the build method.
DuitViewHost(
driver: driver,
placeholder: const CircularProgressIndicator(),
),- Expanding the types of events generated by the server
- Expanding the widget collection
- Implementation of new network protocols (gRPC, socket.io)
- Adding new adapters for the backend (Dart, C#, etc.)
- Troubleshooting, updating documentation
MIT