nylo_framework 7.0.0

nylo_framework: ^7.0.0 copied to clipboard

Added #

• New modular command system - All Metro CLI commands are now individual classes under lib/metro/commands/make/, each extending NyCustomCommand with a builder pattern. Commands are registered in built_in_commands.dart as a simple map lookup
• make:bottom_sheet_modal command - Generate bottom sheet modal widgets with auto-registration in bottom_sheet_modals.dart
• make:button command - Generate button widgets with auto-registration in the Button class
• make:env command - Generate an encrypted env.g.dart file from your .env file using XOR encryption with APP_KEY. Supports --dart-define mode for build-time key injection
• make:key command - Generate a secure 32-character APP_KEY for environment variable encryption
• New env_stub.dart - Stub for generating encrypted environment configuration class with automatic type parsing and caching
• New bottom_sheet_modal_stub.dart - Stub for generating bottom sheet modal widgets and their static registration methods
• New button_stub.dart - Stub for generating button widgets and their static registration methods
• New lib/metro/helpers/metro_helpers.dart - Extracted NyJson helper class and createNyloModel helper function
• New lib/app/ directory - Added app directory structure with example model
• Extensive new helper methods in NyCustomCommand:
  • Output helpers: line(), newLine(), comment(), alert()
  • File system helpers: fileExists(), directoryExists(), readFile(), readFileSync(), writeFile(), writeFileSync(), appendFile(), ensureDirectory(), deleteFile(), copyFile()
  • Environment helpers: env(), isWindows, isMacOS, isLinux, workingDirectory
  • Input helpers: ask() (alias for prompt), promptSecret() for hidden input
  • Control flow: abort() to exit with error
  • Table display: table() with ConsoleTable class for formatted ASCII tables
  • Progress bar: progressBar() with ConsoleProgressBar class
  • String case conversion: snakeCase(), camelCase(), pascalCase(), titleCase(), kebabCase(), constantCase()
  • Flutter project path helpers: modelsPath, controllersPath, widgetsPath, pagesPath, commandsPath, configPath, providersPath, eventsPath, networkingPath, themesPath, projectPath()
  • File scaffolding: scaffold(), scaffoldMany() with ScaffoldFile class
  • JSON/YAML helpers: readJson(), readJsonArray(), writeJson(), appendToJsonArray(), readYaml()
  • Dart/Flutter command helpers: dartFormat(), dartAnalyze(), flutterPubGet(), flutterClean(), flutterBuild(), flutterTest()
  • Dart file manipulation: addImport(), insertBeforeClosingBrace(), fileContains(), fileContainsPattern()
  • Directory helpers: listDirectory(), findFiles(), deleteDirectory(), copyDirectory()
  • Validation: isValidDartIdentifier(), requireArgument(), cleanClassName(), cleanFileName()
  • Task runner: runTasks(), runTasksWithSpinner() with CommandTask class
• New ConsoleTable class - Renders formatted ASCII tables with box-drawing characters and bold headers
• New ConsoleProgressBar class - Displays progress bars with percentage tracking, tick/update/complete controls
• New SpinnerExtension methods - withProgress() and withProgressSync() for processing lists with progress bars
• New ScaffoldFile class - Data class for batch file scaffolding operations
• New CommandTask class - Data class for task runner operations with optional stop-on-error
• CommandResult.hasHelpFlag and hasForceFlag convenience getters
• New flutter_local_notifications export in nylo_framework.dart
• New dependency: patrol (^4.1.0) for testing
• New dependency: yaml (^3.1.3) for YAML file parsing
• New dependency: rename (^3.1.0) as dev dependency
• New executables section in pubspec.yaml - metro: main for direct CLI invocation
• Comprehensive test suite - New test directories: test/commands/, test/console/, test/json_dart_generator/, test/metro/, test/stubs/ with tests for command builder, console components, spinner, JSON processing, scaffold files, menu display, stubs, and API exceptions
• NyTheme class overhaul - New static methods: currentId(), current(), themeData(), isDark(), colors<T>(), setFollowSystem(), isFollowingSystem(), getById(), all(), lightThemes(), darkThemes(), getByType(), setPreferredDark(), setPreferredLight(), preferredDarkId(), preferredLightId(), clearSavedTheme()
• NyTheme.set() now supports remember parameter - Sets preferred theme for system theme following

