• Update dependencies

SDK & Dependency Updates #

• Updated SDK constraints:

  • Dart: >=3.8.0 <4.0.0
  • Flutter: >=3.32.0

• Upgraded dependencies:

  • async: ^2.13.0
  • playx_core: ^0.7.3
  • playx_theme: ^1.1.0
  • playx_widget: ^0.3.0
  • playx_network: ^0.5.1
  • playx_navigation: ^0.2.0
  • playx_localization: ^0.3.0
  • sentry_flutter: ^9.2.0
  • internet_connection_checker_plus: ^2.7.2
  • connectivity_plus: ^6.1.4

Connection Status Enhancements #

• Improved ConnectionStatusController:

  • Replaced default internet check URLs with more reliable ones.
  • Added backOnlineDelay to control delay after reconnection.
  • Skipped unnecessary checks on app resume.

Project Maintenance #

• Migrated example project’s Android build files to Kotlin DSL (.kts).
• Upgraded example project dependencies for compatibility.

• Update packages.

Enhancements #

• Updated boot and runPlayx to use builder functions for key configurations:

  • appConfigBuilder, localeConfigBuilder, themeConfigBuilder, and envSettingsBuilder are now passed as builder functions instead of direct instances.
  • This change improves flexibility, allowing deferred initialization and better dependency management.

• Deprecated direct configuration parameters in favor of builder functions.

  • Existing parameters like appConfig, localeConfig, themeConfig, and envSettings will be removed in future versions.

• Updated boot and runPlayx to include PlayxWebSettings for web-specific configurations.

  • PlayxWebSettings includes options like usePathUrlStrategy, optionURLReflectsImperativeAPIs.

Package Updates #

• Updated most dependencies to support WASM web builds for improved web compatibility.
• The only unsupported package is flutter_secure_storage, which prevents full WASM support.
  • To override this limitation, use:

    dependency_overrides:
      playx_core: ^1.0.0-beta.3
    

  • This allows Playx to support WASM builds while maintaining secure storage compatibility.

Migration Guide #

To update your existing implementation, replace direct configuration parameters with builder functions:

Before:

runPlayx(
  appConfig: MyAppConfig(),
  localeConfig: MyLocaleConfig(),
  themeConfig: MyThemeConfig(),
);

After:

runPlayx(
  appConfigBuilder: () => MyAppConfig(),
  localeConfigBuilder: () => MyLocaleConfig(),
  themeConfigBuilder: () => MyThemeConfig(),
  webSettings: PlayxWebSettings(usePathUrlStrategy: true),
);

• Updated Packages:

  • Updated to the latest versions of Playx packages for better performance and features.

• Custom Localization:

  • Added localizationsDelegates to PlayxAppSettings to support custom localization alongside PlayxLocalizationDelegates.

• Improved Initialization:

  • Added prefsSettings and workerManagerSettings to boot and runPlayx methods for easier app setup.

• Bug Fix:

  • Fixed a connection status issue of ConnectionStatusController where it reappeared unnecessarily after the app resumed.

1.2.1- 1.2.2 #

• Update exports

Note: This release has breaking changes. Please refer to playx_theme, playx_localization and playx_core for more information about the changes.

New Features:

• Introduced PlayxGetMaterialApp and PlayxGetPlatformApp:

Note: These classes might be removed in the future.

• These new classes are based on the old PlayxMaterialApp and PlayxPlatformApp, specifically tailored for use with GetMaterialApp and GetPlatformApp.

• They retain full compatibility with GetX features, including GetX-specific navigation and settings.

