Flutter Riverpod 2.0 Complete Guide — Notifier & AsyncNotifier for Modern State Management

Riverpod 2.0 introduced Notifier and AsyncNotifier as modern replacements for StateNotifierProvider . Combined with riverpod_generator , they drastically cut boilerplate.

Riverpod 2.0 API Overview

Old API New API Use Case

StateProvider @riverpod + Ref Simple values

StateNotifierProvider @riverpod class X extends Notifier Sync state

FutureProvider @riverpod Future<X> x(Ref ref) Async data

StateNotifierProvider (async) @riverpod class X extends AsyncNotifier Async state

Setup

dependencies : flutter_riverpod : ^2.5.1 riverpod_annotation : ^2.3.5

dev_dependencies : riverpod_generator : ^2.4.0 build_runner : ^2.4.9

Enter fullscreen mode

Exit fullscreen mode

Notifier — Synchronous State

// lib/providers/counter_provider.dart import 'package:riverpod_annotation/riverpod_annotation.dart' ; part 'counter_provider.g.dart' ;

@riverpod class Counter extends _$Counter { @override int build () = > 0 ;

void increment…