Changed #

• Metro CLI entry point (bin/main.dart) rewritten - Now uses direct command map lookup via builtInCommands instead of routing through the old metro.dart monolithic handler. Shows menu on no arguments, supports custom command discovery
• Framework exports simplified (lib/nylo_framework.dart) - Replaced 18+ individual nylo_support exports with single export 'package:nylo_support/ny_core.dart' re-export
• NyCustomCommand.run() is now async (Future<void> run()) and properly awaits handle()
• NyCustomCommand exports updated - Now exports from package:nylo_support/metro/ny_metro.dart and /metro/helpers/metro_helpers.dart instead of multiple individual support package paths
• CommandBuilder constructor - No longer auto-adds --help flag by default
• CommandResult return types made nullable - getString(), getBool(), getInt() now return nullable types with nullable defaults instead of non-nullable with required defaults
• Provider stub updated - boot() renamed to setup(), afterBoot() replaced with boot() (called after all providers are setup)
• Route guard stub updated - onRequest(PageRequest) replaced with onBefore(RouteContext) returning Future<GuardResult>, with new context helpers (context.data, context.queryParameters, context.routeName, context.context)
• Form stub updated - NyFormData renamed to NyFormWidget, constructor uses super.key, super.submitButton, super.onSubmit, super.onFailure. Fields use FormCollection.fromArray() for picker options, validator instead of validate, removed style: "compact". Added static NyFormActions getter
• API service stub updated - Import path changed from /config/decoders.dart to /bootstrap/decoders.dart, added interceptors getter override
• Config stub updated - Now generates a final class with static members instead of loose comments, docs link updated to 7.x
• Custom command stub updated - Simplified usage docs (removed duplicate terminal/metro instructions)
• Navigation hub stub rewritten - Now accepts layoutBuilder, imports, and navigationEntries parameters. Layout uses layout(BuildContext context) method instead of property assignment. Added initialIndex override. Navigation pages use a synchronous map constructor super(() => {...}) instead of async
• Navigation hub creation (make:navigation_hub) - Now interactive: prompts for layout type (navigation_tabs or journey_states) and child names. Generates hub and child widgets under organized folder structure (navigation_hubs/<hub>/tabs/ or navigation_hubs/<hub>/states/)
• Journey state stub improved - New isLastStep parameter. Last step gets onJourneyComplete callback. Navigation buttons (Back/Continue) now built inline. Removed onCannotContinue() and onAfterNext() overrides. Updated to use nextStep instead of onNextPressed
• Model stub formatting - Removed extra blank lines for cleaner output
• State managed widget stub updated - Added static action() method for easier state action invocation. Updated example comments to use new Follow.action() pattern. Simplified init to synchronous
• Stateful widget stub updated - widgetStatefulStub() now accepts optional content parameter
• NyTheme.set() is now async and delegates to NyThemeManager.instance.setTheme() instead of ThemeProvider
• JSON dart generator fixes - findCustomObject() now returns nullable ValueDef? with proper null checks, isStructSame handles empty list comparison, _summarizeData list merging fixed with proper nonNulls.toList() chain, fromJson uses correct key reference
• README.md - All documentation links updated from 6.x to 7.x
• LICENSE - Copyright year updated to 2026
• pubspec.yaml updates:
  • Repository URL updated to 7.x branch
  • nylo_support dependency changed to path reference (path: ../support)
  • skeletonizer updated to ^2.1.2
  • error_stack updated to ^2.0.0
  • Added flutter_local_notifications: ^20.0.0
  • Added yaml: ^3.1.3
  • Added patrol: ^4.1.0
  • Added rename: ^3.1.0 (dev dependency)
  • Added executables section with metro: main
  • Added uses-material-design: true

Removed #