• Introduced [playx_navigation](https://pub.flutter-io.cn/packages/playx_navigation):

  • Added new package playx_navigation which is a wrapper around GoRouter to make navigation easier and more flexible.

Breaking Changes:

• Updated PlayxMaterialApp and PlayxPlatformApp:

  • These classes have been refactored to remove any references to GetX.
  • Now utilize the PlayxNavigation package, with the added flexibility to integrate goRouter via the navigationSettings.goRouter constructor.
  • This transition allows for more versatile and modern navigation solutions, making these widgets more adaptable to different routing needs and state management solution

• Updated ConnectionStatusController to ValueNotifier instead of GetxController:

  • The ConnectionStatusController has been updated to use ValueNotifier instead of GetxController.
  • This change allows for more flexibility and compatibility with different state management solutions.
  • To use the ConnectionStatusController, users need to wrap it with ValueListenableBuilder to listen to changes.

Enhancements:

• Moved to App Settings:

  • The properties shortcuts, scrollBehavior, actions, and title have been moved to the app settings, centralizing these configurations.

• Added PlayxGetNavigationSettings:

  • Introduced a new class with custom GetX navigation settings, offering extensive configurability, including navigatorKey, routes, initialRoute, onGenerateRoute, navigatorObservers, customTransition, transitionDuration, getPages, unknownRoute, routingCallback, and more.includeSentryNavigationObserver Update:

• Added includeSentryNavigationObserver:

  • The includeSentryNavigationObserver has been moved to navigation settings.
  • It no longer works with Router or GoRouter. Users need to add the observer manually if required.

• Update packages.
• Update minimum dart version to 3.4.1 and flutter version to 3.22.0.

Note: This release has breaking changes. Please refer to playx_theme and playx_localization for more information about the changes.

• Update packages.
• Renamed XLocaleConfig to PlayxLocaleConfig
• Renamed XThemeConfig to PlayxThemeConfig

• Update packages.

• Update packages.

• Update packages.
• Add Support for using Router instead of Navigator in PlayxMaterialApp and PlayxPlatformApp.
  • Small applications without complex deep linking can use Navigator,
  • while apps with specific deep linking and navigation requirements should also use the Router to correctly handle deep links on Android and iOS,
  • and to stay in sync with the address bar when the app is running on the web.
• Add new .router constructor for PlayxNavigationSettings to be able to use Router instead of Navigator.

• Update ConnectionStatusController check time interval and timeouts.

• Update packages.
• Bump dart version to 3.2.0 and flutter to 3.16.0.
• Add web support for ConnectionStatusController to allow checking internet connection on web.

- Add `ConnectionStatusController` which is used to check internet connection status by checking device connectivity and internet connection.

• Update packages.

• Update package exports.

Note: This release has breaking changes. Bumping version from(0.3.0-beta) to version(1.0.0-beta).

• Update packages.
• Update Playx boot and runPlayx methods to take PlayxEnvSettings parameter which is used to configure flutter_dotenv and load the .env file.
• Update example app to show example of loading keys from .env file using PlayxEnv.
• Add flutter_animate package to the list of exported packages.

BREAKING Changes #

• UpdatedPlayxMaterialApp to take screenSettings, themeSettings, navigationSettings, appSettings in it's constructor to make it easy to configure the app.

playx_core #

BREAKING Changes #

• Prefs was renamed to PlayxPrefs.
• SecurePrefs was renamed to PlayxSecurePrefs.
• SecurePrefsSettings was renamed to PlayxSecurePrefsSettings.
• getString, getInt, getDouble and getBool methods in PlayxPrefs now return non nullable value of it's type with the ability to provide it with a fallback that is returned if the key not found .
• getString, getInt, getDouble and getBool methods in PlayxSecurePrefsSettings now return non nullable value of it's type with the ability to provide it with a fallback that is returned if the key not found .

New features #

• Update packages.
• Added PlayxEnv : Wrapper for configure any the application with global variables using a .env file`.
• Update PlayxCore bootCore method to take PlayxEnvSettings parameter which is used to configure flutter_dotenv and load the .env file.
• Added new maybeGetString, maybeGetInt, maybeGetDouble and maybeGetBool methods in PlayxPrefs which return the value of it's type or null if the key not found or any error happened .
• maybeGetString, maybeGetInt, maybeGetDouble and maybeGetBool methods in PlayxSecurePrefsSettings which return the value of it's type or null if the key not found or any error happened .

playx_widget #

New Widgets #

• DashedLine :Creates a dashed line widget.
• FadeIndexedStack : Creates an indexed Stack widget that paints a single child with fade animation.
• FavoriteButton :Creates a button that shows favorite state.

Bug fixes and Enhancements #

OptimizedCard

• Update OptimizedCard default shadowColor to not be transparent on Ios.
• Add the onPressed callback for the card to listen to any tapping events.
• Add borderRadius which can be used to set the border radius of the default card's rounded rectangular shape.

OptimizedTextField

• Add hintStyle to the text field to customize the hint text style.
• Enhancement to the text field in Ios when using .adaptive constructor.

Note: This release has breaking changes.

• Update packages.
• PlayxAppConfig now requires asyncBoot to be overridden.
• We can check whether PlayxAppConfig asyncBoot function is completed by calling Playx.isAsyncBootCompleted .
• We can wait for PlayxAppConfig asyncBoot function to complete by calling Playx.asyncBootFuture.

• Update packages.
• Added platformSettings to PlayxPlatformApp that controls current platform settings.

Note: This release has breaking changes.

New features #

• Update packages.
• Added PlayxPlatformApp : A widget that wraps [GetMaterialApp] or [ GetCupertinoApp] based on the platform with support to screen_util, playx_theme and playx_localization.
• Added asyncBoot method that can be implemented by [PlayXAppConfig] to boot long running tasks asynchronously when launching the application.

playx_widget #

• include flutter_platform_widgets into the package to include platform specific widgets.
• fix errorMaxLines on OptimizedTextField not working correctly.

playx_theme #

• PlayxTheme now has isDeviceInDarkMode to indicate whether the user device is in dark mode or not.
  • XThemeConfig now has defaultThemeIndex to specify the default theme index that will be used first time as default theme.
  • new ImageTheme widget which is a widget that is themed by image content by providing image provider to be used with Material3 themes.
  • new utilities to be used like getBlendedColorScheme which blends two color schemes together and returns a new color scheme to be used with Material3 themes.
  • Included flex_seed_scheme package which is more flexible and powerful version of Flutter's ColorScheme.fromSeed and uses multiple seed colors, custom chroma and tone mapping to enahce creating a color scheme for Material3.

BREAKING Changes #

• XColorScheme was renamed to XColors.
• a Removed abstract colors like primary, secondary, background,surface, error ,onPrimary, Color get onSecondary, onBackground, onSurface, onError from XColors.
• XTheme colors property now have default value which is DefaultColors.

• Update packages.
• Update PlayxMaterialApp to include latest ScreenUtil parameters.

• Update packages.

• Update packages.
• Integrate Playx_theme updates into the app.

• Integrate Playx_localization package into this package.
• Playx.boot and Playx.runPlayx functions now require XLocaleConfig to define app localization. Check the example for more information.
• Playx.boot and Playx.runPlayx functions now boots also Playx_localization package so you don't need to worry about it.
• PlayxMaterialApp doesn't take any parameters that is about localization as localization is now done with Playx_localization package.

• updated packages

• Add new PlayxMaterialApp which is a widget that wraps [GetMaterialApp] with [PlayXThemeBuilder] to update the app with current theme and [ScreenUtilInit] that initializes [ScreenUtil] with the ability to set app orientation and more.
• Add new playx package playx_network which is a wrapper around Dio that can perform API requests with better error handling and easily get the result of any API request.
• updated packages

• add SecurePrefsSettings to Playx.runPlayx function to be able to customize secure storage settings.

• updated packages

• updated packages

• updated packages

• Add support for Dart 3.0.0 and Flutter 3.10
• Add new XColorScheme in playx_theme which is a new way to configure custom colors for each themes.
• update packages
• Update Playx.runPlayx function to support Sentry.
• Add new packages like Lottie, Sentry, Async and Fimber
• Add IsEqual which validates text form fields.
• Update example project.

• hide RContextMediaQuery from flutter_readable package to avoid conflicts with Getx package.
• update exports.

• add playx_widget package which contains custom utility widgets to make development faster.

• add AppConfing.boot() to initialize default configuration
• update packages

• remove sentry

• add Playx.boot()
• update playx_theme
• typos

• update playx_core to 0.0.2
• export playx_core
• fix typos

• fix : Error: Undefined name 'kDebugMode'.

• initial release.