Viewing version 7.1.0. Open the latest package page.

bloc

7.1.0

A predictable state management library that helps implement the BLoC (Business Logic Component) design pattern.

Download archive

Readme

A dart package that helps implement the BLoC pattern.

Learn more at bloclibrary.dev!

This package is built to work with:

Overview

The goal of this package is to make it easy to implement the BLoC Design Pattern (Business Logic Component).

This design pattern helps to separate presentation from business logic. Following the BLoC pattern facilitates testability and reusability. This package abstracts reactive aspects of the pattern allowing developers to focus on writing the business logic.

Cubit

Cubit Architecture

A Cubit is class which extends BlocBase and can be extended to manage any type of state. Cubit requires an initial state which will be the state before emit has been called. The current state of a cubit can be accessed via the state getter and the state of the cubit can be updated by calling emit with a new state.

Cubit Flow

State changes in cubit begin with predefined function calls which can use the emit method to output new states. onChange is called right before a state change occurs and contains the current and next state.

Creating a Cubit

/// A `CounterCubit` which manages an `int` as its state.
class CounterCubit extends Cubit<int> {
  /// The initial state of the `CounterCubit` is 0.
  CounterCubit() : super(0);

  /// When increment is called, the current state
  /// of the cubit is accessed via `state` and
  /// a new `state` is emitted via `emit`.
  void increment() => emit(state + 1);
}

Using a Cubit

void main() {
  /// Create a `CounterCubit` instance.
  final cubit = CounterCubit();

  /// Access the state of the `cubit` via `state`.
  print(cubit.state); // 0

  /// Interact with the `cubit` to trigger `state` changes.
  cubit.increment();

  /// Access the new `state`.
  print(cubit.state); // 1

  /// Close the `cubit` when it is no longer needed.
  cubit.close();
}

Observing a Cubit

onChange can be overridden to observe state changes for a single cubit.

onError can be overridden to observe errors for a single cubit.

class CounterCubit extends Cubit<int> {
  CounterCubit() : super(0);

  void increment() => emit(state + 1);

  @override
  void onChange(Change<int> change) {
    super.onChange(change);
    print(change);
  }

  @override
  void onError(Object error, StackTrace stackTrace) {
    print('$error, $stackTrace');
    super.onError(error, stackTrace);
  }
}

BlocObserver can be used to observe all cubits.

class MyBlocObserver extends BlocObserver {
  @override
  void onCreate(BlocBase bloc) {
    super.onCreate(bloc);
    print('onCreate -- ${bloc.runtimeType}');
  }

  @override
  void onChange(BlocBase bloc, Change change) {
    super.onChange(bloc, change);
    print('onChange -- ${bloc.runtimeType}, $change');
  }

  @override
  void onError(BlocBase bloc, Object error, StackTrace stackTrace) {
    print('onError -- ${bloc.runtimeType}, $error');
    super.onError(bloc, error, stackTrace);
  }

  @override
  void onClose(BlocBase bloc) {
    super.onClose(bloc);
    print('onClose -- ${bloc.runtimeType}');
  }
}

void main() {
  Bloc.observer = MyBlocObserver();
  // Use cubits...
}

Bloc

Bloc Architecture

A Bloc is a more advanced class which relies on events to trigger state changes rather than functions. Bloc also extends BlocBase which means it has a similar public API as Cubit. However, rather than calling a function on a Bloc and directly emitting a new state, Blocs receive events and convert the incoming events into outgoing states.

Bloc Flow

State changes in bloc begin when events are added which triggers onEvent. The events are then funnelled through transformEvents. By default, transformEvents uses asyncExpand to ensure each event is processed in the order it was added but it can be overridden to manipulate the incoming event stream. mapEventToState is then invoked with the transformed events and is responsible for yielding states in response to the incoming events. transitions are then funnelled through transformTransitions which can be overridden to manipulation the outgoing state changes. Lastly, onTransition is called just before the state is updated and contains the current state, event, and next state.

Creating a Bloc

/// The events which `CounterBloc` will react to.
enum CounterEvent { increment }

/// A `CounterBloc` which handles converting `CounterEvent`s into `int`s.
class CounterBloc extends Bloc<CounterEvent, int> {
  /// The initial state of the `CounterBloc` is 0.
  CounterBloc() : super(0);

  @override
  Stream<int> mapEventToState(CounterEvent event) async* {
    switch (event) {
      /// When a `CounterEvent.increment` event is added,
      /// the current `state` of the bloc is accessed via the `state` property
      /// and a new state is emitted via `yield`.
      case CounterEvent.increment:
        yield state + 1;
        break;
    }
  }
}

