NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
pub.dev, #4577 most downloaded on pub.dev
Support library for the Nylo framework. This library supports routing, widgets, localization, cli, storage and more.
Latest stable
7.37.1
Last release 21 days ago
01 Nov 2026
Ships fairly regularly
a new release about every 2 weeks
Nearly every release is documented
notes for 60 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
5 years old
286 releases · first in 2021
Drag across the ruler to compare, or tap a release to open it.
App lifecycle not assigned in `Nylo.init()` - The appLifecycle parameter was accepted but never assigned to _appLifecycle, causing nylo.appLifecycleSt
Nylo.init() - The appLifecycle parameter was accepted but never assigned to _appLifecycle, causing nylo.appLifecycleStates to always return null. Now correctly assigns the value during initialization_formCasts field and related methods (addFormCasts, getFormCasts) from the Nylo classformCasts parameter from Nylo.configure()flutter_local_notifications constraint to ^20.1.0timezone constraint to ^0.10.0Localization fallback locale support - When a translation key is missing in the current locale, NyLocalization now automatically falls back to the def
NyLocalization now automatically falls back to the default language before returning the raw key. Supports both top-level and nested (dot-notated) keysNyLocalization.setValuesForTesting() - New test helper method for directly setting translation values and fallback values in unit testsinitializeDateFormatting() call in Nylo.init() to ensure all locale-specific date format data is availableNyBaseModal now applies bottom padding matching MediaQuery.viewInsets.bottom when isScrollControlled is true, preventing the on-screen keyboard from covering modal contentYour coding agent can read these notes before it upgrades. Set up the MCP server →
NyLocalization now automatically falls back to the default language before returning the raw key. Supports both top-level and nested (dot-notated) keysNyLocalization.setValuesForTesting() - New test helper method for directly setting translation values and fallback values in unit testsinitializeDateFormatting() call in Nylo.init() to ensure all locale-specific date format data is available, preventing failures when formatting dates in non-default localesNyBaseModal now applies bottom padding matching MediaQuery.viewInsets.bottom when isScrollControlled is true, preventing the on-screen keyboard from covering modal content`FieldDefinition` class and `define()` helper - Set both a value and options for form fields in NyFormWidget.init, enabling deferred option loading fr
FieldDefinition class and define() helper - Set both a value and options for form fields in NyFormWidget.init, enabling deferred option loading from APIsPickerListTileStyle - Style configuration for picker bottom sheet list tiles with radio, checkmark, and custom builder presets via PickerListTileIndicatorFieldStylePicker alignment properties - Added placeholderAlignment, selectedValueAlignment, and selectedValuePadding for fine-grained picker layout controlFieldStyleDateTimePicker clear controls - Added canClear and clearIconData properties to control date/time field clearing behaviorFieldStyleSwitchBox extended properties - Added activeTrackColor, inactiveThumbColor, inactiveTrackColor, thumbColor, trackColor, trackOutlineColor, thumbIcon, dragStartBehavior, and thumb image propertiesInputField suffixIcon support - Added suffixIcon parameter across all InputField constructors and copyWithStyledText.template key:text syntax - New {{key:text}} placeholder syntax for localization-friendly styled text where the display text is separate from the style lookup keyFormCollection.empty() constructor - New const constructor for empty form collections, useful as a default for fields with deferred optionsField.datetime / Field.date direct parameters - Added firstDate, lastDate, dateFormat, and initialPickerDateTime directly on field constructorsField.picker / Field.radio / Field.chips optional options - The options parameter is no longer required; defaults to FormCollection.empty() for deferred loading via define()styled_text_test.dart test suite for StyledText.template with key:text and pipe-key syntaxunselectedLabelStyle and unselectedItemColor to inactive tabspage.value.icon before text widget when no activeIcon is setsetValue to restoreValue in clear/setValue actions to prevent redundant UI update cyclesNyResponse.ifSuccessful / when null safety - Fixed type promotion with local variable for proper null-safetyField.currency initial value - Now uses dummyData as fallback for initial value when value is nullInputField format-on-init - Initial text values now pass through input formatters so programmatic values (e.g. from define()) display formattedInputField setValue with formatters - The setValue state action now applies input formatters to the valueWidgetsFlutterBinding.ensureInitialized() to Nylo.configure() to ensure binding before configurationdynamic parameter types across multiple methods for lint compliancenon_constant_identifier_names and camel_case_types from analysis_options.yaml; moved to targeted ignore_for_file commentserrorResponses now uses whereType<FormValidationError>() instead of where().cast()Namespaced translation keys - All hardcoded English strings in widgets now use namespaced translation keys for better i18n support. Keys added:
nylo.page_not_found.title, nylo.page_not_found.message, nylo.page_not_found.go_backnylo.collection_view.no_results, nylo.collection_view.pull_up, nylo.collection_view.failed, nylo.collection_view.releasenylo.offline_banner.messagenylo.form_picker.select, nylo.form_picker.clearnylo.language_switcher.titlenylo.journey.of, nylo.journey.step, nylo.journey.back, nylo.journey.next, nylo.journey.finishnylo.confirm_action.cancel, nylo.confirm_action.confirmuseRootNavigator and modalBackgroundColor parameters to NyBaseModal.show() and NyModalLayoutalignLabelWithHint and textAlignVertical for multiline fields; passes through prefixIconConstraints from decorationCustomAnimationBuilder from flutter_styled_toast via ny_core.dartparams to data across NyListener, NyEventBus, NyEventCallbackListener, and NyEventExtension for clarityDioApiService.handleResponse now conditionally skips data morphing when handleSuccess or handleFailure callbacks are provided, and properly returns callback resultsDioApiService caching logic fixed to avoid null reference when saving cached responsesNyBaseModal.show() default for useSafeArea changed from true to falseJourneyContent uses Expanded instead of Flexible for main content areany_metro.dart imports with collection package in InputField and LanguageSwitchercollection package dependency (^1.19.1)Complete library restructuring - All modules have been reorganized from flat file layouts into src/ subdirectories with barrel file exports. Import pa
src/ subdirectories with barrel file exports. Import paths have changed across the entire library:
lib/alerts/ files moved to lib/alerts/src/ with barrel ny_alerts.dartlib/controllers/ files moved to lib/controllers/src/ with barrel ny_controllers.dartlib/event_bus/ files moved to lib/event_bus/src/ with barrel ny_event_bus.dartlib/events/ files moved to lib/events/src/ with barrel ny_events.dartlib/helpers/ files moved to lib/helpers/src/ with barrel ny_helpers.dartlib/local_notifications/ files moved to lib/local_notifications/src/ with barrel ny_local_notifications.dartlib/local_storage/ files moved to lib/local_storage/src/ with barrel ny_local_storage.dartlib/localization/ files moved to lib/localization/src/ with barrel ny_localization.dartlib/metro/ files moved to lib/metro/src/ with barrel ny_metro.dartlib/networking/ files moved to lib/networking/src/ with barrel ny_networking.dartlib/providers/ files moved to lib/providers/src/ with barrel ny_providers.dartlib/router/ files moved to lib/router/src/ with barrel ny_router.dartlib/themes/ files moved to lib/themes/src/ with barrel ny_themes.dartlib/widgets/ files moved to lib/widgets/src/ with barrel ny_widgets.dartlib/dart_console/ reorganized with barrel ny_dart_console.dartlib/ny_core.dart exports all modules in one importenv parameter as EnvGetter type and accepts BootConfig for setup. The setup and setupFinished callbacks have been replaced by the BootConfig class patternNyEnvRegistry.register(getter: Env.get) instead of reading .env files directlytheme_provider package with new NyThemeManager singleton, NyThemeProvider widget, and NyThemeStorage for persistence. Theme registration now uses nylo.addThemes() with optional initialThemeId parameterBaseColorStyles - Replaced by ThemeColor abstract class in lib/themes/src/theme_color.dartNyRichText renamed to StyledText (with StyledText.template() constructor)NyTextField renamed to InputFieldNyFutureBuilder renamed to FutureWidgetNyFader renamed to FadeOverlay (with .top(), .bottom(), .left(), .right() constructors)NyPullToRefresh and NyListView consolidated into CollectionView (with CollectionItem wrapper class)NyPullable renamed to PullableNyLanguageSwitcher renamed to LanguageSwitcherNyTextStyle - No longer part of the libraryValidationException - Validation exceptions moved to form-specific handlingNyLoginForm - Replaced by general NyForm capabilitiesevents.dart - Events now use dedicated ny_events.dart barrel with new architecturerouter.dart - Router now uses dedicated ny_router.dart barreldart_console.dart - Dart console now uses dedicated ny_dart_console.dart barrelvalidation/ directory - Validation rules (ny_validator.dart, rules.dart, validations.dart) have been moved into the form system^3.10.7>=3.24.0lib/testing/) - A comprehensive testing framework with PHPUnit/Pest-like syntax:
NyTest - Main test orchestrator with init(), actingAs(), travel(), travelForward(), travelBack(), freezeTime(), dump(), dd() methodsNyWidgetTest - Widget testing utilities with pumpNyWidget() and pumpNyWidgetSimple() for easy widget testingNyTime - Time manipulation for testing (freeze, advance, rewind)NyFactory / NyFaker - Laravel-style model factories for generating test dataNyMockApi - API mocking with type-based handlers and URL pattern matching (supports * and ** wildcards)NyMockChannels - Platform channel mocking for testsNyMockRouteGuard - Route guard mockingNyTestCache - In-memory cache for testsNyStateTestHelpers - State testing helpersnyTest(), nyGroup(), nyWidgetTest(), nySetUp(), nyTearDown(), nySetUpAll(), nyTearDownAll(), nySkip(), nyFailing(), nyCi()expectAuthenticated(), route assertions, backpack assertions, locale assertionslib/helpers/src/ny_connectivity.dart) - Network connectivity helper with isOnline(), isOffline(), isWifi(), isMobile(), isEthernet(), isVpn(), isBluetooth(), stream(), whenOnline(), when(), connectionTypeString()lib/widgets/src/connective.dart) - Reactive widget that rebuilds based on connectivity state. Includes Connective.builder(), OfflineBanner widget, and widget extensions .connectiveOr(), .onlyOnline(), .onlyOffline()lib/helpers/src/ny_env.dart) - New centralized environment variable management with register(), get(), containsKey(), isInitializedlib/providers/src/providers.dart) - New configuration class for bootstrapping Nylo applications with setup and boot lifecycle functionslib/helpers/src/button_animation_style.dart) - Composable button animation styles: clickable (Duolingo-style 3D press), bounce, pulse, squeeze, jelly, shine, ripple, morph, shakelib/helpers/src/button_splash_style.dart) - Customizable button splash effects: ripple, highlight, glow, ink, none, customlib/widgets/src/animated_button_wrapper.dart)lib/widgets/src/ny_base_modal.dart) - Base class for creating modal bottom sheets with customizable layouts, headers, action rows/columns, close buttons, and drag handleslib/networking/src/models/ny_response.dart) - Enhanced API response class with isSuccessful, isClientError, isServerError, isRedirect, isUnauthorized, isForbidden, isNotFound, isTimeout, isRateLimited, dataOrThrow(), dataOr(), ifSuccessful(), when(), errorMessagelib/networking/src/models/cache_policy.dart) - API request caching strategies: networkOnly, cacheFirst, networkFirst, cacheOnly, staleWhileRevalidatelib/networking/src/interceptors/network_logger.dart) - New Dio interceptor with log levels (verbose, minimal, none), color terminal output, structured JSON output, and UUID-based request ID trackinglib/helpers/src/mixins/api_service.dart) - Mixin for classes that need typed API service access with onApiSuccess() and onApiError() callbackslib/themes/src/ny_theme_manager.dart) - Singleton theme manager with reactive updates via themeNotifier, system theme following, theme change stream, typed color styles, multi-theme support with preferred themeslib/themes/src/ny_theme_provider.dart) - Widget providing theme context with AnimatedTheme for smooth transitionslib/themes/src/ny_theme_storage.dart) - Secure storage for theme persistence including preferred light/dark theme IDs and follow-system preferencelib/helpers/src/ny_url.dart) - URL launching helpers with UrlLaunchModeType enum (externalApplication, inAppWebView, inAppBrowserView, platformDefault)FadeOverlay.top(), .bottom(), .left(), .right() and configurable strength parameterisFirst, isLast, isEven, isOdd, index, totalItems helpers for list items in CollectionView{{placeholder}} syntax and pipe-separated style groupslib/local_storage/src/storage_exceptions.dart) - StorageException, StorageSerializationException, StorageDeserializationException, StorageKeyNotFoundException, StorageTimeoutExceptionFormSlider and FormRangeSlider form fields, new FormTextField field, new FieldStyle configuration classlib/dart_console/src/spinner.dart) - New spinner component for CLI outputRunnable serviceswipeAllStorageData() with added excludeKeys parametercontainsRoutes()Nylo.init() - Services parameter accepting List<FutureOr<Runnable>> with three lifecycle phases: onInit(), onReady(), onAppReady()onLog and onRouteChange callbackslib/widgets/src/ny_app.dart) - New app-level widgetlib/widgets/src/text_tr.dart) - Text widget with built-in translation supportlib/router/src/route_matcher.dart) - Dedicated route matching utilitylib/router/src/router_functions.dart) - Extracted router utility functionslib/router/src/ny_navigator.dart) - Extracted navigator classlib/widgets/src/navigation_hub/bottom_nav_style.dart) - Navigation hub bottom nav stylingtest/alerts/, test/controllers/, test/core/, test/dart_console/, test/event_bus/, test/events/, test/helpers/, test/local_notifications/, test/local_storage/, test/localization/, test/metro/, test/networking/, test/providers/, test/router/, test/testing/, test/themes/, test/widgets/)env: EnvGetter (required), setup: BootConfig?, appLifecycle, and services parametersToastNotificationRegistry and ToastStyleFactory - configure via nylo.addToastNotifications()StorageConfig, StorageManager, StorageUtils, StorageHelpers, and NyStorageAndroidNotificationConfig, IOSNotificationConfig, LocalNotification, NotificationAttachment, NotificationExceptionNyEvent interface, EventBus, EventSubscription, event extensions, and ListenerNyLogger now supports onLog callback for external logging integrationNyRouteHistoryObserver now supports onRouteChange callback for external route trackingNyLocalization refactored with NyLocalizationConfig class for configurationservice_runner dependencyflutter_local_notifications to ^20.0.0connectivity_plus to ^7.0.0pubspec.yaml repository URL updated to 7.x branchpubspec.yaml SDK constraint updated to ^3.10.7patrol as dev dependency for widget testingtheme_provider package dependency - replaced by built-in NyThemeManager/NyThemeProviderpretty_dio_logger package dependency - replaced by built-in NetworkLogger interceptorlib/validation/ directory (ny_validator.dart, rules.dart, validations.dart)lib/exceptions/validation_exception.dartlib/forms/ny_login_form.dartlib/helpers/ny_text_style.dartlib/widgets/styles/ny_radio_tile_style.dartlib/events/events.dart, lib/router/router.dart, lib/dart_console/dart_console.dart, lib/providers/providers.dart, lib/local_storage/local_storage.dart, lib/local_notifications/local_notifications.dart, lib/localization/app_localization.dart, lib/networking/ny_base_api_service.dart)Nothing published for this version
Fix NyLanguageSwitcher AssetManifest.json
NyLanguageSwitcher AssetManifest.jsonNyRichText.template to construct rich text from a template stringAdded MetroService.createFile method to create a file in your project
MetroService.createFile method to create a file in your projectadded repeatOn to PushNotification class to allow repeating notifications
repeatOn to PushNotification class to allow repeating notificationsNothing published for this version
Nothing published for this version
Fix stateData in NyState to return the correct data type
NyState to return the correct data typeAdded lifecycleActions to Nylo.init. This will allow you to global handle your app's lifecycle.
lifecycleActions to Nylo.init. This will allow you to global handle your app's lifecycle.Added lifecycleActions to NyPage. This will allow you to handle lifecycle events in your pages.
lifecycleActions to NyPage. This will allow you to handle lifecycle events in your pages.Added excludeKeys to NyStorage.deleteAll. This will allow you to exclude certain keys from being deleted when calling deleteAll.
excludeKeys to NyStorage.deleteAll. This will allow you to exclude certain keys from being deleted when calling deleteAll.hasExecutedTaskOnce in NyScheduler. This will allow you to check if a task has been executed.Added set to NySession class. This will allow you to set a value in the session.
set to NySession class. This will allow you to set a value in the session.onFailure parameter to isSuccessful method in NyValidator.getInitialRouteName to return the correct initial route name when, when is used.Added PullableConfig to pullable widget.
PullableConfig to pullable widget.Added new visibleWhen extension to Widget class. This will allow you to show or hide a widget based on a condition.
visibleWhen extension to Widget class. This will allow you to show or hide a widget based on a condition.onPop to the pushTo method. This will allow you to receive a callback when the page is popped.removeFromIndex to NyPullToRefresh. This will allow you to remove an item from the list at a specific index.NyTextField onChanged method.Fix: getEnv helper to return an empty string if a variable is set like this APP_WEBSITE=""
getEnv helper to return an empty string if a variable is set like this APP_WEBSITE=""getEnv helper to return an empty string if a variable is set like this APP_WEBSITE=""* Update pubspec.yaml
Fix: Field.date not using the correct display format
Field.date not using the correct display formatAdd: export 'form_chips and form_radio' to ny_widgets.dart
prefixIcon to Field.passwordFix: _whenStateAction method in NyState
_whenStateAction method in NyStateAdded: nylo.broadcastEvents()to broadcast events to all listeners.
nylo.broadcastEvents()to broadcast events to all listeners.listenOn to listen to events in your app. E.g. listenOn<MyEvent>((event) { });listen helper in NyPage and NyState to listen to events in your app. E.g. listen<MyEvent>((event) { });event helper to support new broadcast parameter. E.g. event<MyEvent>(data: {...}, broadcast: true);Small breaking change to stateActions:
stateActions:
Map<String, Function()> get stateActionsMap<String, Function> get stateActionsJourneyProgressStyle? progressStyle; to journey widgetJourneyButtonStyle? buttonStyle; to journey widgetbackgroundGradient to bottomNav, topNav and journey widgetstateAction to support new data parameterJourneyProgressStyle - linear, dots, numbered, segments, circular, timeline, customJourneyButtonStyle added to JourneyState - standard, minimal, outlined, contained, customAdded: JourneyState class to help manage NavigationHubLayout.journey
JourneyState class to help manage NavigationHubLayout.journeyJourneyHelper class to help manage JourneyState'smakeJourneyWidget method to MetroService classparentOption to constantssyncToStorage method to NySession class. This will sync the session data to storagesyncFromStorage method to NySession class. This will sync the session data from storage* Fix NyStorage.read method
NyStorage.read methodAdded: makeCommand to MetroService class. This will allow you to create a custom command in your project.
makeCommand to MetroService class. This will allow you to create a custom command in your project.addPackages method to MetroServicedev parameter to addPackages and addPackage methodswithQueryParams to RouteView classhasQueryParameter(String key) to NyState class. This will allow you to check if a query parameter exists in the current route.runProcess to connect all streams to the processMerge PR contribution from voytech-net #37
Added: toTimestamp() helper for DateTime to convert to a timestamp
toTimestamp() helper for DateTime to convert to a timestampNyTextField classNyPage stateName if not given correct closure nameFix: Auth.authenticate method not setting the correct object data for the Backpack class
Auth.authenticate method not setting the correct object data for the Backpack classUpdate: session helper to support 'items'. E.g. session('onboarding', {"first_name": "john"}), now session will contain {"first_name": "john"}
session helper to support 'items'. E.g. session('onboarding', {"first_name": "john"}), now session will contain {"first_name": "john"}session helper 'data' method to support data([String? key]) to get the session data. E.g. session('onboarding').data('first_name')Refactor imports to not include package:nylo_support
BadgeTabpackage:nylo_supportTransitionType added for route transitions. E.g. routeTo(HomePage.path, transitionType: TransitionType.fade())setBadgeNumber of app iconAdd ny_future_builder.dart to ny_widgets library
ny_future_builder.dart to ny_widgets libraryAdded label to Forms. E.g. Field.email('Email', label: 'Email Address')
label to Forms. E.g. Field.email('Email', label: 'Email Address')Radio to Forms. E.g. Field.radio("Favourite Color", options: ["Red", "Blue", "Green"])Widget to Forms. E.g. Field.widget(child: MyWidget())submitButton to NyFormData Read more heresleep(0, 500) will sleep for 500 microsecondsNavigationTab.alerts* Update pubspec.yaml
Fix issue when resetting the NyPullToRefresh widget
NyPullToRefresh widgetstateAction() helper to allow you to send state actions to the NyState or NyPage classwhenStateAction(Map<String, Function()> actions) method added to NyState and NyPage classes to handle state actions
whenStateAction({"showDialog": () => showDialog()})Map<String, Function()> get stateActions => {} getter added to NyState and NyPage classes to handle state actions
Map<String, Function()> get stateActions => {"showDialog": () => showDialog()};Fix issue with Forms setting dummyData even if app env is not dev
* Update pubspec.yaml
Forms - Ability to set fields as readOnly
readOnly
Pullable widgetAdd new NavigationTab.alert widget for supporting alerts in the NavigationTab
NavigationTab.alert widget for supporting alerts in the NavigationTabtoBool and tryParseBool added to String classNavigationHubStateActions
alertEnableTab - Enable the alert for a specific tabalertDisableTab - Disable the alert for a specific tabFix small issue with NavigationHub not using the correct icon when active
NavigationHub not using the correct icon when activeAdded comprehensive DateTime manipulation methods:
addYears() and subtractYears()addMonths() and subtractMonths()addDays() and subtractDays()addHours() and subtractHours()addMinutes() and subtractMinutes()addSeconds() and subtractSeconds()currentIndex in your NavigationHub classbottomNavBuilder method to build the bottom navigation bartoDateString to accept a String formattoDateStringUK to format the date in UK formattoDateStringUS to format the date in US formatlocalAsset method added to AssetImageSmall change to getPublicAsset to remove first slash if it exists
getPublicAsset to remove first slash if it existsAdd Field.capitalizeSentences and Field.capitalizeWords
Field.capitalizeSentences and Field.capitalizeWordsEnsure handleSuccess handles responses within the correct status code range. Fixes 207
updatePageState publichandleSuccess handles responses within the correct status code range. Fixes 207header parameter in NyPullToRefresh and NyListViewNavigationTab to support updating the Page, Title, Icon, Background Color and Tooltip* Fix issue with NyState
NyState* Update pubspec.yaml
Fix updateState method when using NyPage.path
updatePageState privateSmall fix for NyLanguageSwitcher to support dark mode
NyLanguageSwitcher to support dark modeNew currentTabIndex method added to NavigationHubStateActions to set the current tab index
currentTabIndex method added to NavigationHubStateActions to set the current tab index* Fix form.dart
Fix validation max and min rules
init method added to FormsNyForm classrender method* Fix stateName in NyState * Slight refactor to NyBaseState
NyBaseStateFix useLocalNotifications in Nylo class
useLocalNotifications in Nylo classkIsWeb check to clearBadgeNumberdate_field to ^6.0.0Add headerSpacing and footerSpacing to NyForm
headerSpacing and footerSpacing to NyForm* Fix stops in NyFader * Merge PR from ruwiss
NyFaderUpdate form picker, form chips and checkbox to support light and dark colors better
NyTextStyle classNyColor classNyColor.resolveColor methodNylo.package methodgetAuthKey() methodUpdate delete request to support optional parameters
delete request to support optional parametersAdd LoadingStyle to helpers/loading_style.dart
LoadingStyle to helpers/loading_style.dartloadingStyle: loadingStyle parameter added to ButtonState classOne column per quarter.