flutter-bloc
/flutter-bloc
Pomaga implementować zarządzanie stanem na zapieczętowanych klasach BLoC, rejestrować wstrzykiwanie zależności przez injectable i konfigurować nasłuchiwanie GoRouter.
- Autor
- dhruvanbhalara ↗
- Repozytorium
- skills ↗
- Licencja
- MIT
- Ostatnia zmiana repozytorium
- 30.08.2026
Ocena i bezpieczeństwo
- Pliki w paczce
- 1
- Skrypty
- 0
- Komentarze HTML
- 0
- Adresy URL w SKILL.md
- 0
Brak sygnałów. Repozytorium zmienione 30.08.2026, bez odwołań do wycofanych modeli i API.
MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.
Co robi i kiedy
Pomaga implementować zarządzanie stanem na zapieczętowanych klasach BLoC, rejestrować wstrzykiwanie zależności przez injectable i konfigurować nasłuchiwanie GoRouter.
Oryginalny opis (EN)
Use when implementing state management with sealed BLoC classes, registering dependency injection with injectable, or setting up GoRouter listeners.
Jak działa
- BLoC Widget Usage
- Workflow: Implementing State Management
Podgląd SKILL.md
---
name: flutter-bloc
description: Use when implementing state management with sealed BLoC classes, registering dependency injection with injectable, or setting up GoRouter listeners.
metadata:
platforms: "flutter"
languages: "dart"
category: "architecture"
---
# BLoC Pattern
- **Sealed States & Events**: Always use `sealed class` for both States and Events to ensure exhaustive UI handling and compile-time safety.
- **Immutability**: All States, Events, and Domain Entities MUST be immutable (using `final` and `Equatable` or `freezed`).
- **Official BLoC Part-Part Of Pattern**: Every `_bloc.dart` file MUST include its corresponding `_event.dart` and `_state.dart` files using `part` directives. Each event/state file MUST have a `part of` directive pointing back to the bloc file. This ensures a single library scope and shared private members.
```dart
// auth_bloc.dart
part 'auth_event.dart';
part 'auth_state.dart';
class AuthBloc extends Bloc<AuthEvent, AuthState> { ... }
// auth_event.dart
part of 'auth_bloc.dart';
// auth_state.dart
part of 'auth_bloc.dart';
```
- **Mandatory Directory Structure**: Every BLoC feature set MUST reside in its own sub-directory within the `bloc/` folder. Flat `bloc/` directories are STRICTLY prohibited.
```text
presentation/bloc/
└── <bloc_name>/
├── <bloc_name>_bloc.dart
├── <bloc_name>_event.dart
└── <bloc_name>_state.dart
```
- **Loading State Mandate**: ALWAYS emit `Loading` before async work, then `Success` or `Error`. Never skip the loading state.
- **Concurrency**: Use `transformers` (e.g., `restartable()`, `droppable()`) for events requiring debouncing (search) or throttling (buttons).
- **Zero-Logic UI**: Widgets MUST NOT contain business logic, orchestration logic, or direct calls to external services. They should ONLY dispatch events and build UI based on BLoC states.
## BLoC Widget Usage
- `BlocBuilder` for local UI rebuilds based on state
- `BlocListener` for side effects (navigation, snackbars, dialogs)
- `BlocConsumer` when both rebuild and side effects are needed
- `context.read<Bloc>().add(Event())` for dispatching events
- `context.watch<Bloc>().state` for reactive rebuilds (inside `build()` only)
## Workflow: Implementing State Management
Follow this sequential workflow when adding or updating a BLoC. Copy the checklist to track progress.
### Task Progress
- [ ] **Step 1: Define Events and States.** Ensure they use `Equatable` with correct `props` or `freezed`.
- [ ] **Step 2: Implement Async Operations.** Verify that all async work follows the `Loading → Success/Error` pattern.
- [ ] **Step 3: Refactor UI.** Ensure there is no orchestration or business logic in UI widgets; they must only dispatch events.
- [ ] **Step 4: Verify Data Sources.** Ensure no SDK/API calls exist outside DataSources.
- [ ] **Step 5: Review Design Tokens.** Ensure zero hardcoded colors, spacing, or typography are used.
- [ ] **Step 6: Format Code.** Ensure the code is formatted with `dart format`.
# Dependency Injection
- Use `injectable` for dependency injection and service location
- **Standardized Injection**:
- Use `@injectable` for screen-specific BLoCs to ensure a fresh instance per screen access.
- Use `@lazySingleton` for global or shared BLoCs (e.g., `AuthBloc`, `ThemeBloc`, `SettingsBloc`, `PasswordBloc`).
- Organize blocs logically by feature and ensure strict separation of concerns
# Navigation & Routing
- **Dynamic Routes**: STRICTLY prohibit hardcoded route strings in `GoRouter` configuration. Use static constants in `AppRoutes`.
- **Centralized BLoCs**: BLoC providers MUST be injected via `ShellRoute` or `BlocProvider` in `app_router.dart` when shared across multiple screens or within a feature branch.
- **No Local Providers**: Avoid `BlocProvider` in individual screen `build()` methods if the BLoC is needed by a feature set.
- **Primitive Route Arguments**: STRICTLY prohibit passing complex objects (BLoCs, ChangeNotifiers, Entity instances) as route arguments. Pass only primitive IDs/Keys and fetch data in the destination screen using `Repository` or `Bloc` injection.
Wersje
| Repozytorium | Wynik | Licencja |
|---|---|---|
| Ta strona · dhruvanbhalara/skills | 100 | MIT |
| Dee9975/cc-skills-flutter | 100 | MIT |
Migawka bazy z 13.11.2026 · wersja paczki a39dd13e6719 (skrót SHA-256 całej paczki)
Pobrania w ostatnich 30 dniach: 0 · ranking
Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.
Podobne skille
- 90flutter-dev
Prowadzi przy aplikacjach Flutter: wzorce widgetów, zarządzanie stanem Riverpod lub Bloc, nawigacja GoRouter i wydajność. - 100flutter-expert
Wspiera budowę aplikacji wieloplatformowych we Flutter 3+ i Dart: widgety, zarządzanie stanem Riverpod lub Bloc, nawigacja GoRouter, implementacje platformowe i optymalizacja wydajności. - 100flutter-expert
Buduje aplikacje Flutter 3+ i Dart: widgety, Riverpod lub Bloc, GoRouter, kod platformowy i wydajność. - 100flutter-architecture
Podaje wzorce architektury aplikacji Flutter: struktura feature-first, clean architecture i zarządzanie stanem (Bloc, Riverpod, Provider), wstrzykiwanie zależności i dobór podejścia. - 90flutter-expert
Tworzy wieloplatformowe aplikacje we Flutterze 3 i Dart: widgety, Riverpod lub Bloc, nawigację GoRouter i optymalizację wydajności. - 95flutter-state-management-and-widget-design
Opisuje zarządzanie stanem we Flutterze (Riverpod 2.x, BLoC i Cubit), optymalizację drzewa widgetów, niezmienny stan, routing GoRouter i czystą architekturę dla skalowalnych aplikacji.