Using a Bloc

void main() async {
  /// Create a `CounterBloc` instance.
  final bloc = CounterBloc();

  /// Access the state of the `bloc` via `state`.
  print(bloc.state); // 0

  /// Interact with the `bloc` to trigger `state` changes.
  bloc.add(CounterEvent.increment);

  /// Wait for next iteration of the event-loop
  /// to ensure event has been processed.
  await Future.delayed(Duration.zero);

  /// Access the new `state`.
  print(bloc.state); // 1

  /// Close the `bloc` when it is no longer needed.
  bloc.close();
}

Observing a Bloc

Since all Blocs extend BlocBase just like Cubit, onChange and onError can be overridden in a Bloc as well.

In addition, Blocs can also override onEvent and onTransition.

onEvent is called any time a new event is added to the Bloc.

onTransition is similar to onChange, however, it contains the event which triggered the state change in addition to the currentState and nextState.

enum CounterEvent { increment }

class CounterBloc extends Bloc<CounterEvent, int> {
  CounterBloc() : super(0);

  @override
  Stream<int> mapEventToState(CounterEvent event) async* {
    switch (event) {
      case CounterEvent.increment:
        yield state + 1;
        break;
    }
  }

  @override
  void onEvent(CounterEvent event) {
    super.onEvent(event);
    print(event);
  }

  @override
  void onChange(Change<int> change) {
    super.onChange(change);
    print(change);
  }

  @override
  void onTransition(Transition<CounterEvent, int> transition) {
    super.onTransition(transition);
    print(transition);
  }

  @override
  void onError(Object error, StackTrace stackTrace) {
    print('$error, $stackTrace');
    super.onError(error, stackTrace);
  }
}

BlocObserver can be used to observe all blocs as well.

class MyBlocObserver extends BlocObserver {
  @override
  void onCreate(BlocBase bloc) {
    super.onCreate(bloc);
    print('onCreate -- ${bloc.runtimeType}');
  }

  @override
  void onEvent(Bloc bloc, Object? event) {
    super.onEvent(bloc, event);
    print('onEvent -- ${bloc.runtimeType}, $event');
  }

  @override
  void onChange(BlocBase bloc, Change change) {
    super.onChange(bloc, change);
    print('onChange -- ${bloc.runtimeType}, $change');
  }

  @override
  void onTransition(Bloc bloc, Transition transition) {
    super.onTransition(bloc, transition);
    print('onTransition -- ${bloc.runtimeType}, $transition');
  }

  @override
  void onError(BlocBase bloc, Object error, StackTrace stackTrace) {
    print('onError -- ${bloc.runtimeType}, $error');
    super.onError(bloc, error, stackTrace);
  }

  @override
  void onClose(BlocBase bloc) {
    super.onClose(bloc);
    print('onClose -- ${bloc.runtimeType}');
  }
}

void main() {
  Bloc.observer = MyBlocObserver();
  // Use blocs...
}

Dart Versions

Dart 2: >= 2.12

Examples

Counter - an example of how to create a CounterBloc in a pure Dart app.

Maintainers

Felix Angelov

Changelog

7.1.0

feat: expose isClosed getter on BlocBase
refactor: simplify internal event controller initialization
docs: update onChange description in README
docs: update GetStream sponsorship urls

7.0.0

BREAKING: refactor: Bloc and Cubit extend BlocBase
- refactor: void onError(Cubit cubit, Object error, StackTrace stackTrace) -> void onError(BlocBase bloc, Object error, StackTrace stackTrace)
- refactor: void onCreate(Cubit cubit) -> void onCreate(BlocBase bloc)
- refactor: void onClose(Cubit cubit) -> void onClose(BlocBase bloc)
BREAKING: refactor: Bloc and Cubit do not extend Stream and implement Sink
- refactor: use bloc.stream or cubit.stream to access Stream<State>
  - myBloc.map(...) -> myBloc.stream.map(...)
- refactor: deprecate bloc.listen in favor of bloc.stream.listen
BREAKING: refactor: CubitUnhandledErrorException -> BlocUnhandledErrorException
BREAKING: opt into null safety
- feat!: upgrade Dart SDK constraints to >=2.12.0-0 <3.0.0
fix: transformEvents multiple subscriptions issue
test: improve testing for advanced transformEvents behavior
chore: bump to meta: ^1.3.0

7.0.0-nullsafety.4

