# General code styling rules

*   Method should always have a return value. If method doesn't return anything, it should be marked as **void**
    
*   Method naming: if method returns Widget, it should start with 'build'.
    

# Widgets layer

Preferably create stateless widgets, not methods if you build a reusable UI block

# Working with Flutter BLoC:

### **Event Handling in Bloc:**

By default, we prefer using **sealed event classes with a single** `**on<Event>**` **handler**. This approach ensures **compile-time exhaustiveness checks** — if a new event subtype is added, the compiler will require handling it explicitly in the `switch` statement. It also improves code organization by keeping related event logic grouped together and easier to maintain.  
  

```dart
// events.dart
sealed class WorkPackageFormEvent {}

final class WorkPackageFormInit extends WorkPackageFormEvent {}
final class WorkPackageFormRefresh extends WorkPackageFormEvent {}
final class WorkPackageFormSubmit extends WorkPackageFormEvent {}
final class WorkPackageFormUpdated extends WorkPackageFormEvent {}

// bloc.dart
on<WorkPackageFormEvent>(
  (event, emit) => switch (event) {
    WorkPackageFormInit() => _onInit(event, emit),
    WorkPackageFormRefresh() => _onRefresh(event, emit),
    WorkPackageFormSubmit() => _onSubmit(emit),
    WorkPackageFormUpdated() => _onUpdated(event, emit),
  },
);
```

  
If **no event transformers** (e.g., `debounce`, `throttle`, `droppable`, `restartable`) are required, always use the sealed-class + single-handler pattern for clarity and type safety.

When individual events require **different concurrency or timing behaviors**, use **separate** `**on<SpecificEvent>**` **handlers** to assign appropriate transformers and keep event processing independent.  
  

```dart
on<WorkPackagesInitEvent>((event, emit) => _init(event, emit));
on<WorkPackagesRefreshEvent>((event, emit) => _refresh(event, emit));
on<WorkPackagesLoadEvent>((event, emit) => _load(event, emit));

// Example: distinct transformer for one event
on<WorkPackagesUpdateFilterEvent>(
  transformer: debounceSequential(const Duration(milliseconds: 300)),
  (event, emit) => _updateFilter(event, emit),
);
```

&nbsp;**In summary:**

✅ **Default** → sealed class + single `on<Event>` with `switch`

⚙️ **Exception** → multiple `on<SpecificEvent>` when distinct transformers are needed