Riverpod overview in Flutter

Introduction

Riverpod helps you manage app data and state in a simple and safe way. It makes your app easier to build and maintain.

You want to share data between different screens in your app.

You need to update the UI when data changes.

You want to keep your app organized and avoid bugs with state.

You want to test your app logic easily.

You want a modern and flexible way to manage app state.

Syntax

Flutter

final myProvider = Provider((ref) => 'Hello Riverpod');

class MyApp extends ConsumerWidget {
  @override
  Widget build(BuildContext context, WidgetRef ref) {
    final value = ref.watch(myProvider);
    return Text(value);
  }
}

Provider creates a piece of data or logic you can use anywhere.

ConsumerWidget lets you read providers and rebuild UI when data changes.

Examples

This creates a simple provider that returns a string.

Flutter

final greetingProvider = Provider((ref) => 'Hello World');

This creates a provider that holds a number you can change.

Flutter

final counterProvider = StateProvider((ref) => 0);

This provider fetches data asynchronously, like from the internet.

Flutter

final userProvider = FutureProvider((ref) async {
  return fetchUserData();
});

Sample App

This app shows a number that starts at zero. When you press the button, the number goes up by one. Riverpod manages the number state and updates the screen automatically.

Flutter

import 'package:flutter/material.dart';
import 'package:flutter_riverpod/flutter_riverpod.dart';

final counterProvider = StateProvider<int>((ref) => 0);

void main() {
  runApp(ProviderScope(child: MyApp()));
}

class MyApp extends ConsumerWidget {
  @override
  Widget build(BuildContext context, WidgetRef ref) {
    final count = ref.watch(counterProvider);
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(title: Text('Riverpod Counter')),
        body: Center(
          child: Text('Count: $count', style: TextStyle(fontSize: 24)),
        ),
        floatingActionButton: FloatingActionButton(
          onPressed: () => ref.read(counterProvider.notifier).state++,
          child: Icon(Icons.add),
          tooltip: 'Increment',
        ),
      ),
    );
  }
}

Important Notes

Always wrap your app with ProviderScope to use Riverpod.

Use ref.watch to listen to provider changes and rebuild UI.

Use StateProvider for simple mutable state like counters.

Summary

Riverpod helps manage app data and state clearly and safely.

Providers create and share data or logic across your app.

ConsumerWidget rebuilds UI when provider data changes.

Practice

1. What is the main purpose of Riverpod in Flutter apps?

easy

A. To manage app data and state clearly and safely

B. To create animations easily

C. To handle user input events

D. To design app layouts

Solution

1. Step 1: Understand Riverpod's role

   Riverpod is a tool to manage state and data in Flutter apps.

2. Step 2: Compare options

   Only To manage app data and state clearly and safely describes managing app data and state clearly and safely, which is Riverpod's main purpose.

3. Final Answer:

   To manage app data and state clearly and safely -> Option A

4. Quick Check:

   Riverpod = state management [OK]

Hint: Remember Riverpod is about state and data, not UI design [OK]

Common Mistakes:

• Confusing Riverpod with UI or animation tools
• Thinking Riverpod handles layouts or gestures

2. Which of the following is the correct way to declare a simple Riverpod provider for an integer value 0?

easy

A. final counterProvider = Provider((ref) => '0');

B. final counterProvider = Provider<int>((ref) => 0);

C. final counterProvider = Provider<int>((ref) => '0');

D. final counterProvider = Provider<int>((ref) => null);

Solution

1. Step 1: Check provider type and value

   The provider is typed as int and returns 0, which matches.

2. Step 2: Validate other options

   final counterProvider = Provider((ref) => '0'); returns a string '0' but no type specified; final counterProvider = Provider<int>((ref) => '0'); returns string '0' but typed int; final counterProvider = Provider<int>((ref) => null); returns null which is invalid for int.

3. Final Answer:

   final counterProvider = Provider<int>((ref) => 0); -> Option B

4. Quick Check:

   Provider<int> must return int value [OK]

Hint: Match provider type with returned value type exactly [OK]

Common Mistakes:

• Returning wrong data type for the provider
• Omitting type when needed
• Returning null for non-nullable types

3. Given this Riverpod code snippet, what will be printed?

final greetingProvider = Provider((ref) => 'Hello');

class GreetingWidget extends ConsumerWidget {
  @override
  Widget build(BuildContext context, WidgetRef ref) {
    final greeting = ref.watch(greetingProvider);
    print(greeting);
    return Text(greeting);
  }
}

medium

A. Empty string

B. null

C. Error: greetingProvider not found

D. Hello

Solution

1. Step 1: Understand provider value

   greetingProvider returns the string 'Hello'.

2. Step 2: Check what ref.watch returns

   ref.watch(greetingProvider) gets 'Hello', so print outputs 'Hello'.

3. Final Answer:

   Hello -> Option D

4. Quick Check:

   ref.watch returns provider value [OK]

Hint: ref.watch returns the provider's current value [OK]

Common Mistakes:

• Assuming ref.watch returns null or error
• Confusing provider names
• Forgetting provider returns a value

4. What is wrong with this Riverpod provider declaration?

final numberProvider = Provider<int>((ref) {
  return '42';
});

medium

A. The provider is missing a required parameter

B. The provider should be a StateProvider instead

C. The provider returns a string instead of an int

D. The provider declaration syntax is invalid

Solution

1. Step 1: Check return type vs provider type

   The provider is typed as int but returns a string '42'.

2. Step 2: Identify the mismatch error

   This type mismatch causes a compile-time error.

3. Final Answer:

   The provider returns a string instead of an int -> Option C

4. Quick Check:

   Provider<int> must return int, not string [OK]

Hint: Return type must match provider's declared type exactly [OK]

Common Mistakes:

• Returning wrong data type
• Ignoring type errors
• Confusing Provider and StateProvider roles

5. You want to create a counter app using Riverpod where the UI updates when the counter changes. Which provider type and widget combination is best to achieve this?

hard

A. Use StateProvider<int> for counter and ConsumerWidget to rebuild UI

B. Use Provider<int> for counter and StatelessWidget to rebuild UI

C. Use FutureProvider<int> for counter and StatefulWidget to rebuild UI

D. Use StreamProvider<int> for counter and ConsumerWidget to rebuild UI

Solution

1. Step 1: Choose provider type for mutable state

   StateProvider<int> allows changing the counter value and notifying listeners.

2. Step 2: Choose widget that listens to provider changes

   ConsumerWidget rebuilds UI automatically when provider data changes.

3. Final Answer:

   Use StateProvider<int> for counter and ConsumerWidget to rebuild UI -> Option A

4. Quick Check:

   StateProvider + ConsumerWidget = reactive counter [OK]

Hint: Use StateProvider for changeable state and ConsumerWidget for UI updates [OK]

Common Mistakes:

• Using Provider instead of StateProvider for mutable state
• Using StatelessWidget which doesn't rebuild on changes
• Confusing FutureProvider or StreamProvider for simple counters