flutter-helper

Flutter Helper

1. Diagnostic initial

Avant tout, collecter :

• flutter --version → version SDK (cible : Flutter 3.22+, Dart 3.4+)
• flutter doctor -v → chaîne outils (Xcode, Android SDK, etc.)
• Message d'erreur complet (stack trace si disponible)
• Plateforme cible (Android / iOS / Web / Desktop)

---

2. Structure projet

Feature-first (projets moyens/grands) :

lib/
  features/
    auth/
      data/        # repositories, data sources, models
      domain/      # entities, use cases
      presentation/ # pages, widgets, controllers
  core/            # DI, router, theme, utils
  main.dart

Layer-first (petits projets ou prototypes) :

lib/
  data/ domain/ presentation/
  main.dart

Critère de choix : si > 3 features ou > 2 devs → feature-first obligatoire.

---

3. State management — décision

Taille projet	Solution recommandée	Quand éviter
Prototype / très petit	Provider	> 3 features
Moyen	Riverpod 2.x	jamais — convient toujours
Grande logique métier	BLoC/Cubit	sur-architecture sur petits cas
Full-stack léger	GetX	maintainability sacrifiée

Riverpod — pattern minimal fonctionnel :

// counter_provider.dart
final counterProvider = StateNotifierProvider<CounterNotifier, int>(
  (ref) => CounterNotifier(),
);

class CounterNotifier extends StateNotifier<int> {
  CounterNotifier() : super(0);
  void increment() => state++;
}

// widget
class CounterPage extends ConsumerWidget {
  @override
  Widget build(BuildContext context, WidgetRef ref) {
    final count = ref.watch(counterProvider);
    return Text('$count');
  }
}

Cubit — pattern minimal :

class AuthCubit extends Cubit<AuthState> {
  AuthCubit(this._repo) : super(AuthInitial());
  final AuthRepository _repo;

  Future<void> login(String email, String password) async {
    emit(AuthLoading());
    try {
      final user = await _repo.login(email, password);
      emit(AuthSuccess(user));
    } catch (e) {
      emit(AuthError(e.toString()));
    }
  }
}