riverpod-3-0-migration

Guide Flutter developers through Riverpod 2.0 to 3.0 migration changes.

Updated Mar 15, 2026
One-click install
npx skills add https://github.com/dangdungvn/review_system_app --skill riverpod-3-0-migration-dangdungvn
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: riverpod-3-0-migration
Source: https://github.com/dangdungvn/review_system_app/tree/main/.github/skills/riverpod-3-0-migration
Command: npx skills add https://github.com/dangdungvn/review_system_app --skill riverpod-3-0-migration-dangdungvn

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps developers migrate their Flutter applications from Riverpod version 2.0 to 3.0 by outlining the key breaking changes and providing guidance on how to update their code.

Core Features & Use Cases

  • Migration Guidance: Provides step-by-step instructions for adapting to Riverpod 3.0's new features and syntax.
  • Key Changes Covered: Automatic retries, paused listeners, legacy provider usage, simplified Ref, ProviderException, and more.
  • Use Case: A developer is upgrading their existing Flutter app that heavily uses Riverpod and needs to understand the impact of Riverpod 3.0's breaking changes to ensure a smooth transition.

Quick Start

Use the riverpod-3-0-migration skill to understand how to update your Riverpod 2.0 code to Riverpod 3.0.

Frequently Asked Questions about riverpod-3-0-migration

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I migrate my Flutter app to Riverpod 3.0?

Migrating to Riverpod 3.0 requires addressing breaking changes like automatic retries, paused listeners, legacy provider imports, and the simplified Ref API to ensure enhanced functionality and stability.

What are the breaking changes in Riverpod 3.0?

Riverpod 3.0 breaking changes include automatic retries, paused listeners, legacy provider imports, a simplified Ref API, and updated ProviderException handling that require code modifications during migration.

How do I handle paused listeners when upgrading to Riverpod 3.0?

When upgrading to Riverpod 3.0, you must adapt your code to the new paused listeners behavior as part of the migration process to ensure your application's state management continues functioning correctly.

Does Riverpod 3.0 change how ProviderException is handled?

Yes, Riverpod 3.0 introduces updates to ProviderException handling, requiring developers to adjust their error management strategies when migrating from version 2.0 to maintain application stability.

What is the simplified Ref API in Riverpod 3.0?

The simplified Ref API in Riverpod 3.0 streamlines how developers interact with providers, requiring updates to existing Riverpod 2.0 codebases to align with the new, cleaner reference structure.

Why am I getting legacy provider import errors after upgrading Riverpod?

Legacy provider import errors occur after upgrading Riverpod because version 3.0 modifies import structures, requiring you to update your import paths to successfully complete the migration process.