riverpod-migration

Migrate Riverpod from StateNotifier to Notifier/AsyncNotifier, from ChangeNotifier to AsyncNotifier, or upgrade from 0.13/0.14/1.0; ref.onDispose, family, lifecycle, riverpod migrate CLI. Use when ...

Riverpod — Migration guides#

한마디로 (비개발자용)#

앱의 화면 상태(예: 로딩 중인지, 데이터가 준비됐는지)를 관리하는 도구가 Riverpod입니다. 이 스킬은 그 도구의 낡은 버전을 새 버전으로 갈아타는 "이사 안내서" 모음이에요. 마치 오래된 가전제품을 신형으로 바꿀 때 어떤 코드를 뽑고 어디에 다시 꽂아야 하는지 알려주는 설명서와 같습니다. 상황별로 맞는 안내서를 골라 단계대로 따라가도록 도와줍니다.

무엇을·언제 (비개발자용)#

무엇을: 옛날 방식으로 짠 상태 관리 코드를 최신 방식으로 안전하게 옮기는 길을 안내합니다.
어떤 경우를 다루나요:
- 예전 방식(StateNotifier)에서 새 방식(Notifier/AsyncNotifier)으로 옮길 때
- 또 다른 예전 방식(ChangeNotifier)에서 새 방식(AsyncNotifier)으로 옮길 때
- 버전 0.13에서 0.14로, 0.14에서 1.0으로 올릴 때
- (2.0에서 3.0으로 올리는 경우는 다른 스킬을 안내합니다)
언제 작동하나요: 위와 같은 "Riverpod 버전 올리기" 또는 "옛 방식에서 새 방식으로 바꾸기"를 물어볼 때 자동으로 도움을 줍니다.
추가 도움: 버전 올리기 작업은 자동 변환 도구(CLI)를 실행해 손이 덜 가게 처리할 수도 있다고 알려줍니다.

핵심 용어 (비개발자용)#

용어	쉬운 설명
Riverpod	앱 화면의 상태(데이터, 로딩 여부 등)를 정리해 관리하는 도구
마이그레이션(migration)	낡은 방식·버전에서 새 방식·버전으로 갈아타는 이사 작업
StateNotifier / Notifier / AsyncNotifier / ChangeNotifier	상태를 다루는 방식들. 뒤로 갈수록 더 새롭고 권장되는 방식
AsyncValue	"로딩 중 / 성공 / 오류"를 한 덩어리로 깔끔하게 표현해 주는 값
CLI	명령어로 작업을 자동 실행하는 도구. 여기서는 버전 변환을 자동으로 거들어 줌
ref.onDispose	화면이 닫힐 때 뒷정리(리소스 해제)를 자동으로 해주는 장치

Instructions#

This skill points to detailed migration guides for different scenarios. Use the reference file that matches your case.

When to use which guide#

Scenario	Reference
From StateNotifier to Notifier / AsyncNotifier	migration_from_state_notifier.md
From ChangeNotifier to AsyncNotifier	migration_from_change_notifier.md
Upgrade 0.13.x → 0.14.x (StateNotifierProvider syntax, watch(provider) vs provider.state)	migration_0_13_0_14.md
Upgrade 0.14.x → 1.0 (ScopedReader → WidgetRef, useProvider → ref.watch, StateProvider)	migration_0_14_1_0.md

For Riverpod 2.0 → 3.0 see the riverpod-3-0-migration skill.

Common themes#

StateNotifier → Notifier/AsyncNotifier: Put init logic in build; use ref.onDispose instead of overloading dispose; no mounted—use cancellation (e.g. Completer or HTTP cancel token). Consumers stay the same (ref.watch, methods on notifier).
ChangeNotifier → AsyncNotifier: Replace isLoading/hasError/manual try-catch with AsyncValue; single state; mutations by reassigning state.
CLI: For 0.14 and 1.0 upgrades you can run dart pub global activate riverpod_cli then riverpod migrate in the project (do not upgrade Riverpod manually first; the tool will suggest version and changes).

Open the relevant reference file for step-by-step instructions and code examples.