autoverpod_generator
Code generator for autoverpod - generates state field widgets from Riverpod providers.
What this package is like to depend on
Last release 5 months ago
04 Mar 2026
Release timing varies
gaps range from 8 days to 5 months
Nearly every release is documented
notes for 14 of 14 stable releases
Nothing withdrawn
no release was ever pulled
1 years old
14 releases · first in 2025
9 releases in the last 12 months
see the full history below
Release timeline
14 releases · Feb 2025 to Mar 2026Releases
latest 14-
0.1.704 Mar 2026Release notes
Open source →Release of autoverpod_generator package version 0.1.7
Installation
dev_dependencies: autoverpod_generator: ^0.1.7
Release notes
Open source →Bug Fixes
- Propagate async skip config through scope - Generated scope inherited data now carries
skipLoadingOnRefresh,skipLoadingOnReload, andskipError, allowing generated async select/field widgets to reuse scope-level skip behavior automatically.
- Propagate async skip config through scope - Generated scope inherited data now carries
-
0.1.604 Mar 2026Release notes
Open source →Release of autoverpod_generator package version 0.1.6
Installation
dev_dependencies: autoverpod_generator: ^0.1.6
Release notes
Open source →Improvements
- Async scope skip flags - Generated
*Scopewidgets for async providers now exposeskipLoadingOnRefresh,skipLoadingOnReload, andskipErrorand pass them through toAsyncValue.when(...). - Better scope constructor ergonomics - Generated async
*Scopeconstructors no longer require nullableloading/errorarguments; they remain validated by assertion when no custombuilderis provided.
- Async scope skip flags - Generated
-
0.1.527 Feb 2026Release notes
Open source →Release of autoverpod_generator package version 0.1.5
Installation
dev_dependencies: autoverpod_generator: ^0.1.5
Release notes
Open source →Improvements
- Expose raw
WidgetRefin proxy refs - Generated*ProxyWidgetRefclasses now includewidgetRef, enabling directWidgetRefaccess for extension methods and advanced Riverpod APIs when needed.
- Expose raw
-
0.1.422 Feb 2026Release notes
Open source →Release of autoverpod_generator package version 0.1.4
Installation
dev_dependencies: autoverpod_generator: ^0.1.4
Release notes
Open source →- Expose raw
WidgetRefon generated*ProxyWidgetRefviawidgetRefto support extension methods and direct Riverpod API usage.
Release notes
Open source →Bug Fixes
- Import resolution with prefixes/combinators - Prevent skipped type imports when source imports use
as,show, orhide, avoiding generated.widget.dartcompile failures for unqualified type references. - Stale type-index cache in watch builds - Clear type import caches on each generation run so moved/renamed/new files are resolved correctly without restarting the build process.
Improvements
- Safer type extraction - Centralize guarded type/import access via
TypeUtilsso generator model parsing tolerates analyzer edge cases and falls back gracefully.
- Expose raw
-
0.1.320 Feb 2026Release notes
Open source →Release of autoverpod_generator package version 0.1.3
Installation
dev_dependencies: autoverpod_generator: ^0.1.3
Release notes
Open source →- Relax analyzer dependency constraint to allow up to
<11.0.0 - Upgrade other dependencies to their latest compatible versions
- Relax analyzer dependency constraint to allow up to
-
0.1.213 Dec 2025Release notes
Open source →Release of autoverpod_generator package version 0.1.2
Installation
dev_dependencies: autoverpod_generator: ^0.1.2
Release notes
Open source →Improvements
- Generated header fields - Include
ref.textControllerfor number fields in generated header field summaries. - Field widget support - Update generation to better support numeric field widgets backed by
NumberField.
- Generated header fields - Include
-
0.1.112 Dec 2025Release notes
Open source →Release of autoverpod package version 0.1.1
Installation
dependencies: autoverpod: ^0.1.1
Release notes
Open source →Release of autoverpod_generator package version 0.1.1
Installation
dev_dependencies: autoverpod_generator: ^0.1.1
Release notes
Open source →New Features
- ParamsBuilder widget - New widget for family providers that exposes family parameters in a builder callback with full
select/notifieraccess viaProxyWidgetRef - Usage examples in doc comments - All generated widgets now include
/// **Usage:**code examples for better AI/IDE assistance
Bug Fixes
- Fixed
valueOrNullcompile error - Changed tovaluefor riverpod 3.x compatibility - Fixed
getterscompile error - Useaccessors.any((a) => a.isGetter)for lean_builder compatibility - Fixed duplicate header comments - Removed duplicate header since lean_builder adds its own
- Fixed
file://URI imports - UseshortUriinstead ofurito get properpackage://imports
Improvements
- Single param optimization - Family providers with single parameter now use simple type (
int) instead of record (({int id})) for cleaner generated code - Cleaner generated output - Reduced boilerplate in generated widgets
- ParamsBuilder widget - New widget for family providers that exposes family parameters in a builder callback with full
-
0.1.011 Dec 2025Release notes
Open source →Release of autoverpod package version 0.1.0
Installation
dependencies: autoverpod: ^0.1.0
Release notes
Open source →⚠️ COMPLETE REWRITE - BREAKING CHANGES
This version is a complete rewrite of the autoverpod package. The previous complex form-focused architecture has been replaced with a simpler, more maintainable state widget approach.
Migration Notes
- All previous APIs have been removed - This is not a backwards-compatible update
- Generator changed from
build_runnertolean_builder- Rundart run lean_builderinstead ofdart run build_runner - Form submission handling removed - Users now handle form submission logic themselves
- Simpler annotation - Use
@stateWidgetinstead of@FormWidget
Why This Change?
The previous version tried to be "too magic" with automatic form handling, mutations, and complex provider generation. This led to:
- High maintenance burden (30+ generator files)
- Difficult to debug generated code
- Tight coupling to specific patterns
The new version is:
- Simpler - Only 5 generator files
- More flexible - Users control form submission
- Easier to maintain - Uses lean_builder for cleaner code generation
- Future-proof - Generates scope widgets even for non-family providers
New Features
@stateWidgetannotation - Simple annotation for generating state field widgets- Auto text controller sync - StringField helper handles TextEditingController synchronization
- Scope widgets - InheritedWidget-based scoping for family parameters
- Field widgets - Generated field widgets with update methods
- Select widgets - Optimized widgets that only rebuild on selected value changes
What's Generated
For a provider annotated with
@stateWidget:- Field updater extension methods
- Scope widget (for family parameter passing)
- State widget (rebuilds on any state change)
- Select widget (rebuilds on selected value only)
- Individual field widgets with auto text controller sync (for String fields)
Dependencies
- Uses
lean_builderinstead ofbuild_runner - Requires
flutter_riverpod: >=3.0.0 <4.0.0 - Dart SDK:
^3.6.0
Release notes
Open source →⚠️ COMPLETE REWRITE - BREAKING CHANGES
This release completely replaces the previous form-focused generator architecture. It is not backwards compatible with the 0.0.x series.
- All
@FormWidget/ form update generators have been removed - The generator now targets the
@stateWidgetannotation only - Generator implementation migrated from
build_runnertolean_builder - Significantly reduced generator surface area and complexity
New Features
StateWidgetGeneratorfor generating:- Field updater extension methods on the provider notifier
- Scope widget (InheritedWidget) for family parameters
- State widget (
*Widget) that rebuilds on any state change - Select widget (
*Select) that rebuilds on selected value changes - Field widgets with auto
TextEditingControllersync forStringfields
- Improved import handling for:
- Source libraries
- Field types
- Family parameter types
- Always generates a scope widget, even for non-family providers, to keep future changes (e.g. adding parameters) migration-friendly
Migration Notes
- Replace previous form-based annotations and generators with
@stateWidget - Switch code generation from
build_runnertolean_builder:dart run lean_builder - Update dependencies in your consuming package:
dev_dependencies: autoverpod_generator: ^0.1.0 lean_builder: ^0.1.2
Requirements
- Dart SDK:
^3.6.0 - autoverpod:
^0.1.0 - autoverpod_annotation:
^0.1.0
-
0.0.605 Dec 2025Release notes
Open source →BREAKING CHANGES
- Removed StateWidget generators - The StateWidget generators have been completely removed. Use the new FormWidget generators instead.
- Generator architecture refactoring - Significant internal refactoring of the generator system for better performance and maintainability.
Features
- New FormWidget generators - Complete rewrite of form widget generation with enhanced capabilities:
FormWidgetGeneratorfor main form widget generationFormProviderGeneratorfor automatic provider generation- Enhanced form validation and error handling
- Automatic mutation provider generation for submit operations
- Improved example applications - New comprehensive examples showcasing:
- Counter example with mutation support
- Simple user form with validation
- Simple product form with validation
- Automated test verification suite
Improvements
- Better generated file handling - Improved filtering of generated files (.g.dart, .freezed.dart, .widget.dart) to prevent circular dependencies
- Enhanced import resolution - Better handling of imports with improved dependency management
- Updated dependencies - All dependencies updated to latest versions:
- Riverpod 3.0.3 with experimental mutation support
- Analyzer ^7.4.0
- Build tools updated
- Performance optimizations - Improved generator performance with better caching and reduced redundant processing
- Enhanced error handling - Better error messages and debugging information during code generation
- Code cleanup - Removed deprecated workflow files and unused generators
Upgrade Steps
-
Update dependencies in
pubspec.yaml:dependencies: autoverpod: ^0.0.6 autoverpod_generator: ^0.0.6 riverpod: ^3.0.3 dev_dependencies: build_runner: ^4.0.2 -
Replace
@StateWidget()with@FormWidget()in your code -
Regenerate code (required due to generator architecture changes):
dart run build_runner build --delete-conflicting-outputs -
Update your provider usage to use the new generated providers
Requirements
- Dart SDK: ^3.9.2
- Flutter: SDK requirement automatically handled by workspace
- autoverpod: ^0.0.6
- build_runner: ^4.0.2
-
0.0.503 Jul 2025Release notes
Open source →- Version bump for release
- Updated autoverpod dependency to 0.0.5
- Improved stability and bug fixes
-
0.0.413 Mar 2025 -
0.0.303 Mar 2025Release notes
Open source →- Fix missing imports for custom field types in generated form widgets
- Add support for proper import path resolution in generated code
- Improve import handling in UnifiedWidgetBuilder
-
0.0.201 Mar 2025 -
0.0.128 Feb 2025Release notes
Open source →- Initial release of autoverpod_generator
- Support for generating Riverpod-integrated widgets from annotations
- Includes generators for state widgets, form widgets, and form update widgets
- Compatible with autoverpod ^0.0.3