# cubit 0.1.2
Cubit is a lightweight state management solution. It is a subset of the bloc package that does not rely on events and instead uses methods to emit new states.
## Installing
```
export PUB_HOSTED_URL=https://pub.mirror.p-hatan.ir
flutter pub add cubit
```
Published: 2020-07-06T00:10:54.737736Z
Expected archive SHA-256: 87a0e33da05fbfcdd43aedb9f3156f04523f0624ab3a3bd06e8b9b67fdbd48b2
Discontinued upstream.
Available in cache; verification: upstream_checksum
## Direct dependencies
- meta: ^1.1.8
## Package README (untrusted upstream documentation)
Cubit is a lightweight state management solution. It is a subset of the [bloc package](https://pub.dev/packages/bloc) that does not rely on events and instead uses methods to emit new states.
Every `cubit` requires an initial state which will be the state of the `cubit` before `emit` has been called.
The current state of a `cubit` can be accessed via the `state` getter.
## Creating a Cubit
```dart
class CounterCubit extends Cubit {
CounterCubit() : super(0);
void increment() => emit(state + 1);
}
```
## Using a Cubit
```dart
void main() async {
final cubit = CounterCubit()..increment();
await cubit.close();
}
```
## Observing a Cubit
`onTransition` can be overridden to observe state changes for a single cubit.
```dart
class CounterCubit extends Cubit {
CounterCubit() : super(0);
void increment() => emit(state + 1);
@override
void onTransition(Transition transition) {
print(transition);
super.onTransition(transition);
}
}
```
`CubitObserver` can be used to observe state changes for all cubits.
```dart
class MyCubitObserver extends CubitObserver {
@override
void onTransition(Cubit cubit, Transition transition) {
print(transition);
super.onTransition(cubit, transition);
}
}
```
```dart
void main() {
Cubit.observer = MyCubitObserver();
// Use cubits...
}
```
## Dart Versions
- Dart 2: >= 2.7.0
## Maintainers
- [Felix Angelov](https://github.com/felangel)
## Supporters
[](https://verygood.ventures)
## Starware
Cubit is Starware.
This means you're free to use the project, as long as you star its GitHub repository.
Your appreciation makes us grow and glow up. ⭐
## Changelog
# 0.1.2
- revert: `v0.1.1`
# 0.1.1
- fix: offload state emission to next event loop iteration
# 0.1.0
- docs: add `onTransition` documentation to README
- docs: add `CubitObserver` documentation to README
# 0.0.14
- feat: add `CubitObserver` support
- docs: minor documentation improvements
# 0.0.13
- docs: various documentation updates
# 0.0.12
- docs: fix coverage badge
# 0.0.11
- docs: various documentation updates
# 0.0.10
- docs: various documentation updates
# 0.0.9
- docs: documentation and logo updates
# 0.0.8
- **BREAKING**: revert named `initialState` parameter ([related issue](https://github.com/dart-lang/sdk/issues/42438))
- docs: minor logo updates
# 0.0.7
- feat: add `onTransition` to `cubit`
- feat: `Cubit` extends `CubitStream`
# 0.0.6
- **BREAKING**: ignore duplicate states
# 0.0.5
- feat: allow `initialState` to be `null`
# 0.0.4
- **BREAKING**: use named parameter for `initialState`
# 0.0.3
- **BREAKING**: remove `initialState` getter and instead require initial state via constructor
# 0.0.2
- **BREAKING**: update `emit` to be a `void` function
- **BREAKING**: remove artifical wait to guarantee `initialState` is emitted
- **BREAKING**: `close` drains the internal `Stream`
- tests: 100% test coverage
# 0.0.1
- feat: initial release