riverflow_cli 0.1.6

A modern Flutter scaffolding CLI tool for Riverpod, Clean Architecture, Freezed, Go Router, and MVVM pattern.

Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

0.1.6 - 2026-05-10

Added

• riv test command — auto-installs mocktail on first run, then executes flutter test.
• riv generate locales now auto-adds flutter_localizations and generate: true to pubspec when needed.
• Riv.snackbar() utility — reusable snackbar with title, subtitle, and color parameters.

Changed

• App theme simplified to light/dark mode with transparent status bar and SystemUiOverlayStyle.
• Replaced dartz Either<Failure, T> with Dart 3 records (T?, Failure?) — no external dependency needed.
• Updated all @riverpod function providers to use Ref instead of generated ref types (riverpod_annotation 4.x compatibility).
• LocalStorage now uses only FlutterSecureStorage — removed SharedPreferences dependency.
• Assets directory simplified to a single assets/ folder.

Removed

• shared_preferences — unnecessary with flutter_secure_storage handling all storage.
• dartz — replaced with Dart 3 records for error handling.
• mocktail from default pubspec — now installed on-demand via riv test.
• flutter_localizations from default pubspec — now installed on-demand via riv generate locales.
• riverpod_lint and custom_lint — eliminated analyzer version conflicts.
• json_annotation and go_router_builder — unused in generated code.

Fixed

• Resolved analyzer version conflict between custom_lint ^0.8.1 and json_serializable ^6.12.0.
• Fixed unused imports and variables in generated project templates.
• Generated project now passes flutter analyze with zero issues.

0.1.5 - 2026-05-10

Added

• lib/app/routes.dart — centralised Routes class with named constants for type-safe navigation (context.go(Routes.home) instead of hard-coded strings).
• riv create page and riv delete page now auto-register/unregister route names in Routes.
• riv init now auto-installs all required dependencies and dev dependencies into pubspec.yaml.

Changed

• All generated views no longer include a FloatingActionButton.
• API endpoints template now ships fully commented out as reference examples.
• Updated all packages in the pubspec template to latest stable versions.

Removed

• json_annotation from dependencies (available transitively via freezed_annotation).
• go_router_builder from dev dependencies (unused — routes use manual GoRoute entries).

0.1.4 - 2026-05-10

Fixed

• Windows ProcessException: The system cannot find the file specified — added runInShell: true to all process calls so flutter.bat and dart.bat are resolved correctly via the system shell.

0.1.3 - 2026-05-08

Fixed

• appRouterProvider not found — router now uses manual Provider<GoRouter> instead of @riverpod code gen.
• home_viewmodel.freezed.dart / .g.dart not generated — home module now uses plain Notifier and sealed class instead of Freezed/riverpod_generator.
• Home view uses Dart 3 switch expression instead of .when() pattern.
• Route registration uses GoRoute() entries instead of @TypedGoRoute annotations.
• Generated project now compiles and runs immediately without build_runner.

Removed

• .gitkeep files from generated projects.

0.1.2 - 2026-05-08

Added

• Auto-run flutter pub get and build_runner build after project creation.
• Full dartdoc comments on all public API symbols (100% coverage).

Removed

• riverflow.yaml config file — no longer needed.
• flutter_gen_runner from generated projects (fixes dart_style version conflict breaking build_runner).

Changed

• build_runner now always runs after code generation (no config check).
• Post-creation message simplified to cd <name> + flutter run.

Fixed

• Added example/example.dart for pub.dev scoring.

0.1.1 - 2026-05-08

Added

• riv watch — Run build_runner in watch mode for continuous code generation.
• riv delete page:<name> — Delete a feature module and unregister its route.
• Interactive project creation — prompts for project name and company domain.
• Swift (iOS) and Kotlin (Android) as default languages.
• Production API client with token refresh, 429 retry, HTML error detection.
• API endpoints file with default auth/user endpoints.
• Local storage helper (flutter_secure_storage + shared_preferences).
• App constants loaded from .env via flutter_dotenv.
• Dependency injection layer (core/di/app_providers.dart).
• Shared folder for reusable widgets and models.
• Print log utility for debug-only logging.
• Riverpod provider wiring (ApiClient → Datasource → Repository → UseCase).
• Auto build_runner after code generation (when configured in riverflow.yaml).
• Full dartdoc comments on public API.
• User guide (GUIDE.md) with step-by-step examples.
• MIT License.

Changed

• Project structure now uses features/ instead of app/modules/.
• Theme moved to core/theme/ instead of app/theme/.
• Router moved to lib/app/app_router.dart.
• Errors folder renamed to core/errors/ (plural).
• Feature providers moved inside presentation/providers/.
• Screens generated in shared/widgets/ instead of core/widgets/.
• Replaced mason_logger with logger package.
• Replaced cli_completion with completion package.
• Replaced very_good_analysis with flutter_lints.
• Datasources now use ApiClient instead of raw Dio.
• ViewModels now inject use cases via Riverpod providers.

0.1.0 - 2026-05-08

Added

• riv create project:<name> — Scaffold a complete Flutter project with Clean Architecture, Riverpod, Freezed, Go Router, and Dio.
• riv create page:<name> — Generate a full feature module with domain, data, and presentation layers.
• riv create viewmodel:<name> on <module> — Generate a Riverpod Notifier-based ViewModel with Freezed state.
• riv create view:<name> on <module> — Generate a ConsumerWidget view with state.when() pattern matching.
• riv create provider:<name> on <module> — Generate a Riverpod data provider.
• riv create screen:<name> — Generate a responsive screen layout.
• riv generate model on <module> with <json> — Generate a Freezed model from JSON.
• riv generate locales <path> — Generate i18n translations from ARB files.
• riv init — Convert an existing Flutter project to Riverflow structure.
• riv sort — Sort and organize imports.
• riv install <package> — Install Flutter packages.
• riv remove <package> — Remove Flutter packages.
• riv update — Self-update the CLI.
• --dry-run flag for previewing changes.
• Automatic route registration in app_router.dart.
• riverflow.yaml configuration file support.