Lint rules by framework domain

Widget construction, lifecycle, and Flutter framework APIs.

• accessible-widget-labelsflutter

  Warn about unlabeled interactive gesture targets.

• always-pass-global-keyflutter

  Keep GlobalKeys stable and pass owned State fields to widgets.

• always-remove-listenerrecommendedflutter

  Requires Flutter Listenable registrations in State to be removed.

• avoid-border-allflutter

  Avoids Flutter's non-const Border.all factory.

• avoid-disposing-late-fieldsflutter

  Avoid releasing late State fields that may be unset or initialized only by cleanup.

• avoid-empty-setstaterecommendedflutter

  Avoid setState callbacks with empty block bodies.

• avoid-incorrect-image-opacityflutter

  Flags Opacity directly wrapping a Flutter Image, including named constructors.

• avoid-inherited-widget-in-initstaterecommendedflutter

  Avoid inherited-widget subscriptions during initState.

• avoid-late-contextrecommendedflutter

  Avoid storing BuildContext in late fields or reading it in late initializers.

• avoid-missing-controllerflutter

  Require Flutter text fields to expose their updated value.

• avoid-missing-image-altflutter

  Requires semanticLabel on Flutter Image and imageSemanticLabel on FadeInImage.

• avoid-mounted-in-setstateflutter

  Check mounted before invoking Flutter State.setState, never inside its callback.

• avoid-printavoid_printrecommendedflutter

  Flags calls and callback arguments resolving to dart:core's print.

• avoid-recursive-widget-callsrecommendedflutter

  Warns when a widget's build method constructs the same widget again.

• avoid-returning-widgetsavoid-returning-widgetsflutter

  Disallow functions and methods that return a Widget.

• avoid-shrink-wrap-in-listsflutter

  Avoids shrink-wrapped Flutter lists nested in rows, columns, or other lists.

• avoid-single-child-column-or-rowavoid_single_child_column_or_rowflutter

  Flags a Column, Row, or Flex widget built with a single child.

• avoid-undisposed-instancesrecommendedflutter

  Warns when a disposable constructor result is discarded.

• avoid-unnecessary-containersavoid_unnecessary_containersrecommendedflutter

  Flags a Container whose only argument is a child.

• avoid-unnecessary-gesture-detectorflutter

  Flags handler-free Flutter GestureDetectors and tap-only wrappers around enabled Flutter buttons.

• avoid-unnecessary-overrides-in-stateflutter

  Redundant Flutter State overrides that drop inherited @protected.

• avoid-unnecessary-setstaterecommendedflutter

  Avoid setState during build, initState, or didUpdateWidget.

• avoid-unnecessary-stateful-widgetsrecommendedflutter

  Warns when a StatefulWidget's local State contains only a pure build method.

• avoid-web-libraries-in-flutteravoid_web_libraries_in_flutterrecommendedflutter

  Disallow importing web-only dart: libraries from Flutter code.

• avoid-wrapping-in-paddingflutter

  Flags Padding directly wrapping a Flutter Container that can own the padding.

• correct-order-for-super-disposecorrect_order_for_super_disposerecommendedflutter

  Require super.dispose() to be the last call in dispose.

• diagnostic-describe-all-propertiesdiagnostic_describe_all_propertiesflutter

  Requires every public property of a Diagnosticable class to be referenced in its debug methods.

• dispose-fieldsrecommendedflutter

  Requires other owned disposable State fields to be released in dispose().

• dispose-focus-node-and-timerrecommendedflutter

  Requires owned FocusNode and Timer fields to be released in State.dispose().

• minimum-touch-targetflutter

  Warn about explicitly undersized Flutter touch targets.

• no-logic-in-create-stateno_logic_in_create_staterecommendedflutter

  Require StatefulWidget.createState to return only a fresh zero-argument Flutter State construction.

• prefer-action-button-tooltipflutter

  Requires useful tooltips on Flutter floating action buttons and icon buttons.

• prefer-align-over-containerflutter

  Prefers Align over a Container used only for alignment.

• prefer-async-callbackprefer_async_callbackflutter

  Flags the type Future<void> Function() in favor of Flutter's AsyncCallback.

