Start Debugging

Tag: riverpod

15 posts · Page 1 of 2

2026-09-05 comparison flutter dart

ref.watch vs ref.read in Riverpod: what is the difference and when do I use each?

ref.watch subscribes and rebuilds, ref.read reads once and never rebuilds. Use watch in every build method and read only inside event callbacks. Here is the decision matrix, the source of both methods in flutter_riverpod 3.4.3, and the four silent failure modes: watch in a callback, read in a provider body, read on an autoDispose provider, and read used as an optimization.

2026-08-15 comparison flutter dart

Riverpod Notifier vs AsyncNotifier vs StreamNotifier in Flutter: which one do I extend?

Pick by the return type of build(): T means Notifier, FutureOr<T> means AsyncNotifier, Stream<T> means StreamNotifier. Here is the decision matrix, the type hierarchy that explains why, and the == filtering and state-clobbering gotchas that bite each one. Verified against flutter_riverpod 3.4.2 on Flutter 3.44.2.

2026-07-25 migration flutter dart

Migrate a setState StatefulWidget to a Riverpod Notifier in Flutter

A step-by-step move from widget-local setState to a Riverpod 3.x Notifier: classify what actually leaves the widget, write the Notifier, convert to ConsumerWidget, and survive the == filtering, build() re-entry, and autoDispose defaults that bite setState refugees. Tested on Flutter 3.44, Dart 3.x, flutter_riverpod 3.3.2.

2026-07-23 comparison flutter dart

riverpod vs flutter_riverpod vs hooks_riverpod: which package do I actually need?

Install flutter_riverpod for almost every Flutter app. Use riverpod only for Dart-only code, and hooks_riverpod only if you already use flutter_hooks.

2026-07-21 flutter dart riverpod

Fix: Riverpod 3.0 StreamProvider stops emitting because updates are filtered by ==

In Riverpod 3.0 every provider filters listener notifications with ==, not identity. A StreamProvider that re-emits the same mutable object stops rebuilding the UI after the first frame. Here is why it happens and three ways to fix it. Tested on flutter_riverpod 3.3.2, Flutter 3.44, Dart 3.x.

2026-07-20 flutter dart riverpod

How to disable Riverpod 3.0's automatic provider retry

Riverpod 3.0 retries a failed provider up to 10 times by default. Pass a retry function that returns null on ProviderScope, ProviderContainer, or an individual provider to turn it off or bound it.

2026-07-09 migration flutter dart

Migrate from Riverpod 2.x to Riverpod 3.0 in Flutter

A step-by-step upgrade from flutter_riverpod 2.x to 3.x: bump the packages, move StateProvider and friends to the legacy import, drop the AutoDispose and Family ref types, handle ProviderException wrapping and automatic retry, and fix the == notification filtering that silently drops StreamProvider events. Tested on Flutter 3.44, Dart 3.x, flutter_riverpod 3.3.2.

2026-07-06 errors flutter dart

Fix: Riverpod 3.0 throws ProviderException instead of the original error

Riverpod 3.0 wraps errors thrown while reading a provider in a ProviderException. Catch that type and read e.exception to get your original error back, or use AsyncValue.error which is unwrapped.

2026-07-04 flutter dart riverpod

How to Check Ref.mounted After an Async Gap in Flutter Riverpod 3

In a Notifier, resolve dependencies before the await, then guard the state write with if (!ref.mounted) return. This is the Riverpod 3.0 replacement for the old onDispose mixin, and it stops UnmountedRefException when a provider is disposed mid-await. Tested on flutter_riverpod 3.x, Flutter 3.44, Dart 3.x.

2026-06-18 migration flutter riverpod

Migrate from FutureBuilder to a Riverpod AsyncNotifier in Flutter (flutter_riverpod 3.3.2)

A step-by-step migration from an inline FutureBuilder widget to a Riverpod AsyncNotifier in a real Flutter app: move the async work out of build, expose it as a provider, render with .when() or switch pattern matching, and add refresh and mutation methods. Tested on Flutter 3.44, Dart 3.x, flutter_riverpod 3.3.2.