Production Learning Lab

Master Riverpod 3 Through Real Production Code

Learn Flutter Riverpod 3 incrementally from absolute zero to advanced architectural patterns. Deconstruct real source code from Transwave, a live crowd-shipping marketplace app.

Start Learning (Phase 0)

14-Phase Master Roadmap

Explore the complete interactive curriculum. Each chapter evaluates code against Riverpod 3 best practices, trade-offs, and design rationale.

Phase 00 Framework Ready

Documentation Foundation

UI design system tokens, sticky layout architecture, code highlighting, callout boxes, decision trees, and interactive components.

Explore Chapter 0 →

Phase 01 Milestone 2

Getting Started with Riverpod

Why Provider was replaced, ProviderScope initialization, ConsumerWidget, watch(), read(), and listen().

Phase 02 Milestone 2

Core Concepts & Ref Lifecycle

Deep dive into Ref, autoDispose vs keepAlive, invalidateSelf(), refresh(), and lifecycle listeners.

Phase 03 Milestone 2

Provider Taxonomy & Matrix

Notifier, AsyncNotifier, StreamProvider, FutureProvider, Families, and decision trees.

Phase 04 Milestone 2

Code Generation with @riverpod

riverpod_annotation, build_runner, generated .g.dart files, and auto-generated Provider typedefs.

Phase 05 Milestone 2

Clean Architecture & Features

Feature-first folder structure, repository injection, Dio ApiClient, and domain isolation.

Phase 06 Milestone 3

Deep Dive: auth_provider.dart

Line-by-line breakdown of Transwave Firebase auth state stream provider and mockability trade-offs.

Phase 07 Milestone 3

Deep Dive: current_user_provider.dart

AsyncNotifier caching, local user state mutation, copyWith, and ref.mounted guards.

Phase 08 Milestone 3

Deep Dive: login_controller.dart

Mutation controller pattern, multi-step transaction pipelines, FCM device registration.

Phase 09 Milestone 3

Deep Dive: shipment_provider.dart

Family provider arguments, mandatory operator == & hashCode overrides, dynamic filter pagination.

Phase 10 Milestone 3

Deep Dive: map_items_provider.dart

1,673-line production analysis: SpatialCacheEnvelope, Server-Sent Events (SSE) sync, bounds containment.

Phase 11 Milestone 4

Advanced Riverpod & Testing

Headless unit testing with ProviderContainer, ProviderScope overrides, performance logging.

Phase 12 Milestone 4

Common Mistakes & Anti-Patterns

Diagnostic guide to ref.read inside build, un-overridden families, memory leaks, circular deadlocks.

Phase 13 Milestone 4

Production Readiness Checklist

Comprehensive audit checklist across architecture, AsyncValue safety, code gen, and testing.