• prefer-center-over-alignflutter

  Prefers Center over an Align whose alignment is known to be centered.

• prefer-const-border-radiusprefer-const-border-radiusrecommendedflutter

  Flags BorderRadius.only(...) whose four corner radii are all equal.

• prefer-const-constructors-in-immutablesprefer_const_constructors_in_immutablesflutter

  Prefers const constructors in immutable classes and extension types.

• prefer-constrained-box-over-containerflutter

  Prefers ConstrainedBox over a Container used only for constraints.

• prefer-containerflutter

  Suggests collapsing compatible nested layout widgets into one Container.

• prefer-correct-edge-insets-constructorprefer-correct-edge-insets-constructorrecommendedflutter

  Flags an EdgeInsets.only(...) that a more specific constructor expresses better.

• prefer-declaring-const-constructorprefer_declaring_const_constructorflutter

  Flags a generative constructor that is legally eligible to be const.

• prefer-dedicated-media-query-methodsprefer_dedicated_media_query_methodsrecommendedflutter

  Flags MediaQuery.of(context).size access in favor of MediaQuery.sizeOf.

• prefer-define-hero-tagflutter

  Require an explicit heroTag on Flutter FloatingActionButton constructors.

• prefer-extracting-callbacksprefer-extracting-callbacksflutter

  Flags inline block-body callbacks passed to Widget constructors.

• prefer-for-loop-in-childrenflutter

  Prefers collection-for elements over eager map/toList chains in Flutter children.

• prefer-padding-over-containerflutter

  Prefers Padding over a Container used only for padding.

• prefer-single-setstateflutter

  Merge consecutive Flutter State.setState statements in the same block.

• prefer-sized-box-squareflutter

  Prefers SizedBox.square for an unnamed Flutter SizedBox whose explicit width and height are stable variable reads or numeric literals with identical token spelling.

• prefer-transform-over-containerflutter

  Prefers Transform over a Container used only for transform.

• prefer-using-list-viewflutter

  Suggests considering ListView for a SingleChildScrollView containing a plain Flutter Column with at least two unconditional children in a list literal.

• prefer-void-callbackflutter

  Prefers Flutter's VoidCallback alias over a nongeneric void Function() type.

• proper-controller-disposeproper_controller_disposerecommendedflutter

  Requires Flutter controllers owned by a State field to be disposed.

• proper-expanded-and-flexibleproper_expanded_and_flexiblerecommendedflutter

  Require Expanded and Flexible to sit directly inside a flex widget.

• proper-super-init-stateproper_super_init_staterecommendedflutter

  Require super.initState() to be the first statement of a resolved Flutter State subclass's initState override.

• require-super-disposerecommendedflutter

  Require super.dispose() in Flutter State dispose overrides.

• sized-box-for-whitespacesized_box_for_whitespacerecommendedflutter

  Flags a Container used only to add fixed width/height whitespace.

• sized-box-shrink-expandsized_box_shrink_expandrecommendedflutter

  Prefers SizedBox.shrink() / SizedBox.expand() over a SizedBox sized to zero or infinity.

• sort-child-properties-lastsort_child_properties_lastrecommendedflutter

  Sort Widget-valued child properties last, except before closure arguments.

• unnecessary-flutter-importsrecommendedflutter

  Disallow unused Flutter framework and dart:async imports.

• use-build-context-synchronouslyuse_build_context_synchronouslyrecommendedflutter

  Flags BuildContext use after an asynchronous gap without a mounted guard.

• use-closest-build-contextrecommendedflutter

  Use the nearest BuildContext parameter inside nested callbacks.

• use-colored-boxuse_colored_boxrecommendedflutter

  Prefers ColoredBox over a Container that only paints a color behind its child.

• use-decorated-boxuse_decorated_boxrecommendedflutter

  Prefers DecoratedBox over a Container that only decorates its child.

• use-design-system-itemuse-design-system-itemflutter

  Flags construction of a widget or type that should be replaced by its design-system equivalent.

• use-full-hex-values-for-flutter-colorsuse_full_hex_values_for_flutter_colorsrecommendedflutter

  Require an eight-digit hexadecimal integer for the canonical Flutter Color default constructor.

