Riverpod v3 template
A Riverpod v3 boilerplate without the boilerplate
Riverpod v3 is the current standard for Flutter state management. Flutter Agent Kit ships a production-tested Riverpod v3 architecture with plain Dart models and feature-first organization, ready to scaffold.
Why Riverpod v3
Riverpod is the most widely adopted state management solution in the Flutter ecosystem, and it is what AI agents write best by default because it dominates their training data. Building on Riverpod v3 means generated code and community answers both fit your project.
The kit uses Riverpod v3 Notifiers throughout, including a v3 Notifier backed by the local Sembast database in the local-db skill, so patterns stay consistent from local storage to network calls.
Plain Dart models, no codegen
Most Riverpod templates pair with freezed or json_serializable. That adds a build_runner step the agent has to run and wait for, and generated files bloat every diff.
Flutter Agent Kit uses plain Dart classes with fromJson and toJson. The model is readable at a glance, the agent can edit it directly, and reviews stay fast.
The model pattern the kit uses:
class Product {
final String id;
final String name;
final int priceCents;
const Product({
required this.id,
required this.name,
required this.priceCents,
});
factory Product.fromJson(Map<String, dynamic> json) {
return Product(
id: json['id'] as String,
name: json['name'] as String,
priceCents: json['priceCents'] as int,
);
}
Map<String, dynamic> toJson() {
return {
'id': id,
'name': name,
'priceCents': priceCents,
};
}
}Feature-first organization
The template organizes code by feature, not by type. Each feature is self-contained, which means your agent can add or modify a feature without touching the rest of the codebase, and you can review the change in one place.
The AGENTS.md file pins this layout so the agent never reintroduces a type-first structure halfway through the project.
What the Riverpod v3 template includes
- Scaffold command: One command generates the full project, ready to open in your editor.
- Riverpod v3 throughout: Notifiers, providers and service classes wired consistently.
- GoRouter navigation: Named routes and deep links configured, with a dedicated skill for extending them.
- Sembast local database: CRUD services and a v3 Notifier backed by the database.
- Firestore option: Cloud Firestore collections with real-time streams when you go online.
Frequently asked questions
Why no freezed or json_serializable?
Codegen adds a build step and generated files that make every diff harder to read, which is a real cost when an AI agent writes most of the code. Plain Dart models with fromJson and toJson are readable, editable and fast to review.
Is this compatible with Riverpod v3 code generators?
The kit uses theNotifier-based API rather than code generation for providers. You can add codegen packages yourself, but the shipped patterns do not require them.
Is the template production-tested?
Yes. The same template shipped BitPong, a Flutter app with 1000+ active users on the App Store, so the patterns are proven on the App Store, not just in a demo.
Get Flutter Agent Kit
Each of these templates ships as part of Flutter Agent Kit, along with the AGENTS.md context layer and the skills that keep your agent inside the architecture. One purchase, €99.99, lifetime updates, unlimited projects.