checklist Reference

// ✅ Entity example (immutable + Equatable + copyWith, no codegen)
@immutable
final class User extends Equatable {
  const User({required this.id, required this.name});

  final int id;
  final String name;

  User copyWith({int? id, String? name}) =>
      User(id: id ?? this.id, name: name ?? this.name);

  @override
  List<Object?> get props => [id, name];
}

// ✅ Repository Interface example
abstract interface class IUserRepository {
  Future<Either<Failure, User>> getUser(int id);
}

// ✅ UseCase example (Optional Constructor Injection)
class GetUserUseCase {
  const GetUserUseCase([IUserRepository? repository])
      : _repository = repository ?? const UserRepository();

  final IUserRepository _repository;

  Future<Either<Failure, User>> call(GetUserParams params) async {
    return _repository.getUser(params.id);
  }
}

# Full build (build_runner across the workspace)
melos run build

test('should return user when repository succeeds', () async {
  // Arrange
  when(() => mockRepository.getUser(any()))
    .thenAnswer((_) async => Right(testUser));

  // Act
  final result = await useCase(GetUserParams(id: 1));

  // Assert
  expect(result, Right(testUser));
  verify(() => mockRepository.getUser(1)).called(1);
});

blocSignalTest<HomeBloC, HomeState>(
  'emits [loading, loaded] when LoadUser succeeds',
  setUp: () {
    when(() => mockGetUserUseCase(any()))
      .thenAnswer((_) async => Right(testUser));
  },
  build: () => HomeBloC(getUserUseCase: mockGetUserUseCase),  // ✅ Direct mock injection
  act: (bloc) => bloc.add(LoadUser(id: 1)),
  expect: () => [HomeLoading(), HomeLoaded(testUser)],
);

# Single feature test
flutter test feature/{type}/{feature_name}/test/

# Coverage report
melos run test:with-html-coverage

feat(auth): ✨ Add social login feature
fix(home): 🐛 Fix feed infinite scroll bug
refactor(store): ♻️ Optimize product list query

✅ Correct dependency direction:
Presentation → Domain → Data

❌ Incorrect dependency:
Presentation → Data (bypassing Domain)
Feature A → Feature B (direct reference)

// ✅ Correct BLoC pattern (sealed class + Equatable, no codegen)
@immutable
sealed class HomeEvent extends Equatable {
  const HomeEvent();

  const factory HomeEvent.loadUser(int id) = LoadUser;

  @override
  List<Object?> get props => const [];
}

final class LoadUser extends HomeEvent {
  const LoadUser(this.id);
  final int id;
  @override
  List<Object?> get props => [id];
}

@immutable
sealed class HomeStatus extends Equatable {
  const HomeStatus();

  const factory HomeStatus.initial() = HomeInitial;
  const factory HomeStatus.loading() = HomeLoading;
  const factory HomeStatus.loaded(User user) = HomeLoaded;
  const factory HomeStatus.error(Failure failure) = HomeError;

  @override
  List<Object?> get props => const [];
}

# Secret search
grep -r "api_key\|secret\|password\|token" --include="*.dart"

# Check PR status
gh pr checks [PR_NUMBER]

# View PR in browser
gh pr view [PR_NUMBER] --web

melos run analyze

dart format .