• use-key-in-widget-constructorsuse_key_in_widget_constructorsrecommendedflutter

  Require public widget constructors to accept or initialize a Flutter Key.

• use-once-constructors-once-provideruse_once_constructors_once_providerflutter

  Require Riverpod once-providers to be created through .once().

• use-setstate-synchronouslyrecommendedflutter

  Require a mounted check before calling setState after an async gap.

• use-spacer-as-expanded-childuse_spacer_as_expanded_childrecommendedflutter

  Flags an Expanded wrapping an empty SizedBox or Container that should be a Spacer.

• widget-tree-depthflutter

  Limits the depth of an inline Flutter widget construction tree.

Dart and Flutter test suites: assertions, matchers, and test structure.

• avoid-duplicate-test-assertionsrecommendedtest

  Reports repeated identical, side-effect-free assertions in a straight-line block.

• avoid-empty-test-groupstest

  Reports inline framework groups without any test registrations.

• avoid-top-level-members-in-teststest

  Requires public declarations in test files, except main, to be private.

• missing-test-assertionrecommendedtest

  Reports inline test callbacks that contain no recognized assertion calls.

• prefer-correct-test-file-nametest

  Requires entry-point files under package-root test/ or integration_test/ to use the _test.dart suffix.

• prefer-expect-latertest

  Requires expectLater when a canonical expect call receives an unawaited Future.

• prefer-test-matcherstest

  Recommends Matcher expectations and direct type, equality, or ordering matchers.

• prefer-unique-test-namestest

  Reports duplicate test descriptions within a group and constant names in loops.

Blocs and Cubits from package:bloc: events, states, and emit discipline.

• avoid-bloc-public-fieldsbloc

  Keep package-confirmed Bloc instance fields private; inherited API overrides are allowed.

• avoid-bloc-public-methodsbloc

  Enforce the package-confirmed Bloc convention.

• avoid-duplicate-bloc-event-handlersrecommendedbloc

  Flags later registrations of the same event type in a Bloc constructor.

• avoid-emit-outside-blocrecommendedbloc

  Flags external calls and tear-offs of a Bloc or Cubit's emit method.

• avoid-passing-bloc-to-blocbloc

  Rejects direct Bloc and Cubit arguments to other blocs.

• avoid-passing-bloc-to-widgetbloc

  Rejects direct Bloc and Cubit arguments to Flutter widget constructors.

• avoid-passing-build-context-to-blocsbloc

  Keeps Flutter BuildContext arguments outside Bloc and Cubit APIs.

• check-is-not-closed-after-async-gaprecommendedbloc

  Flags Bloc add and emit calls after an await without a fresh isClosed check.

• emit-new-bloc-state-instancesrecommendedbloc

  Flags Bloc and Cubit emissions that reuse their current state instance.

• handle-bloc-event-subclassesbloc

  Warns when a Bloc constructor leaves a concrete event subclass without a handler.

• prefer-bloc-event-suffixbloc

  Enforce the package-confirmed Bloc convention.

• prefer-bloc-extensionsbloc

  Prefer context.read/watch over package:flutter_bloc's provider lookups.

• prefer-bloc-state-suffixbloc

  Enforce the package-confirmed Bloc convention.

• prefer-immutable-bloc-eventsrecommendedbloc

  Flags Bloc event classes without an explicit @immutable annotation.

• prefer-immutable-bloc-staterecommendedbloc

  Flags Bloc state classes without an explicit @immutable annotation.

• prefer-multi-bloc-providerbloc

  Flatten directly nested package:flutter_bloc BlocProviders with MultiBlocProvider.

• prefer-sealed-bloc-eventsrecommendedbloc

  Flags Bloc event classes without a sealed or final modifier.

• prefer-sealed-bloc-staterecommendedbloc

  Flags Bloc state classes without a sealed or final modifier.

Providers and refs from package:riverpod and flutter_riverpod.

• avoid-calling-notifier-members-inside-buildrecommendedriverpod

  Flags calls to Riverpod notifier methods during widget build.

• avoid-public-notifier-propertiesriverpod

  Keeps notifier state behind Riverpod's observable state property.

