Profile My skills Saved My plugins Edit profile Submit a skill

Flutter BLoC State Management

Standards for predictable state management using flutter_bloc, freezed, and equatable.

fierzone Updated
Coding & Dev Tools

File contents

BLoC State Management

Priority: P0 (CRITICAL)

Structure

lib/features/auth/
├── bloc/
│   ├── auth_bloc.dart
│   ├── auth_event.dart # (@freezed or Equatable)
│   └── auth_state.dart # (@freezed or Equatable)

Implementation Guidelines

  • States & Events: Use @freezed for union states. See references/bloc_templates.md.
  • Error Handling: Use Failure objects; avoid throwing exceptions.
  • Async Data: Use emit.forEach for streams.
  • Concurrency: Use transformer for event debouncing.
  • Testing: Use blocTest for state transition verification.
  • Injection: Register BLoCs as @injectable (Factory).

Anti-Patterns

  • No .then(): Use await or emit.forEach() to emit states.
  • No Logic in Builder: Perform calculations in BLoC, not inside BlocBuilder.
  • No BLoC-to-BLoC: Use streams to coordinate BLoCs, not direct references.

Related Topics

layer-based-clean-architecture | dependency-injection | error-handling

fierzone/agent-skills-standard/tree/main/skills/flutter/bloc-state-management commit 4e01ff85bc

Browse category

Frequently asked questions

npx skillmds@latest add fierzone/flutter-bloc-state-management