BREAKING: refactor: Bloc and Cubit extend BlocBase
- refactor: void onError(Bloc bloc, Object error, StackTrace stackTrace) -> void onError(BlocBase bloc, Object error, StackTrace stackTrace)
- refactor: void onCreate(Bloc bloc) -> void onCreate(BlocBase bloc)
- refactor: void onClose(Bloc bloc) -> void onClose(BlocBase bloc)
BREAKING: refactor: Bloc and Cubit do not extend Stream and implement Sink
- refactor: use bloc.stream or cubit.stream to access Stream<State>
  - myBloc.map(...) -> myBloc.stream.map(...)
- refactor: deprecate bloc.listen in favor of bloc.stream.listen
BREAKING: revert: refactor: Change and onChange removed in favor of Transition and onTransition

7.0.0-nullsafety.3

fix: transformEvents multiple subscriptions issue
test: improve testing for advanced transformEvents behavior

7.0.0-nullsafety.2

chore: bump to meta: ^1.3.0

7.0.0-nullsafety.1

BREAKING: refactor: Cubit extends Bloc
- refactor: Change and onChange removed in favor of Transition and onTransition
- refactor: void onError(Cubit cubit, Object error, StackTrace stackTrace) -> void onError(Bloc bloc, Object error, StackTrace stackTrace)
- refactor: void onCreate(Cubit cubit) -> void onCreate(Bloc bloc)
- refactor: void onClose(Cubit cubit) -> void onClose(Bloc bloc)
- refactor: CubitUnhandledErrorException -> BlocUnhandledErrorException

7.0.0-nullsafety.0

BREAKING: opt into null safety
feat!: upgrade Dart SDK constraints to >=2.12.0-0 <3.0.0

6.1.3

fix: transformEvents multiple subscriptions issue due to v6.1.2

6.1.2

fix: bloc memory leak due to internal event stream being a broadcast stream

6.1.1

fix: close should always emit done

6.1.0

feat: add onCreate and onClose to BlocObserver

6.0.3

docs: README updates to include flow diagrams for Bloc and Cubit.

6.0.2

refactor: cubit internal memory and performance optimizations

6.0.1

docs: minor documentation fixes and improvements

6.0.0

BREAKING: do not emit current state on subscription
BREAKING: onError in BlocObserver takes a Cubit as first parameter
BREAKING: allow blocs and cubits to emit the initial state
feat: include cubit and remove external dependency on package:cubit
- exports class Cubit
- exports class Change (Transition for Cubit)
feat: onChange added to BlocObserver
refactor: apply additional lint rules
fix: add @visibleForTesting to emit on class Cubit
docs: fix inline documentation references

6.0.0-dev.2

fix: add @visibleForTesting to emit on class Cubit

6.0.0-dev.1

BREAKING: do not emit current state on subscription
BREAKING: onError in BlocObserver takes a Cubit as first parameter
BREAKING: allow blocs and cubits to emit the initial state
feat: include cubit and remove external dependency on package:cubit
- exports class Cubit
- exports class Change (Transition for Cubit)
feat: onChange added to BlocObserver
refactor: apply additional lint rules
docs: fix inline documentation references

5.0.1

fix: upgrade to cubit ^0.1.2
docs: minor documentation updates

5.0.0

