Disco #

A modern, convenient, simple and safe way to do scoped dependency injection in Flutter.

For learning how to use Disco, see its documentation: >>> https://disco.mariuti.com <<<

Features #

• Scoped dependency injection
• Service locator
• Testable
• Independent of state management solutions
  • This library focuses on DI, so that state management solutions can focus on the reactivity.

Usage #

Creating a provider #

final modelProvider = Provider((context) => Model());

Providing a provider #

ProviderScope(
  providers: [modelProvider],
  child: MyWidget(),
)

Retrieving a provider #

final model = modelProvider.of(context);

You can retrieve a provider from any widget in the subtree of the ProviderScope where the provider has been provided.

Examples #

There are multiple examples on the repository (the examples folder and the single example inside the disco package).

Additional information #

This library can be used in combination with many existing packages.

State management #

This package is not opinionated about reactivity: feel free to use your state management solution of choice (as long as it is compatible with the concepts of the library).

Compatible solutions

Compatible state management solutions are those whose signals/observables can be created locally and passed as arguments, such as

• solidart (NB: its providers up to version 2.0.0-dev.2 will be replaced with the ones present in disco),
• ValueNotifier/ChangeNotifier (from Flutter)
• bloc (NB: the usage of BlocProvider should be replaced with the providers present in this library).

Our repository includes one example with solidart and one with bloc.

Incompatible solutions

State management solution entirely leveraging global state, such as riverpod, are not compatible with this library.

Contributions #

The purpose of this package is to simplify dependency injection for everyone. PRs are welcome, especially for documentation and more examples. Another goal of this library is to be simple. PRs introducing new features or breaking changes will have to be explained in detail.