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.

Libraries

disco
Disco is a Flutter library offering convenient, scoped providers for dependency injection that are independent of any specific state management solution.