relax_cli 1.0.1

CLI to scaffold Flutter projects with clean architecture, state management (Bloc, Provider, Riverpod, GetX), and RelaxORM integration.

1.0.1

• Changed generated project dependencies to the current stable RelaxORM: relax_orm: ^1.0.0 (was ^0.1.4) and relax_orm_generator: ^0.1.7 (was ^0.1.6), across all four architectures. The Collection CRUD used by generated modules is source-compatible with RelaxORM 1.0.0.

1.0.0

First stable release. The command surface and generated project structure are now considered stable.

• Added an automatic navigation layer to generated projects for all four architectures.
  • relax create now scaffolds a router in the app composition root — lib/app/router/app_router.dart (go_router) for Bloc/Provider/Riverpod, or lib/app/router/app_pages.dart (GetX getPages) for GetX — and wires MaterialApp.router / GetMaterialApp(getPages:). The router lives in app/, so features never depend on it (Clean Architecture dependency rule preserved).
  • Each feature owns its route identity: generated pages expose static const routeName / routePath. Navigate with context.goNamed(CartPage.routeName) (go_router) or Get.toNamed(CartPage.routePath) (GetX).
  • relax g feature <name> now auto-registers the feature's route — a GoRoute for go_router architectures, or a GetPage carrying the feature's Binding for GetX — and exports the feature from features/features.dart, with no manual editing. Route name/path derive from the full path spec, so auth/login and admin/login don't collide.
  • Opt out with relax g feature <name> --no-route.
  • Insertion is idempotent and anchor-based (// relax:router-*); re-running never duplicates a route, and a missing router/anchor degrades to a warning instead of failing.
• Added relax generate router — retroactively scaffolds the navigation layer into an existing project (created before navigation support, or where the router was removed).
  • Auto-detects the architecture, creates the router file, gives HomePage its routeName/routePath, rewires app/view/app.dart to MaterialApp.router / GetMaterialApp(getPages:), adds the go_router dependency (non-GetX), and creates the features/features.dart barrel from existing features.
  • Idempotent and safe: re-running reports "already present", and any hand-customized app.dart it can't recognize degrades to actionable warnings instead of corrupting the file.
• Added an aggregate lib/features/features.dart barrel that re-exports every feature. It is the single import the router uses to reach feature pages. relax generate feature registers each new feature there automatically (replacing per-feature router imports).
• Changed relax generate page — the page name may now be given as a single path spec (relax g page product/product_details, leaf = page) in addition to the two-argument form. The new page is auto-exported from its feature barrel, and registered as a child route of its feature: a nested GoRoute under the feature route for go_router, or a flat GetPage (with the feature Binding) at /<feature>/<page> for GetX. Pass --no-route to skip.

0.1.7

• Added path-spec support to every relax generate subcommand — the name argument may now include a /-separated parent path, and the missing folders are created before the component is generated.
  • relax g feature auth/login creates lib/features/auth/ (if needed) then generates the login feature inside it.
  • Works at arbitrary depth, e.g. relax g feature account/admin/login.
  • Applies to feature, model, module, and page (whose target feature folder may now be nested).
  • Class and file names are derived from the last segment only (auth/login → LoginBloc, login.dart); the prefix is used purely as a path.
  • Each path segment is validated as a Dart name; a plain name with no / behaves exactly as before (fully backwards compatible).
• Added relax generate page <folder_name> <page_name> — generates a Page + View pair inside an existing feature folder.
  • Auto-detects the project architecture (Bloc, Provider, Riverpod, GetX) or accepts -a to override.
  • Generates <page_name>_page.dart and <page_name>_view.dart in lib/features/<folder_name>/view/.
  • Each architecture produces the correct imports and widget types (BlocProvider/BlocBuilder, ChangeNotifierProvider, ConsumerStatefulWidget/ConsumerWidget, GetView).
  • Validates that the target feature folder exists and that the page does not already exist.
  • Prints a hint to add the new page export to the feature's barrel file.

0.1.6

• Added relax pub get — runs flutter pub get in the current project.
• Added relax pub add <package> — runs flutter pub add; accepts -V <constraint> to pin a version.
• Added relax build apk — formats code then builds an optimized release APK with obfuscation, split-debug-info, tree-shaking, and split-per-ABI.
• Added relax build aab — formats code then builds an optimized release AAB (Android App Bundle) for Google Play.
• Added relax clean — runs flutter clean in the current project.
• Added FVM auto-detection — all Flutter commands use fvm flutter automatically when .fvm/fvm_config.json is present.
• Added --flavor (-f) and --target (-t) options for build apk and build aab; defaults to production flavor and lib/main_<flavor>.dart entry point.

0.1.5

• Added shared encrypted local storage scaffolding via relax_storage, including a generated CachedStorage service in the app core.
• Added ENCRYPTION_KEY to generated flavor environment files and wired it into RelaxStorage initialization.
• Updated generated project dependencies to relax_orm ^0.1.4, relax_orm_generator ^0.1.6, and relax_storage ^1.0.1.
• Fixed generated DI and bootstrap templates so Bloc, Provider, Riverpod, and GetX projects initialize storage consistently and import the cache helper from the correct package path.

0.1.4

• Added shared encrypted local storage scaffolding via relax_storage, including a generated CachedStorage service in the app core.
• Added ENCRYPTION_KEY to generated flavor environment files and wired it into RelaxStorage initialization.
• Updated generated project dependencies to relax_orm ^0.1.3, relax_orm_generator ^0.1.5, and relax_storage ^1.0.1.
• Fixed generated DI and bootstrap templates so Bloc, Provider, Riverpod, and GetX projects initialize storage consistently and import the cache helper from the correct package path.

0.1.3

• Fixed generated Flutter app templates to include flutter_localizations and correct relative core imports for Bloc, GetX, Provider, and Riverpod starter projects.
• Fixed generated widget test scaffolding by wrapping const App() inside TranslationProvider correctly.
• Improved relax create output by adding flutter pub get to the next steps instructions.
• Removed an incomplete stray generator file from the repository.

0.1.2

• Fixed generated build.gradle.kts failing to compile with Kotlin DSL errors.
  • Replaced Groovy syntax (def, new Properties(), single-quoted strings, withReader, toInteger()) with valid Kotlin DSL (val, Properties(), double-quoted strings, .reader().use {}, .toInt()).
  • Fixed deprecated kotlinOptions → kotlin { compilerOptions {} } block.
  • Fixed Unresolved reference: it in signing config by using explicit named lambda parameter.
  • Added required import java.util.Properties and import java.io.FileInputStream.

0.1.1

• Added built-in internationalization (i18n) support via slang.
  • Projects are scaffolded with fr (base) and en locale JSON files.
  • build.yaml is generated with slang configuration.
  • Translations are auto-generated after relax create via dart run slang + build_runner.
• Automatic flutter pub get and code generation run at the end of relax create.
• Patched iOS Info.plist with supported locales during project creation.
• Improved generated README.md with flavor run commands and translation regeneration instructions.
• Removed sample product and user modules from the example project.
• Removed redundant flutter pub get from post-create instructions (now runs automatically).

0.1.0

• Initial release.
• relax create — scaffold Flutter projects with Bloc, Provider, Riverpod, or GetX.
• relax generate feature — add feature modules with auto-detected architecture.
• relax generate module — add domain/data modules with RelaxORM integration.
• relax generate model — add standalone ORM model classes with @RelaxTable.
• relax doctor — check Dart, Flutter, and project environment.
• Automatic build_runner execution after module and model generation.
• Material 3 theming with customizable color palette and font.
• Android flavor configuration (development, staging, production).
• Environment package generation via env_builder.