• lib/metro/metro.dart - Monolithic 1,400+ line command handler replaced by modular command classes
• lib/cli_dialog/ directory - Entire CLI dialog library removed (7 files: cli_dialog.dart, dialog.dart, keys.dart, list_chooser.dart, services.dart, stdin_service.dart, stdout_service.dart, xterm.dart)
• lib/metro/stubs/theme_stub.dart - Theme generation stub removed
• lib/metro/stubs/theme_colors_stub.dart - Theme colors generation stub removed
• lib/metro/stubs/network_method_stub.dart - Network method stub removed
• lib/metro/stubs/postman_api_service_stub.dart - Postman API service stub removed
• make:theme command - Removed from Metro CLI menu
• NyCustomCommand.makeFile() method - Removed in favor of scaffold() and writeFile() helpers
• theme_provider dependency - Replaced by NyThemeManager from nylo_support
• flutter_secure_storage dependency - Removed from direct exports
• flutter_dotenv dependency - Removed (replaced by encrypted env system)
• Individual nylo_support exports - 18+ individual exports replaced by single ny_core.dart barrel export
• nyloVersion updated from v6.9.2 to v7.0.0

• Fix controller stub
• Update state managed stub
• pubspec.yaml updates

• pubspec.yaml updates

• pubspec.yaml updates

• pubspec.yaml updates

• pubspec.yaml updates

• pubspec.yaml updates

• pubspec.yaml updates

• pubspec.yaml updates

• pubspec.yaml updates

• pubspec.yaml updates

• Fix: postman imports
• pubspec.yaml updates

• pubspec.yaml updates

• pubspec.yaml updates

• pubspec.yaml updates

• Fix runProcess in ny_cli.dart

• New stub for creating JourneyStates in your project
• Update navigation_hub stub
• Ability to create multiple stateful_widgets at once using Metro. E.g. metro make:stateful_widget home,settings
• Ability to create multiple stateless_widgets at once using Metro. E.g. metro make:stateless_widget home,settings
• pubspec.yaml updates

• Fix methods: addPackage and addPackages

• Small refactor to metro.dart

• Fix commands not being run using runProcess

• Update pubspec.yaml

• Update command stub

• Update builder in NyCustomCommand class

• Added: make:command to metro cli so you can create custom commands in Nylo 🚀
• Added: New stub for creating commands
• Update metro cli to support custom commands
• New ny_cli.dart file to handle custom commands
• Update pubspec.yaml

• Update pubspec.yaml

• Update pubspec.yaml

• Update pubspec.yaml

• Update pubspec.yaml

• Update pubspec.yaml

• Update Form stub to include submitButton
• Update pubspec.yaml

• Update GitHub workflows
• Merge PR from rytisder to fix page_w_controller_stub.dart
• Update pubspec.yaml

• Update pubspec.yaml

• Update pubspec.yaml

• Update pubspec.yaml

• Update pubspec.yaml

• Update pubspec.yaml

• Update pubspec.yaml

• Update pubspec.yaml

• Fix model stub
• Update pubspec.yaml

• Update pubspec.yaml

• Update route guard stub
• Update pubspec.yaml

• Update copyright year
• Update pubspec.yaml

• Update pubspec.yaml

• Update Form stub to include init
• Update pubspec.yaml

• Update pubspec.yaml

• Update pubspec.yaml

• Update pubspec.yaml

• Update pubspec.yaml

• Added:
• export 'package:nylo_support/widgets/styles/bottom_modal_sheet_style.dart';
• export 'package:nylo_support/helpers/ny_color.dart';
• export 'package:nylo_support/helpers/ny_text_style.dart';

• Update pubspec.yaml

• Update pubspec.lock

• Update pubspec.yaml

• Update pubspec.yaml

• Update pubspec.yaml

• Update NavigationHub stub

• Update pubspec.yaml

• Update widget stubs to use view

• Update pubspec.yaml

• Update pubspec.yaml

• Update stub constructors to include {super.key}
• Update pubspec.yaml

• Update pubspec.yaml

• Update pubspec.yaml

• Remove page_bottom_nav_stub
• Update pubspec.yaml

• Update pubspec.yaml

• Update page_w_controller_stub
• Contribution from jitendravn PR #40

• Update pubspec.yaml

• New version of Nylo - read more about the changes here

• Small refactor to cli_dialog to pass static analysis
• Update pubspec.yaml