BREAKING: remove initialState override in favor of providing the initial state via super (#1304).
BREAKING: Remove BlocSupervisor and rename BlocDelegate to BlocObserver.
feat: support null states (#1312).
refactor: bloc to extend cubit rather than Stream.
feat: ignore newly added events after bloc is closed (#1236).
feat: add addError to conform to EventSink interface.
feat: mark onError, onTransition, onEvent as protected.
docs: documentation improvements
docs: logo updates

5.0.0-dev.11

feat: add addError to conform to EventSink interface.
feat: mark onError, onTransition, onEvent as protected.

5.0.0-dev.10

docs: additional minor improvement to bloc logo alignment

5.0.0-dev.9

docs: minor improvement to bloc logo alignment

5.0.0-dev.8

BREAKING: Remove BlocSupervisor and rename BlocDelegate to BlocObserver.

5.0.0-dev.7

Ignore newly added events after bloc is closed (#1236).

5.0.0-dev.6

Additional documentation optimizations.

5.0.0-dev.5

Optimize documentation assets for smaller viewports.

5.0.0-dev.4

Update to cubit ^0.0.13
Update documentation and static assets.

5.0.0-dev.3

Update documentation and static assets.

5.0.0-dev.2

BREAKING: update initialState to be a required positional parameter (related issue).

5.0.0-dev.1

BREAKING: remove initialState override in favor of providing the initial state via super (#1304).
feat: support null states (#1312).
refactor: bloc to extend cubit rather than Stream.

4.0.0

Remove rxdart dependency (#821)
Replace transformStates with transformTransitions (#840)
Fix null stackTrace in onError (#963)
Fix remove duplicate terminating state
Add mustCallSuper to onEvent, onTransition, and onError
Surface Unhandled Bloc Errors in Debug Mode
Internal testing improvements

4.0.0-dev.4

Surface Unhandled Bloc Errors in Debug Mode
Internal testing improvements

4.0.0-dev.3

Add mustCallSuper to onEvent, onTransition, and onError

4.0.0-dev.2

Fix remove duplicate terminating state

4.0.0-dev.1

Remove rxdart dependency (#821)
Replace transformStates with transformTransitions (#840)
Fix null stackTrace in onError (#963)

3.0.0

Upgrade to rxdart ^0.23.0
Upgrade to Dart >= 2.6.0

3.0.0-dev.1

Upgrade to rxdart ^0.23.0

2.0.0

Allow blocs to finish processing pending events on close (#639)
Documentation Updates

1.0.1

Bugfix: Exceptions thrown in onTransition are passed to onError and should not break bloc functionality (#641)
Adhere to effective dart (#561)
Documentation and Example Updates

1.0.0

dispatch and dispose removed
Documentation Updates

0.16.1

Minor Documentation Updates

0.16.0

Bloc extends Stream<State> (#558)
- bloc.state.listen -> bloc.listen
- bloc.currentState -> bloc.state
Bloc implements Sink<Event> (#558)
- dispatch deprecated in favor of add
- dispose deprecated in favor of close
Documentation and Example Updates

0.15.0

Removed Bloc event Stream (#326)
Renamed transform to transformEvents
Added transformStates (#382)

0.14.4

Additional Dependency and Documentation Updates.

0.14.3

Dependency and Documentation Updates.

0.14.2

Deprecated Bloc event Stream (#326)
Documentation Updates

0.14.1

Internal BlocDelegate update and Documentation Updates.

0.14.0

BlocDelegate initialization improvements and Documentation Updates.

BlocSupervisor().delegate = ... is now BlocSupervisor.delegate = ... (#304).

0.13.0

Bloc and BlocDelegate Improvements, new Features, and Documentation Updates.

Improved dispose to ignore pending events (#257).
Exposed event stream on Bloc similar to state stream to expose a Stream of dispatched events (#259).
Update to use rxdart version ^0.22.0 (#265).
BlocDelegate methods include a reference to the Bloc instance (#259).
Added onEvent to Bloc and BlocDelegate (#259).

0.12.0

Updated transform to enable advanced event filtering and processing and Documentation Updates.

0.11.2

Added BlocDelegate onError and onTransition mustCallSuper and Documentation Updates

0.11.1

Added dispose mustCallSuper and Documentation Updates

0.11.0

Update mapEventToState to remove unnecessary argument for currentState

Stream<S> mapEventToState(S currentState, E event) -> Stream<S> mapEventToState(E event)
Documentation Updates
Example Updates

0.10.0

Updated to rxdart ^0.21.0 and Documentation Updates

0.9.5

Minor Enhancements to Code Style and Documentation.

0.9.4

Calls to dispatch after dispose has been called trigger onError in the Bloc and BlocDelegate.

0.9.3

Restrict rxdart to ">=0.18.1 <0.21.0" due to breaking changes.

0.9.2

Additional Minor Updates to Documentation

0.9.1

Minor Updates to Documentation

0.9.0

Bloc and BlocDelegate Error Handling

Added onError to Bloc for local error handling.
Added onError to BlocDelegate for global error handling.

0.8.4

Blocs handle exceptions thrown in mapEventToState and documentation updates.

0.8.3

Minor Internal Improvements and Documentation Updates

0.8.2

Additional Minor Updates to Documentation

0.8.1

Minor Updates to Documentation

0.8.0

Blocs ignore duplicate states

0.7.8

Additional Minor Updates to Documentation

0.7.7

Additional Minor Updates to Documentation

0.7.6

Minor Updates to Documentation

0.7.5

Exposed currentState in Bloc

Updates to Documentation.

0.7.4

Updated mapEventToState parameter name

Stream<S> mapEventToState(S state, E event) -> Stream<S> mapEventToState(S currentState, E event)
Updates to Documentation.
Updates to Example.

0.7.3

Minor Updates to Documentation

0.7.2

Transition Fix

Bloc with mapEventToState which returns multiple states per event will now correctly report the Transitions.

0.7.1

Improvements to Bloc usage in pure Dart applications.

Bloc state is seeded with initialState automatically

0.7.0

Added BlocSupervisor and BlocDelegate.

BlocSupervisor notifies BlocDelegate of Transitions
BlocDelegate exposes onTransition which is invoked for all Bloc Transitions.

0.6.0

Transitions and initialState updates.

Added Transitions and onTransition
Made initialState required

0.5.2

Additional minor Updates to Documentation.

0.5.1

Minor Updates to Documentation

0.5.0

Moved Flutter Widgets to flutter_bloc package

0.4.2

Additional minor Updates to Documentation.

0.4.1

Minor Updates to Documentation.

0.4.0

Added BlocProvider.

BlocProvider.of(context)
Updates to Documentation.
Updates to Example.

0.3.0

Updated mapEventToState to take current state as an argument.

Stream<S> mapEventToState(E event) -> Stream<S> mapEventToState(S state, E event)
Updates to Documentation.
Updates to Example.

0.2.5

Additional Minor Updates to Documentation.

0.2.4

Additional Minor Updates to Documentation.

0.2.3

Additional Minor Updates to Documentation.

0.2.2

Additional Minor Updates to Documentation.

0.2.1

Minor Updates to Documentation.

0.2.0

Added Support for Stream Transformation

Includes Stream<E> transform(Stream<E> events)
Updates to Documentation

0.1.2

Additional Minor Updates to Documentation.

0.1.1

Minor Updates to Documentation.

0.1.0

Initial Version of the library.

Includes the ability to create a custom Bloc by extending Bloc class.
Includes the ability to connect presentation layer to Bloc by using the BlocBuilder Widget.

Installing

export PUB_HOSTED_URL=https://pub.mirror.p-hatan.ir
flutter pub add 'bloc:7.1.0'

pubspec.yaml

name: bloc
description: A predictable state management library that helps implement the BLoC (Business Logic Component) design pattern.
version: 7.1.0
repository: https://github.com/felangel/bloc/tree/master/packages/bloc
issue_tracker: https://github.com/felangel/bloc/issues
homepage: https://github.com/felangel/bloc
documentation: https://bloclibrary.dev

environment:
  sdk: ">=2.12.0 <3.0.0"

dependencies:
  meta: ^1.3.0

dev_dependencies:
  mocktail: ^0.1.0
  pedantic: ^1.10.0
  rxdart: ^0.26.0
  test: ^1.16.0

Version history

Version	Published	Archive	SHA-256
0.1.0	2018-10-08Cached · Upstream SHA-256 matched	Download	`bfe4b4a2…724c57`
0.1.1	2018-10-08Cached · Upstream SHA-256 matched	Download	`86193bc3…e3b0fa`
0.1.2	2018-10-08Cached · Upstream SHA-256 matched	Download	`5f3eaad8…a2abad`
0.2.0	2018-10-08Cached · Upstream SHA-256 matched	Download	`e16fd926…2ed9c4`
0.2.1	2018-10-08Cached · Upstream SHA-256 matched	Download	`b56bf959…942cc5`
0.2.2	2018-10-08Cached · Upstream SHA-256 matched	Download	`fcc7a7cc…6b2af7`
0.2.3	2018-10-09Cached · Upstream SHA-256 matched	Download	`9e35b326…dafd48`
0.2.4	2018-10-09Cached · Upstream SHA-256 matched	Download	`1231c70c…4c85b3`
0.2.5	2018-10-11Cached · Upstream SHA-256 matched	Download	`b805a9e0…1a0977`
0.3.0	2018-10-14Cached · Upstream SHA-256 matched	Download	`3699626f…482ae3`
0.4.0	2018-10-16Cached · Upstream SHA-256 matched	Download	`77d3150d…6bddd5`
0.4.1	2018-10-16Cached · Upstream SHA-256 matched	Download	`83ca5fac…7a91ce`
0.4.2	2018-10-16Cached · Upstream SHA-256 matched	Download	`53dc13e2…9fc2ef`
0.5.0	2018-10-23Cached · Upstream SHA-256 matched	Download	`3fbb3f16…d502ca`
0.5.1	2018-10-23Cached · Upstream SHA-256 matched	Download	`2a89d793…b470fb`
0.5.2	2018-10-24Cached · Upstream SHA-256 matched	Download	`552344cd…1d6ab4`
0.6.0	2018-10-26Cached · Upstream SHA-256 matched	Download	`45eddbfa…fe8874`
0.7.0	2018-11-22Cached · Upstream SHA-256 matched	Download	`41e0f5bc…d7cba4`
0.7.1	2018-11-29Cached · Upstream SHA-256 matched	Download	`b5acda46…c78e71`
0.7.2	2018-12-03Cached · Upstream SHA-256 matched	Download	`b9b0dfbb…4785f4`
0.7.3	2018-12-08Cached · Upstream SHA-256 matched	Download	`c159b538…b53225`
0.7.4	2018-12-12Cached · Upstream SHA-256 matched	Download	`1ebcf265…c50c26`
0.7.5	2018-12-17Cached · Upstream SHA-256 matched	Download	`1ab88a6d…f01790`
0.7.6	2018-12-21Cached · Upstream SHA-256 matched	Download	`2dc55af6…f57cf9`
0.7.7	2018-12-21Cached · Upstream SHA-256 matched	Download	`2ea3af00…f4a789`
0.7.8	2019-01-07Cached · Upstream SHA-256 matched	Download	`88673fa0…01d8af`
0.8.0	2019-01-11Cached · Upstream SHA-256 matched	Download	`607e8450…bf202d`
0.8.1	2019-01-22Cached · Upstream SHA-256 matched	Download	`c495b55a…f41e07`
0.8.2	2019-01-27Cached · Upstream SHA-256 matched	Download	`c2b3a781…2f7f8a`
0.8.3	2019-02-04Cached · Upstream SHA-256 matched	Download	`7486fa77…a18588`
0.8.4	2019-02-12Cached · Upstream SHA-256 matched	Download	`c653498b…57bfa1`
0.9.0	2019-02-13Cached · Upstream SHA-256 matched	Download	`f5ddef39…b23d5d`
0.9.1	2019-02-16Cached · Upstream SHA-256 matched	Download	`903bb05d…67ac8f`
0.9.2	2019-02-16Cached · Upstream SHA-256 matched	Download	`3b35b9fb…a170fd`
0.9.3	2019-02-20Cached · Upstream SHA-256 matched	Download	`092530d5…03b8b2`
0.9.4	2019-03-08Cached · Upstream SHA-256 matched	Download	`32ec9ec6…b81639`
0.9.5	2019-03-08Cached · Upstream SHA-256 matched	Download	`c95dc63e…25cd90`
0.10.0	2019-03-19Cached · Upstream SHA-256 matched	Download	`35a83cde…96fdc4`
0.11.0	2019-03-24Cached · Upstream SHA-256 matched	Download	`0a0a388b…8a0e85`
0.11.1	2019-03-30Cached · Upstream SHA-256 matched	Download	`499e942f…89cce8`
0.11.2	2019-04-06Cached · Upstream SHA-256 matched	Download	`dd9ea891…987395`
0.12.0	2019-04-17Cached · Upstream SHA-256 matched	Download	`870bb53d…09ef1b`
0.13.0	2019-05-04Cached · Upstream SHA-256 matched	Download	`cfcc09c3…19ba3c`
0.14.0	2019-05-22Cached · Upstream SHA-256 matched	Download	`fc65c2e2…e13393`
0.14.1	2019-05-22Cached · Upstream SHA-256 matched	Download	`af2ea6e1…09681c`
0.14.2	2019-06-05Cached · Upstream SHA-256 matched	Download	`8f89f2e1…03c797`
0.14.3	2019-06-23Cached · Upstream SHA-256 matched	Download	`cb54ce33…1790c7`
0.14.4	2019-06-23Cached · Upstream SHA-256 matched	Download	`a2971321…9af79c`
0.15.0	2019-08-20Cached · Upstream SHA-256 matched	Download	`4dc615b1…e49e76`
0.16.0	2019-10-15Cached · Upstream SHA-256 matched	Download	`4a9df2c4…c63dfd`
0.16.1	2019-10-15Cached · Upstream SHA-256 matched	Download	`d87523ac…a6635f`
1.0.0	2019-10-20Cached · Upstream SHA-256 matched	Download	`0d57df01…063f4a`
1.0.1	2019-11-04Cached · Upstream SHA-256 matched	Download	`b2592b70…f07cdc`
2.0.0	2019-11-05Cached · Upstream SHA-256 matched	Download	`8544ef60…ec3828`
3.0.0-dev.1	2019-11-28Cached · Upstream SHA-256 matched	Download	`9c23c45e…f14457`
3.0.0	2019-12-25Cached · Upstream SHA-256 matched	Download	`ccc49d51…61ada4`
4.0.0-dev.1	2020-04-05Cached · Upstream SHA-256 matched	Download	`597621d1…62e462`
4.0.0-dev.2	2020-04-15Cached · Upstream SHA-256 matched	Download	`e21f7cfb…960bc8`
4.0.0-dev.3	2020-04-19Cached · Upstream SHA-256 matched	Download	`641593fe…d90033`
4.0.0-dev.4	2020-04-20Cached · Upstream SHA-256 matched	Download	`92820ef4…99d334`
4.0.0	2020-04-21Cached · Upstream SHA-256 matched	Download	`bc0e8756…bac75a`
5.0.0-dev.1	2020-06-21Cached · Upstream SHA-256 matched	Download	`488a1a1f…9d0d2e`
5.0.0-dev.2	2020-06-22Cached · Upstream SHA-256 matched	Download	`2720922c…c03302`
5.0.0-dev.3	2020-06-23Cached · Upstream SHA-256 matched	Download	`8d2480cf…e4f067`
5.0.0-dev.4	2020-06-24Cached · Upstream SHA-256 matched	Download	`3edd01b5…db4dd9`
5.0.0-dev.5	2020-06-24Cached · Upstream SHA-256 matched	Download	`6639b001…7a8dac`
5.0.0-dev.6	2020-06-24Cached · Upstream SHA-256 matched	Download	`5293933b…a20eb5`
5.0.0-dev.7	2020-06-24Cached · Upstream SHA-256 matched	Download	`21456eff…2a4b1e`
5.0.0-dev.8	2020-06-28Cached · Upstream SHA-256 matched	Download	`8b8a74e0…0b8435`
5.0.0-dev.9	2020-06-28Cached · Upstream SHA-256 matched	Download	`d0af89ca…0ebd1d`
5.0.0-dev.10	2020-06-28Cached · Upstream SHA-256 matched	Download	`d6513650…a4f00e`
5.0.0-dev.11	2020-06-30Cached · Upstream SHA-256 matched	Download	`96f45d25…c4d29b`
5.0.0	2020-07-02Cached · Upstream SHA-256 matched	Download	`66e5e429…5b9754`
5.0.1	2020-07-06Cached · Upstream SHA-256 matched	Download	`872e0786…f433d4`
6.0.0-dev.1	2020-07-13Cached · Upstream SHA-256 matched	Download	`dde227e1…8a7beb`
6.0.0-dev.2	2020-07-20Cached · Upstream SHA-256 matched	Download	`0a907ea1…b188e8`
6.0.0	2020-07-22Cached · Upstream SHA-256 matched	Download	`9bba4d00…9dddf5`
6.0.1	2020-07-22Cached · Upstream SHA-256 matched	Download	`28f8ae0e…c0e167`
6.0.2	2020-08-15Cached · Upstream SHA-256 matched	Download	`da311fd0…9058c3`
6.0.3	2020-09-03Cached · Upstream SHA-256 matched	Download	`e4a4e6b2…7ac1fa`
6.1.0	2020-10-16Cached · Upstream SHA-256 matched	Download	`527c4923…233ea2`
6.1.1	2020-12-09Cached · Upstream SHA-256 matched	Download	`d6e1fb79…6ab57e`
6.1.2	2021-03-03Cached · Upstream SHA-256 matched	Download	`7108b980…aa60f4`
6.1.3	2021-03-03Cached · Upstream SHA-256 matched	Download	`428a6baa…bc826b`
7.0.0-nullsafety.0	2020-11-22Cached · Upstream SHA-256 matched	Download	`d9d8220e…554ea5`
7.0.0-nullsafety.1	2021-01-18Cached · Upstream SHA-256 matched	Download	`1c277595…a8344d`
7.0.0-nullsafety.2	2021-02-11Cached · Upstream SHA-256 matched	Download	`2c6e21d5…0b9875`
7.0.0-nullsafety.3	2021-03-03Cached · Upstream SHA-256 matched	Download	`239c91fb…fc7d9c`
7.0.0-nullsafety.4	2021-03-17Cached · Upstream SHA-256 matched	Download	`564071b0…4c0c64`
7.0.0	2021-03-18Cached · Upstream SHA-256 matched	Download	`8fb2e405…5f1026`
7.1.0	2021-08-17Cached · Upstream SHA-256 matched	Download	`2ce4a471…1a4a13`
7.2.0-dev.1	2021-09-02Cached · Upstream SHA-256 matched	Download	`3a583482…35aa1f`
7.2.0-dev.2	2021-09-09Cached · Upstream SHA-256 matched	Download	`f3e36406…3dc0e9`
7.2.0-dev.3	2021-09-10Cached · Upstream SHA-256 matched	Download	`9cd52452…65b6d4`
7.2.0	2021-09-21Cached · Upstream SHA-256 matched	Download	`250bf997…439333`
7.2.1	2021-09-26Cached · Upstream SHA-256 matched	Download	`6f1b87b6…a516bd`
8.0.0-dev.1	2021-09-29Cached · Upstream SHA-256 matched	Download	`37f9b6cd…6a6866`
8.0.0-dev.2	2021-09-29Cached · Upstream SHA-256 matched	Download	`d6e6c205…b0c7a9`
8.0.0-dev.3	2021-10-13Cached · Upstream SHA-256 matched	Download	`b64573ee…e985bd`
8.0.0-dev.4	2021-10-30Cached · Upstream SHA-256 matched	Download	`c21e5efa…9f82e0`
8.0.0-dev.5	2021-11-14Cached · Upstream SHA-256 matched	Download	`d489783d…cc0b16`
8.0.0	2021-11-18Cached · Upstream SHA-256 matched	Download	`a9bd93ba…8baae3`
8.0.1	2021-11-19Cached · Upstream SHA-256 matched	Download	`c12099a6…9dd7e0`
8.0.2	2021-12-29Cached · Upstream SHA-256 matched	Download	`104c7223…98f32d`
8.0.3	2022-02-28Cached · Upstream SHA-256 matched	Download	`318e6cc6…b88e03`
8.1.0	2022-08-06Cached · Upstream SHA-256 matched	Download	`bd4f8027…44534a`
8.1.1	2023-02-05Cached · Upstream SHA-256 matched	Download	`658a5ae5…e11a80`
8.1.2	2023-05-20Cached · Upstream SHA-256 matched	Download	`3820f15f…be5b49`
8.1.3	2024-02-12Cached · Upstream SHA-256 matched	Download	`f53a110e…a2db9e`
8.1.4	2024-03-24Cached · Upstream SHA-256 matched	Download	`106842ad…77804e`
9.0.0	2025-01-12Cached · Upstream SHA-256 matched	Download	`52c10575…6ac189`
9.0.1	2025-09-26Cached · Upstream SHA-256 matched	Download	`e18b8e78…994d78`
9.1.0	2025-10-14Cached · Upstream SHA-256 matched	Download	`a2cebb89…74537d`
9.2.0	2026-01-01Cached · Upstream SHA-256 matched	Download	`a48653a8…7efb81`
9.2.1	2026-05-12Cached · Upstream SHA-256 matched	Download	`e03b2359…b75413`

Dependencies

meta "^1.3.0"

Selected archive

7.1.0

2ce4a47154236d26f3c795a5600776e6782f506f18164b47f2f0c5114f1a4a13

Cached · Upstream SHA-256 matched

115 published versions

bloc

Readme

Sponsors

Overview

Cubit

Creating a Cubit

Using a Cubit

Observing a Cubit

Bloc

Creating a Bloc

Using a Bloc

Observing a Bloc

Dart Versions

Examples

Maintainers

7.1.0

7.0.0

7.0.0-nullsafety.4

7.0.0-nullsafety.3

7.0.0-nullsafety.2

7.0.0-nullsafety.1

7.0.0-nullsafety.0

6.1.3

6.1.2

6.1.1

6.1.0

6.0.3

6.0.2

6.0.1

6.0.0

6.0.0-dev.2

6.0.0-dev.1

5.0.1

5.0.0

5.0.0-dev.11

5.0.0-dev.10

5.0.0-dev.9

5.0.0-dev.8

5.0.0-dev.7

5.0.0-dev.6

5.0.0-dev.5

5.0.0-dev.4

5.0.0-dev.3

5.0.0-dev.2

5.0.0-dev.1

4.0.0

4.0.0-dev.4

4.0.0-dev.3

4.0.0-dev.2

4.0.0-dev.1

3.0.0

3.0.0-dev.1

2.0.0

1.0.1

1.0.0

0.16.1

0.16.0

0.15.0

0.14.4

0.14.3

0.14.2

0.14.1

0.14.0

0.13.0

0.12.0

0.11.2

0.11.1

0.11.0

0.10.0

0.9.5

0.9.4

0.9.3

0.9.2

0.9.1

0.9.0

0.8.4

0.8.3

0.8.2

0.8.1

0.8.0