riverpod-migration

Migrate Riverpod codebases to Notifier/AsyncNotifier using step-by-step guides.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Migrate Riverpod codebases to Notifier/AsyncNotifier or upgrade from 0.13/0.14 to 1.0 using concise, scenario-based guides that reduce boilerplate and avoid common pitfalls.

Core Features & Use Cases

  • StateNotifier → Notifier/AsyncNotifier migration guides to modernize provider patterns.
  • ChangeNotifier → AsyncNotifier migrations to simplify state and improve error handling with AsyncValue.
  • CLI-assisted upgrades (riverpod migrate) and version-transition playbooks for safe, reproducible changes.

Quick Start

Open the matching migration guide in the reference folder and apply the recommended changes to your Riverpod setup.

Frequently Asked Questions about riverpod-migration

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

FAQPage Schema
How do I migrate Riverpod StateNotifier to Notifier?

To migrate Riverpod StateNotifier to Notifier, open the matching migration guide in the reference folder and apply the recommended changes to modernize your provider patterns and update provider types.

What is the best way to upgrade Riverpod from 0.14 to 1.0?

The best way to upgrade Riverpod from 0.14 to 1.0 is using the version-transition playbooks and CLI-assisted upgrades to ensure safe, reproducible changes across your modules.

Can I use CLI tooling to migrate ChangeNotifier to AsyncNotifier?

Yes, you can use CLI tooling guidance to migrate ChangeNotifier to AsyncNotifier, which simplifies state management and improves error handling using AsyncValue.

Does Riverpod migration support moving init logic to the build method?

Yes, Riverpod migration supports moving initialization logic to the build method and provides guidance on correct usage of ref.watch and ref.notifier for updated providers.

How do I validate Riverpod migration changes in large apps?

You validate Riverpod migration changes in large apps by running tests after applying the step-by-step migration guides to ensure correct behavior across modules.

When should I not use the riverpod migrate CLI command?

You should avoid using the riverpod migrate CLI command when your project does not use StateNotifier or ChangeNotifier, as the migration guides specifically target these provider patterns.