• Update import paths in Metro

• Update pubspec.yaml

• Update pubspec.yaml

• Refactor Form stub
• Update pubspec.yaml

• Update pubspec.yaml

• Update the Form stub
• Add new dependency date_field
• update README
• Update pubspec.yaml

• Update pubspec.yaml

• Update pubspec.yaml

• Ability to create Forms using Metro. E.g. metro make:form register
• New stub for creating Forms
• Small refactor to model stub
• Refactor slate command to metro slate:publish
• New metro slate:install command to install the slate package and publish all the files

• Update stubs
• Update pubspec.yaml

• Update pubspec.yaml

• Update pubspec.yaml

• Update pubspec.yaml

• Update pubspec.yaml

• Fix apiServiceStub to use destroy instead of delete

• Update pubspec.yaml

• Fix Metro to not add duplicate suffixes to some files
• Update pubspec.yaml

• Update pubspec.yaml

• Dart format

• Remove the ability to use a "postman.json" file in the _makeApiService command
• Update pubspec.yaml

• Update pubspec.yaml

• Update pubspec.yaml

• Update pubspec.yaml
• Add dart_console

• Downgrade flutter_secure_storage to ^9.0.0

• Update pubspec.yaml

• Update pubspec.yaml

• Add error_stack to framework

• Fix interceptor stub

• Update pubspec.yaml

• Ability create multiple pages at once using Metro. E.g. metro make:page home,dashboard,settings // this will create 3 pages home_page, dashboard_page and settings_page
• Update pubspec.yaml

• Update pubspec.yaml

• Update pubspec.yaml

• Update pubspec.yaml

• Update metro make:model --json command to check if cli is running on Windows or MacOS

• Update pubspec.yaml

• Update pubspec.yaml

• Update pubspec.yaml

• Update pubspec.yaml

• Update pubspec.yaml

• Update pubspec.yaml

• Update pubspec.yaml

• Update pubspec.yaml

• Update stubs

• Update stubs
• Update pubspec.yaml

• Update pubspec.yaml

• Update pubspec.yaml

• Update config stub
• Update pubspec.yaml

• Update pubspec.yaml

• Update pubspec.yaml

• Update pubspec.yaml

• Add skeletonizer package
• Update pubspec.yaml

• Update pubspec.yaml

• Update pubspec.yaml

• Update pubspec.yaml

• Update pubspec.yaml

• Update pubspec.yaml

• Update pubspec.yaml

• Tweak stubs
• Update pubspec.yaml

• Update pubspec.yaml

• Update pubspec.yaml

• Update pubspec.yaml

• Update pubspec.yaml

• export ny_language_switcher to nylo_framework.dart
• Update pubspec.yaml

• Update pubspec.yaml

• Update pubspec.yaml

• Update page stub docs

• Update pubspec.yaml

• Update pubspec.yaml

• Remove await Future.delayed(Duration(seconds: 2)); from stub
• Update config stub
• Update pubspec.yaml

• Fix postman not automatically adding the ApiService into the decoders.dart file
• Update pubspec.yaml

• Add override to model stub

• Update pubspec.yaml

• Update pubspec.yaml

• Update pubspec.yaml

• Update pubspec.yaml

• Update README.md

• New --bottom-nav flag to create bottom nav pages. E.g. metro make:page dashboard_nav --bottom-nav
• Add new stub for creating pages that use bottom navigation tabs
• Update pubspec.yaml

• Update page and controller stub to use view instead of build
• Update the page and controller stub to include controller getter
• Update pubspec.yaml

• Update pubspec.yaml

• Update pubspec.yaml

• Improve metro make:api_service when using Postman flag

• Improve metro make:api_service when using Postman flag

• Fix metro make:api_service error when using Postman flag

• Update pubspec.yaml

• Update pubspec.yaml

• Update stateful stub
• Update pubspec.yaml

• Update pubspec.yaml

• Update pubspec.yaml

• Metro cli improvements
  • Ability to create pages in a subfolder. E.g. metro make:page auth/login
  • Ability to create models in a subfolder. E.g. metro make:model auth/user
  • Ability to create controllers in a subfolder. E.g. metro make:controller auth/login
  • Update --postman flag for API Services. Now you can run metro make:api_service example_api_service --postman and it will help you create an API Service from a Postman collection.
