reactter 5.0.0-dev.1 reactter: ^5.0.0-dev.1 copied to clipboard
A light, powerful and quick Reactive State Management, Dependency Injection and Event Management.
A light, powerful and quick Reactive State Management, Dependency Injection and Event Management.
Features #
- ⚡️ Build for speed.
- ⚖️ Super lightweight(🥇 See benchmarks).
- 📏 Reduce boilerplate code significantly(🥇 See benchmarks).
- 📝 Improve code readability.
- 💧 Adaptable to any architecture.
- ☢️ Reactive state using Signal.
- ♻️ Reuse state creating custom hooks.
- 🪄 No configuration necessary.
- 🎮 Total control to re-render widget tree.
- 💙 Dart or Flutter, supports the latest version of Dart.
Let's see a small and simple example:
import 'dart:async';
import 'package:flutter/material.dart';
import 'package:flutter_reactter/flutter_reactter.dart';
// Create a reactive state using `Signal`
final count = 0.signal;
void main() {
// Put on listen `didUpdate` event, whitout use `Stream`
Reactter.on(count, Lifecycle.didUpdate, (_, __) => print('Count: $count'));
// Change the `value` in any time.
Timer.periodic(Duration(seconds: 1), (_) => count.value++);
// And you can use in flutter like this:
runApp(
MaterialApp(
home: Scaffold(
body: Center(
child: ReactterWatcher(
builder: (context, child) {
// This will be re-built, at each count change.
return Text(
"$count",
style: Theme.of(context).textTheme.headline3,
);
},
),
),
),
),
);
}
Clean and easy!
See more examples here!
Contents #
- Quickstart
- About Reactter
- State management
- Dependency injection
- Shortcuts to manage instances
- UseContext
- ReactterProvider (
flutter_reactter
) - ReactterProviders (
flutter_reactter
) - ReactterComponent (
flutter_reactter
)
- LifeCycle and event management
- Shortcuts to manage events
- UseEvent
- UseEffect
- ReactterWatcher (
flutter_reactter
) - BuildContext extension (
flutter_reactter
)
- Resources
- Contribute
- Authors
Quickstart #
Before anything, you need to be aware that Reactter is distributed on two packages, with slightly different usage.
The package of Reactter that you will want to install depends on the project type you are making.
Select one of the following options to know how to install it:
Dart only
Add the package on your project.
-
Using command:
dart pub add reactter
-
Or put directly into
pubspec.yaml
file:dependencies: reactter: #add version here
and run
dart pub get
.
Now in your Dart code, you can use:
import 'package:reactter/reactter.dart';
Flutter
Add the package on your project.
-
Using command:
flutter pub add flutter_reactter
-
Or put directly into
pubspec.yaml
file:dependencies: flutter_reactter: #add version here
and run
flutter pub get
.
Now in your Dart code, you can use:
import 'package:flutter_reactter/flutter_reactter.dart';
About Reactter #
Reactter is a light and powerful solution for Dart and Flutter. It is composed of three main concepts that can be used together to create maintainable and scalable applications, which are:
State management #
In Reactter, state is understood as any object that extendsReactterState
, which gives it features such as being able to store one or more values and to notify of its changes.
Reactter offers the following several state managers:
NOTE: The hooks (also known as
ReactterHook
) are named with the prefixUse
according to convention.RECOMMENDED: See also different between Signal and UseState and about custom hooks.
Signal #
Signal
is an object (that extends ReactterState
) which has a value
and notifies about its changes.
It can be initialized using the extension .signal
:
final strSignal = "initial value".signal;
final intSignal = 0.signal;
final userSignal = User().signal;
or using the constructor class Signal<Type>(InitialValue)
:
final strSignal = Signal<String>("initial value");
final intSignal = Signal<int>(0);
final userSignal = Signal<User>(User());
Signal
has value
property that allows to read and write its state:
intSignal.value = 10;
print("Current state: ${intSignal.value}");
or also can use the callable function:
intSignal(10);
print("Current state: ${intSignal()}");
or simply use .toString()
implicit to get its value
as String:
print("Current state: $intSignal");
NOTE:
Signal
notifies that itsvalue
has changed when the previousvalue
is different from the currentvalue
. If itsvalue
is aObject
, not detect internal changes, only whenvalue
is setted anotherObject
.
Use update
method to notify changes after run a set of instructions:
userSignal.update((user) {
user.firstname = "Firstname";
user.lastname = "Lastname";
});
Use refresh
method to force to notify changes.
userSignal.refresh();
When value
is changed, the Signal
will emitted the following events(learn about it here):
Lifecycle.willUpdate
event is triggered before thevalue
change orupdate
,refresh
methods have been invoked.Lifecicle.didUpdate
event is triggered after thevalue
change orupdate
,refresh
methods have been invoked.
NOTE: When you do any arithmetic operation between two
Signal
s, its return aObj
, for example:1.signal + 2.signal
return3.obj
. AObj
is like aSignal
without reactive functionality, but you can convert it toSignal
using.toSignal
.
NOTE: In flutter, using
ReactterWatcher
, it's a way to keep the widgets automatically updates, accessing the value of signal reactively.
UseState #
UseState
is a hook(ReactterHook
) that allows to declare state variables and manipulate its value
, which in turn notifies about its changes.
It can be declared inside a class, like this:
class CounterController {
final count = UseState(0);
}
UseState
has value
property that allows to read and write its state:
class CounterController {
final count = UseState(0);
CounterController() {
print("Prev state: ${count.value}");
count.value = 10;
print("Current state: ${count.value}");
}
}
NOTE:
UseState
notifies that itsvalue
has changed when the previousvalue
is different from the currentvalue
. If itsvalue
is aObject
, not detect internal changes, only whenvalue
is setted anotherObject
.
Use update
method to notify changes after run a set of instructions:
userState.update((user) {
user.firstname = "Firstname";
user.lastname = "Lastname";
});
Use refresh
method to force to notify changes.
userState.refresh();
When value
is changed, the UseState
will emitted the following events(learn about it here):
Lifecycle.willUpdate
event is triggered before thevalue
change orupdate
,refresh
methods have been invoked.Lifecicle.didUpdate
event is triggered after thevalue
change orupdate
,refresh
methods have been invoked.
Different between Signal and UseState #
Both UseState
and Signal
represent a state(ReactterState
). But there are a few featues that are different between them.
UseState
is a ReactterHook
, therefore unlike a Signal
, it can be extended and given new capabilities.
Use of the value
attribute is required each time UseState
reads or writes its state. However, Signal
eliminates the need for it, making the code easier to understand.
In Flutter, when you want to use UseState
, you must expose the containing parent class to the widget tree through a ReactterProvider
or ReactterComponent
and access it using BuildContext
. Instead, with Signal
which is reactive, you simply use ReactterWatcher
.
But it is not all advantages for Signal
, although it is good for global states and for improving code readability, it is prone to antipatterns and makes debugging difficult(This will be improved in the following versions).
The decision between which one to use is yours. You can use one or both without them getting in the way. And you can even replace a UseState
with a Signal
at any time.
UseAsyncState #
UseAsyncState
is a hook(ReactterHook
) with the same feature as UseState
but provides a asyncValue
method, which will be obtained when resolve
method is executed.
This is an translate example:
class TranslateArgs {
final String text;
final String from;
final String to;
TranslateArgs({ this.text, this.from, this.to, });
}
class TranslateController {
final translateState = UseAsyncStates<String?, TranslateArgs>(
null,
translate
);
TranslateController() {
translateState.resolve(
TranslateArgs({
text: 'Hello world',
from: 'EN',
to: 'ES',
}),
).then((_) {
print("'Hello world' translated to Spanish: '${translateState.value}'");
});
}
Future<String> translate([TranslateArgs args]) async {
// this is fake code, which simulates a request to API
return await api.translate(args);
}
}
NOTE: If you want to send argument to
asyncValue
method, need to define a type argument which be send throughresolve
method. Like the example shown above, the argument type send isTranslateArgs
class.
Use when
method to returns a computed value depending on it's state:
final computedValue = asyncState.when<String>(
standby: (value) => "⚓️ Standby: $value",
loading: (value) => "⏳ Loading...",
done: (value) => "✅ Resolved: $value",
error: (error) => "❌ Error: $error",
);
When value
is changed, the UseAsynState
will emitted the following events(learn about it here):
Lifecycle.willUpdate
event is triggered before thevalue
change orupdate
,refresh
methods have been invoked.Lifecicle.didUpdate
event is triggered after thevalue
change orupdate
,refresh
methods have been invoked.
UseReducer #
UseReducer
is a hook(ReactterHook
) that manages state using reducer method. An alternative to UseState
.
RECOMMENDED:
UseReducer
is usually preferable toUseState
when you have complex state logic that involves multiple sub-values or when the next state depends on the previous one.
UseReducer
accepts two arguments:
UseReducer(<reducer>, <initialState>);
- The
reducer
method contains your custom state logic that calculates the new state using current state, and actions. - The
initialState
is a unique value of any type with which you initialize the state.
UseReducer
exposes a dispatch
method that allows to invoke the reducer
method sending a ReactterAction
.
The current state can be access through value
property.
Here's the counter example using UseReducer
:
class Store {
final int count;
Store({this.count = 0});
}
Store reducer(Store state, ReactterAction<int?> action) {
switch (action.type) {
case 'INCREMENT':
return Store(count: state.count + (action.payload ?? 1));
case 'DECREMENT':
return Store(count: state.count + (action.payload ?? 1));
default:
throw UnimplementedError();
}
}
class CounterController {
final useCounter = UseReducer(reducer, Store(count: 0));
CounterController() {
print("count: ${useCounter.value.count}"); // count: 0;
useCounter.dispatch(ReactterAction(type: 'INCREMENT', payload: 2));
print("count: ${useCounter.value.count}"); // count: 2;
useCounter.dispatch(ReactterAction(type: 'DECREMENT'));
print("count: ${useCounter.value.count}"); // count: 1;
}
}
The actions can be created as a callable class, extending from ReactterActionCallable
and used as follows:
class Store {
final int count;
Store({this.count = 0});
}
class IncrementAction extends ReactterActionCallable<Store, int> {
IncrementAction({int quantity = 1}) : super(type: 'INCREEMNT', payload: quantity);
@override
Store call(Store state) => Store(count: state.count + payload);
}
class DecrementAction extends ReactterActionCallable<Store, int> {
DecrementAction({int quantity = 1}) : super(type: 'DECREMENT', payload: quantity);
@override
Store call(Store state) => Store(count: state.count - payload);
}
Store reducer(Store state, ReactterAction action) =>
action is ReactterActionCallable ? action(state) : UnimplementedError();
class CounterController {
final useCounter = UseReducer(reducer , Store(count: 0));
CounterController() {
print("count: ${useCounter.value.count}"); // count: 0;
useCounter.dispatch(IncrementAction(quantity: 2));
print("count: ${useCounter.value.count}"); // count: 2;
useCounter.dispatch(DecrementAction());
print("count: ${useCounter.value.count}"); // count: 1;
}
}
When value
is changed, the UseReducer
will emitted the following events(learn about it here):
Lifecycle.willUpdate
event is triggered before thevalue
change orupdate
,refresh
methods have been invoked.Lifecicle.didUpdate
event is triggered after thevalue
change orupdate
,refresh
methods have been invoked.
Custom hooks #
Custom hooks are classes that extend ReactterHook
that follow a special naming convention with the use
prefix and can contain state logic, effects or any other custom code.
There are several advantages to using Custom Hooks:
- Reusability: you can use the same hook again and again, without the need to write it twice.
- Clean Code: extracting part of context logic into a hook will provide a cleaner codebase.
- Maintainability: easier to maintain. if you need to change the logic of the hook, you only need to change it once.
Here's the counter example:
class UseCount extends ReactterHook {
int _count = 0;
int get value => _count;
UseCount(int initial) : _count = initial;
void increment() => update(() => _count += 1);
void decrement() => update(() => _count -= 1);
}
NOTE:
ReactterHook
providesupdate
method which notifies about its changed.
You can then call that custom hook from anywhere in the code and get access to its shared logic:
class AppController {
final count = UseCount(0);
AppController() {
Timer.periodic(Duration(seconds: 1), (_) => count.increment());
// Tracking of changes via a useEffect
UseEffect(() {
print("UseEffect | Count: ${count.value}");
}, [count], this);
}
}
Dependency injection #
With Reactter, you can create, delete and access the desired object from a single location(ReactterInstanceManager
), and you can do it from anywhere in the code, thanks to reactter's dependency injection system.
Dependency injection offers several benefits. It promotes the principle of inversion of control, where the control over object creation and management is delegated to Reactter. This improves code modularity, reusability, and testability.It also simplifies the code by removing the responsibility of creating dependencies from individual classes, making them more focused on their core functionality.
Reactter offers the following several instance managers:
Shortcuts to manage instances #
Reactter offers several convenient shortcuts for managing instances:
-
Reactter.register
: This method registers abuilder
function, enabling the creation of an instance usingReactter.get
.Reactter.register(builder: () => AppController()); Reactter.register(id: "uniqueId", builder: () => AppController());
-
Reactter.unregister
: This method removes thebuilder
function, preventing the creation of the instance.Reactter.unregister<AppController>(); Reactter.unregister<AppController>("uniqueId");
-
Reactter.get
: This method retrieves a previously created instance or creates a new instance from thebuild
registered withreactter.register
.final appController = Reactter.get<AppController>(); final appControllerWithId = Reactter.get<AppController>(id: 'uniqueId');
-
Reactter.create
: This method registers, creates and retrieves the instance directly.final appController = Reactter.create(builder: () => AppController()); final appControllerWithId = Reactter.create(id: 'uniqueId', builder: () => AppController());
-
Reactter.delete
: This method deletes the instance but keep thebuilder
function.Reactter.delete<AppController>(); Reactter.delete<AppController>('uniqueId');
NOTE: These methods mentioned above are exposed by
ReactterInstanceManager
.NOTE: The scope of the registered instances is global. This indicates that using
Reactter.get
orUseContext
will allow you to access them from anywhere in the project.
UseContext #
UseContext
is a hook(ReactterHook
) that allows to get the T
instance with/without id
from dependency store when it's ready.
class AppController {
final useAuthController = UseContext<AuthController>();
// final useOtherControllerWithId = UseContext<OtherController>("UniqueId");
AuthController? authController = useAuthController.instance;
AppController() {
UseEffect(() {
authController = useAuthController.instance;
}, [useAuthController]);
}
}
Use instance
getter to get the T
instance.
Use UseEffect
hook as shown in the example above, to wait for the instance
to be created.
NOTE: The instance that you need to get, must be created by
Dependency injection
before.
ReactterProvider #
ReactterProvider
is a Widget (exclusive of flutter_reactter
) that hydrates from an T
instance to the Widget tree. The T
instance can be access through methods BuildContext extension:
ReactterProvider<CounterController>(
() => CounterController(),
builder: (counterController, context, child) {
context.watch<CounterController>();
// `context.watch` watches any CounterController changes for rebuild
return Text("count: ${counterController.count.value}");
},
)
Uses id
property to identify the T
instance.
Use child
property to pass a Widget which to be built once only.
It will be sent through the builder
callback, so you can incorporate it into your build.
RECOMMENDED: Dont's use Object with constructor parameters to prevent conflicts.
NOTE:
ReactteProvider
is a "scoped". So, thebuilder
callback will be rebuild, when the instance changes or anyReactterState
specified using the watch methods of BuildContext extension.
ReactterProviders #
ReactterProviders
is a Widget (exclusive of flutter_reactter
) that allows to use multiple ReactterProvider
as nested way.
ReactterProviders(
[
ReactterProvider(
() => AppController(),
),
ReactterProvider(
() => ConfigContext(),
id: 'App',
),
ReactterProvider(
() => ConfigContext(),
id: 'Dashboard'
),
],
builder: (context, child) {
final appController = context.use<AppController>();
final appConfigContext = context.use<ConfigContext>('App');
final dashboardConfigContext = context.use<ConfigContext>('Dashboard');
...
},
)
RECOMMENDED: Dont's use Object with constructor parameters to prevent conflicts.
NOTE:
ReactteProviders
is a "scoped". So, thebuilder
callback will be rebuild, when the instance changes or anyReactterState
specified using the watch methods of BuildContext extension.
ReactterComponent #
ReactterComponent
is a Widget (exclusive of flutter_reactter
) that provides ReactterProvider
features, whose T
instance defined is exposing trough render method.
class CounterComponent extends ReactterComponent<CounterController> {
const CounterComponent({Key? key}) : super(key: key);
@override
get builder => () => CounterController();
@override
void listenStates(counterController) => [counterController.count];
@override
Widget render(counterController, context) {
return Text("Count: ${counterController.count.value}");
}
}
Use builder
getter to define the instance creating method.
NOTE: If you don't use
builder
getter, theT
instance is not created and instead tried to be found it in the nearest ancestor where it was created.RECOMMENDED: Dont's use Object with constructor parameters to prevent conflicts.
Use id
getter to identify the T
instance:
Use listenStates
getter to define the states and with its changes rebuild the Widget tree defined in render
method.
Use listenAll
getter as true
to listen all the T
instance changes to rebuild the Widget tree defined in render
method.
LifeCycle and event management #
In Reactter, the states(ReactterState
) and the instances (managed by the dependency injection
) contain different stages, also known as LifeCycle
. This lifecycle's linked events are as follows:
Lifecycle.registered
: This event is triggered when the instance has been registered.Lifecycle.unregistered
: This event is triggered when the instance is no longer registered.Lifecycle.initialized
: This event is triggered when the instance has been initialized.Lifecycle.willMount
: This event(exclusive offlutter_reactter
) happens when the instance is going to be mounted in the widget tree.Lifecycle.didMount
: This event(exclusive offlutter_reactter
) happens after the instance has been successfully mounted in the widget tree.Lifecycle.willUpdate
: This event is triggered anytime the instance's state is about to be updated. The event parameter is aReactterState
.Lifecycle.didUpdate
: This event is triggered anytime the instance's state has been updated. The event parameter is aReactterState
.Lifecycle.willUnmount
: This event(exclusive offlutter_reactter
) happens when the instance is about to be unmounted from the widget tree.Lifecycle.destroyed
: This event is triggered when the instance has been destroyed.
Reactter offers the following several event managers:
Shortcuts to manage events #
Reactter offers several convenient shortcuts for managing events:
-
Reactter.on(<Object inst>, <enum event>, <Fuction callback>)
: Turns on the listen event. When the event(enum
) of instance(Object
) is emitted, thecallback
is called:void onDidUpdate(inst, state) => print("Instance: $inst, state: $state"); final appController = Reactter.get<AppController>(); Reactter.on(appController, Lifecycle.didUpdate, onDidUpdate); // or Reactter.on(ReactterInstance<AppController>(), Lifecycle.didUpdate, onDidUpdate);
-
Reactter.one(<Object inst>, <enum event>, <Fuction callback>)
: Turns on the listen event for only once. After the event(enum
) of instance(Object
) is emitted, thecallback
is called and ended.void onDidUpdate(inst, state) => print("Instance: $inst, state: $state"); final appController = Reactter.get<AppController>(); Reactter.on(appController, Lifecycle.didUpdate, onDidUpdate); // or Reactter.on(ReactterInstance<AppController>(), Lifecycle.didUpdate, onDidUpdate);
-
Reactter.off(<Object inst>, <enum event>, <Fuction callback>)
: Removes thecallback
from event(enum
) of instance(Object
).Reactter.off(appController, Lifecycle.didUpdate, onDidUpdate); // or Reactter.off(ReactterInstance<AppController>(), Lifecycle.didUpdate, onDidUpdate);
-
Reactter.emit(<Object inst>, <enum event>, <dynamic param>)
: Triggers an event(enum
) of instance(Object
) with or without theparam
given.Reactter.emit(appController, CustomEnum.EventName, "test param"); // or Reactter.emit(ReactterInstance<AppController>(), CustomEnum.EventName, "test param");
-
Reactter.emitAsync(<Object inst>, <enum event>, <dynamic param>)
: Triggers an event(enum
) of instance(Object
) with or without theparam
given as async way.await Reactter.emitAsync(appController, CustomEnum.EventName, "test param"); // or await Reactter.emitAsync(ReactterInstance<AppController>(), CustomEnum.EventName, "test param");
NOTE: These methods mentioned above are exposed by
ReactterEventManager
.NOTE: The
ReactterInstance
helps to find the instance for event.RECOMMENDED: Use the instance directly on event methods for optimal performance.
UseEvent #
UseEvent
is a hook(ReactterHook
) that allows to manager events.
Use on
method to listen for instance's event:
enum Events { SomeEvent };
void onSomeEvent(inst, param) {
print("$inst's Events.SomeEvent emitted with param: $param.");
}
UseEvent<AppController>().on(Events.SomeEvent, onSomeEvent);
Use off
method to stop listening instance's event:
UseEvent<AppController>().off(Events.SomeEvent, onSomeEvent);
Use one
method to listen for instance's event once:
UseEvent<AppController>().one(Events.SomeEvent, onSomeEvent);
Use emit
method to trigger a instance's event:
UseEvent<AppController>().emit(Events.SomeEvent, 'Parameter');
IMPORTANT: Don't forget to remove event using
off
or usingdispose
to remove all instance's events. Failure to do so could increase memory usage or have unexpected behaviors, such as events in permanent listening.RECOMMENDED: If you have the instance, use directly with
UseEvent.withInstance(<instance>)
for optimal performance.
UseEffect #
UseEffect
is a hook(ReactterHook
) that allows to manager side-effect.
UseEffect(
<<Function cleanup> Function callback>,
<ReactterState dependencies>[],
<Object instance>,
)
The side-effect logic into the callback
function is executed when dependencies
(List of ReactterState
) argument changes or instance
(Object) trigger LifeCycle.didMount
event.
If the callback
returns a function, then UseEffect
considers this as an effect cleanup
.
The cleanup
callback is executed, before callback
is called or instance
(Object) trigger LifeCycle.willUnmount
event:
Let's see an example with a counter that increments every second:
class AppController {
final count = UseState(0);
AppController() {
UseEffect((){
// Execute by count state changed or 'LifeCycle.didMount' event
print("Count: ${count.value}");
Future.delayed(const Duration(seconds: 1), () => count.value += 1);
return () {
// Cleanup - Execute before count state changed or 'LifeCycle.willUnmount' event
print("Cleanup executed");
};
}, [count], this);
}
}
Use UseEffect.dispatchEffect
instead of instance argument to execute a UseEffect
immediately.
UseEffect(
() => print("Excute immediately or by hook changes"),
[someState],
UseEffect.dispatchEffect
);
NOTE: If you don't add
instance
argument toUseEffect
, thecallback
don't execute on lifecycledidMount
, and thecleanup
don't execute on lifecyclewillUnmount
(thesesLifeCycle
events are used withflutter_reactter
only).
ReactterWatcher #
ReactterWatcher
is a Widget (exclusive of flutter_reactter
) that allows to listen all Signal
s contained in builder
property and rebuilt the Widget when it changes:
final count = 0.signal;
final flag = false.signal;
void increase() => count.value += 1;
void toggle() => flag(!flag.value);
class App extends StatelessWidget {
...
Widget build(context) {
return ReactterWatcher(
// This widget is rendered once only and passed through the `builder` method.
child: Row(
children: const [
ElevatedButton(
onPressed: increase,
child: Text("Increase"),
),
ElevatedButton(
onPressed: toggle,
child: Text("Toogle"),
),
],
),
builder: (context, child) {
// Rebuilds the Widget tree returned when `count` or `flag` are updated.
return Column(
children: [
Text("Count: $count"),
Text("Flag is: $flag"),
// Takes the Widget from the `child` property in each rebuild.
child,
],
);
},
);
}
}
BuildContext extension #
Reactter provides additional methods through BuildContext
to access to instance. These are following:
context.watch
: Gets theT
instance fromReactterProvider
's nearest ancestor and watches any instance changes orReactterState
changes declared in first paramater.
// watches any `AppController` changes
final appController = context.watch<AppController>();
// watches the states changes declared in first paramater.
final appController = context.watch<AppController>(
(inst) => [inst.stateA, inst.stateB],
);
context.watchId
: Gets theT
instance byid
fromReactterProvider
's nearest ancestor and watches instance changes orReactterState
changes declared in second paramater.
// watches any `ResourceController` by `id` changes
final resourceController = context.watchId<ResourceController>('UniqueId');
// watches the states changes declared in second paramater.
final resourceController = context.watchId<ResourceController>(
'UniqueId',
(inst) => [inst.stateA, inst.stateB],
);
context.use
: Gets theT
instance with/withoutid
fromReactterProvider
's nearest ancestor.
final appController = context.use<AppController>();
final resourceController = context.use<ResourceController>('UniqueId');
NOTE: These methods mentioned above uses
ReactterProvider.contextOf
NOTE:
context.watch
andcontext.watchId
watch all or some of the specifiedReactterState
dependencies, when any it will changes, re-built the Widgets tree in the scope ofReactterProvider
,ReactterComponent
or any Widget that exposes theBuildContext
likeBuild
,StatelessWidget
,StatefulWidget
.NOTE: A
ReactterState
can be aSignal
orReactterHook
(likeUseState
,UseAsynState
,UseReducer
or another Custom hooks).
Resources #
- Documentation
- Examples
Contribute #
If you want to contribute don't hesitate to create an issue or pull-request in Reactter repository.
You can:
- Provide new features.
- Report bugs.
- Report situations difficult to implement.
- Report an unclear error.
- Report unclear documentation.
- Add a new custom hook.
- Add a new widget.
- Add examples.
- Translate documentation.
- Write articles or make videos teaching how to use Reactter.
Any idea is welcome!