• avoid-ref-inside-state-disposeriverpod

  Rejects Riverpod widget references used during State.dispose.

• avoid-ref-read-inside-buildrecommendedriverpod

  Flags one-time Riverpod reads of provider state during widget build.

• avoid-ref-watch-outside-buildrecommendedriverpod

  Flags Riverpod WidgetRef.watch subscriptions outside synchronous widget build bodies.

• avoid-unnecessary-consumer-widgetsriverpod

  Flags Riverpod consumer widgets whose build reference is unused.

• dispose-provided-instancesrecommendedriverpod

  Flags provider-created instances with a dispose method that lack ref.onDispose cleanup.

• dispose-provider-resourcesrecommendedriverpod

  Flags provider-created resources without autoDispose or ref.onDispose cleanup.

• prefer-correct-notifier-file-nameriverpod

  Requires snake_case file names ending in _notifier.dart for resolved Riverpod notifier classes.

• prefer-correct-provider-file-nameriverpod

  Requires snake_case file names ending in _provider.dart for resolved Riverpod provider declarations, including annotated generator functions.

• prefer-immutable-provider-argumentsriverpod

  Requires stable value equality for freshly created Riverpod family keys.

• prefer-ref-read-for-methodsrecommendedriverpod

  Flags watching a Riverpod notifier solely to invoke one of its methods.

• prefer-riverpod-notifier-suffixriverpod

  Requires a Notifier suffix on classes extending resolved Riverpod notifiers.

• prefer-riverpod-provider-suffixriverpod

  Requires a Provider suffix on resolved Riverpod top-level providers and static fields.

• use-ref-and-state-synchronouslyrecommendedriverpod

  Flags notifier ref and state accesses after an async gap without ref.mounted.

• use-ref-read-synchronouslyrecommendedriverpod

  Flags Riverpod WidgetRef.read calls after an async gap without a mounted guard.

package:provider: reading, watching, and disposing providers.

• avoid-instantiating-in-value-providerprovider

  Value providers borrow existing instances; newly constructed values need create.

• avoid-read-inside-buildrecommendedprovider

  Flags non-listening Provider reads directly inside Flutter widget builds.

• avoid-watch-outside-buildrecommendedprovider

  Flags listening Provider accesses proven to run outside Flutter builds.

• dispose-providersrecommendedprovider

  Requires cleanup callbacks for disposable values created by package:provider's Provider.

• prefer-multi-providerprovider

  Prefer a flat MultiProvider to directly nested provider widgets.

• prefer-provider-extensionsprovider

  Prefer context.read/watch when provider extensions are in scope.

• prefer-read-for-methodsrecommendedprovider

  Flags void method actions on a listening Provider lookup during build.

Hook rules for package:flutter_hooks.

• avoid-conditional-hooksrecommendedflutter_hooks

  Flags hook calls in conditional branches, short-circuit operands, and loops.

• avoid-hooks-outside-buildrecommendedflutter_hooks

  Flags confirmed Flutter hooks outside hook builds, custom hooks, and HookBuilder/HookConsumer builders.

• avoid-misused-hooksrecommendedflutter_hooks

  Flags confirmed Flutter hooks called directly in non-hook Flutter widget builds.

• avoid-unnecessary-hook-widgetsflutter_hooks

  Flags confirmed hook widgets and HookBuilder callbacks that do not use hooks.

• prefer-use-callbackflutter_hooks

  Prefer useCallback for synchronous memoized function literals.

• prefer-use-memoflutter_hooks

  Prefer memoizing freshly allocated collection values used as hook keys.

Value equality with package:equatable.

• add-equatable-propsrecommendedequatable

  Flags concrete Equatable subclasses that do not declare an instance props property.

• avoid-mutable-equatable-subclass-fieldsrecommendedequatable

  Flags mutable instance fields on subclasses inheriting Equatable equality.

• extend-equatableequatable

  Require Equatable semantics for configured class/file name patterns.

• list-all-equatable-fieldsrecommendedequatable

  Flags declared instance fields omitted from a statically understood Equatable props list.

• prefer-equatable-mixinequatable

  Prefer EquatableMixin to directly extending package:equatable's Equatable.