• Update stubs
• Add cli_dialog as a dependency
• Update pubspec.yaml

• Update pubspec.yaml

• Export new ny_route_history_observer.dart file
• Update pubspec.yaml

• Update pubspec.yaml

• Add new --json flag to the "make:model" command to create a model from a json string. E.g. metro make:model user --json '{"name": "John Doe", "age": 30}'

• Update pubspec.yaml

• Update pubspec.yaml

• Update pubspec.yaml

• Ability to set routes as the initialPage using --initial E.g. metro make:page dashboard --initial
• Ability to set routes as the authPage using --auth E.g. metro make:page dashboard --auth
• Update pubspec.yaml

• New ability to create dio Interceptors using Metro. E.g. metro make:interceptor auth_token
• Update stubs for creating pages and api services
• Small refactor to Metro class
• Remove ny_base_networking.dart
• Update pubspec.yaml

• Fix make:api_service when using Postman flag
• New publish:slate command added to Metro
• Added more docs to Metro methods

• Update page stub to include an example on how to set the state.

• Ability to auto add themes to the Nylo config using e.g. metro make:theme bright_theme
• Update default theme stub to use useMaterial3
• Update pubspec.yaml

• Add docblock to more APIs
• Update pubspec.yaml

• Update page stub to use NyPage
• Fix metro make:api_service Postman error when URL is null
• Update pubspec.yaml

• Update pubspec.yaml

• Ability to create config files via Metro
• Update pubspec.yaml

• Update pubspec.yaml

• Update pubspec.yaml

• Update pubspec.yaml

• Update pubspec.yaml

• Update pubspec.yaml

• Add docblock to setPagination method and fix the queryParameters not being reset when using the api helper

• Update pubspec.yaml

• Update stateful_stub to remove stateInit
• Add setPagination to NyBaseNetworking
• Update pubspec.yaml

• Update pubspec.yaml

• Add useUndefinedResponse to network helper. This will allow you to catch the response when your decoder.dart file fails to return the correct type. To listen to undefinedResponse's, call onUndefinedResponse(dynamic data, Response response, BuildContext? context) in your ApiService.
• Update stateful_stub to include stateInit and stateUpdated
• Small refactor to page_stub
• Fix Metro error - The class 'FileSystemEvent' can't be extended, implemented
• Add json_dart_generator into the library

• Pubspec.yaml dependency updates.

• Pubspec.yaml dependency updates.

• Breaking change to validation.
• If you are using Nylo 5.x, do the following:
  • Go to config/validation_rules.dart.
  • Update 'final Map<Type, dynamic> validationRules = {'
  • to this 'final Map<String, dynamic> validationRules = {'
  • Custom validation rules must now the follow the following format:
    • "simple_password": (attribute) => SimplePassword(attribute), // example
• Pubspec.yaml dependency updates.

• Update Nylo framework version.

• Update GitHub actions.
• Refactor metro class.
• Pubspec.yaml dependency updates.

• Change nylo_framework version.

• Change DioError to DioException as per dio upgrade notes.
• Refactor metro to use runCommand from MetroService.
• Pubspec.yaml dependency updates.

• Pubspec.yaml dependency updates.

• Pubspec.yaml dependency updates.

• NyBaseApiService has a new method getContext to get the BuildContext.
• Remove 'Storable' from the Model stub.
• Page stubs now include a path variable to make routing easier.
• New command to create Route Guards.
• Pubspec.yaml dependency updates.
• Readme update.

• Flutter v3.10.0 fixes:
  • Update: theme_provider package

• Fix metro make:model if modelDecoders doesn't exist.

• Pubspec.yaml dependency updates.

• [4.1.3] - 2023-02-22 #

• Pubspec.yaml dependency updates.

• Add logo to package
• Pubspec.yaml dependency updates.

• Update stubs.
• Now you can pass a baseUrl to the network or nyApi method.
• Small refactor to the Metro class.
• Fix importPaths when using addToRouter.
• Pubspec.yaml dependency updates.

• Metro will automatically add Routes to the router.dart file
• Metro will automatically add Events to the config/events.dart file
• Metro will automatically add ApiServices and Models to the config/decoders.dart file
• Metro will automatically add Providers to the config/providers.dart file
• Create Api Services from Postman collections using Metro, read more here
• NyBaseApiService class has new parameters to add a bearerToken or headers on each request
• Update stubs
• Copyright year updated
• Pubspec.yaml dependency updates

• Add page_transition to dependencies
• Pubspec.yaml dependency updates

• Update theme stubs
• Pubspec.yaml dependency updates

• Update page stub to include default base Controller on creation
• Refactor stubs using 'package:flutter_app' to use project path
• Pubspec.yaml dependency updates

• Pubspec.yaml dependency updates

• Add @override to event stubs
• Pubspec.yaml dependency updates

• Add version to nylo_framework

• Remove import from ny_base_networking.dart
• Flutter format

• Add new NyBaseApiService class to the networking folder
• Add dio as a dependency
• Pubspec.yaml dependency updates

• New command to create: Events, Providers and API Services
• Remove command: project:init
• Docs link updated in Model stub
• Update README info
• Remove nylo_support ref from stubs
• Pubspec.yaml dependency updates

• Remove appended 'Widget' from Metro:make command for stateless and stateful widgets
• Docs link updated in Model stub
• Pubspec.yaml dependency updates

• Merge PR #27 - Example moved to null safety
• Remove build appicons command from Metro cli

• Small refactor to Metro Cli
• Pubspec.yaml dependency updates

• Update Controller stub
• Pubspec.yaml dependency updates

• Upgrade to Dart 2.15
• Add toast notifications
• Pubspec.yaml dependency updates

• Update Nylo version
• Ability to create themes and theme colors from Metro Cli
• Pubspec.yaml dependency updates

• Update Nylo version

• Pubspec.yaml dependency updates

• Upgrade Dart (v2.14.0)
• Pubspec.yaml dependency updates

• Remove NyBaseColors class

• Refactor nylo_framework.dart
• Metro cli stability improvements
• New NyTheme class for setting the Flutter theme
• Null safety stubs
• Pubspec.yaml dependency updates

• Null safety stubs

• README changes

• New method to create pages in router 'router.page(NyStatefulWidget widget)'
• Pubspec.yaml dependency updates

• Use pascal format for metro cli
• Fix metro make:page command

• Fix stub using NyStatefulWidget

• Fix stub using NyStatefulWidget

• Remove operand check

• Update adaptive_theme dependency

• Null safety support
• Rename StatefulPageWidget to NyStatefulWidget
• Pubspec.yaml dependency updates

• Changes as per dart analysis log

• Router bug fix
• Small tweaks

• Flutter 2.0.0+ support
• Bug fixes

• Bug fixes

• Ability to create plugins for Nylo
• Refactored NyRouter class
• Add page transitions
• StatefulPageWidget class now has data() method
• Controller and model stub update
• new construct(context) method for controllers
• Version bump

• Fix onPop called on null
• Pass new "result" into pop method

• flutter format

• Metro new commands: create stateless widgets, stateful widgets and storable models
• "common" folder renamed to "resources"
• Router new route method to create routes
• Controller refactored to remove .of(BuildContext context)
• New Storable method save('key') to store to secure storage
• onPop parameter added to routeTo method
• Small improvements and tweaks

• New default state widget NyState
• Updates to Metro stubs
• APIRender Widget parameter refactor
• Helper class small refactor
• Dart code formatting

• ApiRender widget updated with new required parameters and change in functionality.

• Small fix to Metro cli tool
• Update to readme

• Bug fix for controller when fetching request data
• Tweak to routes and transitions
• Improvements to Metro Cli

• Controllers can now return arguments from routes
• Dispatch jobs with the new BusQueue
• Updated router class
• ApiRender widget for rending Widgets from api futures
• Removal of unused methods, code clean up, example added
• New method for storing objects and lists to shared preferences
• New methods to check app connectivity in networking
• Metro improvements and bug fixes
• Bug fixes to project

• Initial release.