NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
pub.dev
pub.dev, #3436 most downloaded on pub.dev
Core package for playx eco system contains shared classes and utilities.
Latest stable
2.0.0
Last release 14 days ago
08 Nov 2026
Release timing varies
gaps range from 1 weeks to 7 months
Most releases are documented
notes for 30 of 37 stable releases
Nothing withdrawn
no release was ever pulled
4 years old
43 releases · first in 2022
Drag across the ruler to compare, or tap a release to open it.
> Upgrading from 1.x? Follow the migration guide. The package now has full documentation in `doc/`.
Upgrading from 1.x? Follow the migration guide. The package now has full documentation in
doc/.
>=3.12.0 <4.0.0 and Flutter >=3.44.0 (was Dart 3.5 / Flutter 3.24), required by simple_secure_storage 0.4.3.PlayxEnv getters are synchronous. Values are in memory after load(), so await PlayxEnv.getString(...) becomes PlayxEnv.getString(...).PlayxEnv.load takes a PlayxEnvSettings instead of named arguments, and PlayxEnv.instance (flutter_dotenv's global dotenv) is removed in favor of PlayxEnv.all and PlayxEnv.values. PlayxEnv moved to lib/src/env/.PlayxEnv and PlayxSecurePrefs. Both use the safe_convert helpers: an unrecognized bool (anything but true/false/1/0) reads as null, so getBool returns its fallback instead of false; "1.5" reads as 1 for ints.PlayxSecurePrefsSettings groups the flutter_secure_storage options (iosOptions, androidOptions, linuxOptions, windowsOptions, macOsOptions) into flutterSecureStorageOptions: PlayxFlutterSecureStorageOptions(...). webOptions is removed.AndroidOptions no longer sets encryptedSharedPreferences, which flutter_secure_storage 11 removed (existing Android data is migrated automatically on first access).PlayxSecurePrefs now uses AES-GCM encrypted preferences with a non-extractable WebCrypto key kept in IndexedDB for every storage type except memory. No password, salt or key ships with the app. Data saved by 1.x with flutter_secure_storage is migrated automatically on the first start.WebUtils.setAppTitle takes named arguments on the web too (setAppTitle(title: 'x')), matching the non-web version. The two signatures differed, so the same call could not compile on both.Secure preferences (see Secure preferences)
PlayxSecurePrefsSettings.storageType (PlayxSecureStorageType). The default stays flutterSecureStorage:
simpleSecureStorage: uses simple_secure_storage, configured with PlayxSimpleSecureStorageOptions.encryptedPrefs: stores AES-GCM encrypted values in SharedPreferencesAsync, configured with PlayxEncryptedPrefsOptions. The key is kept in the first healthy store of keyStores (simple_secure_storage, then flutter_secure_storage) and is not replaced while values encrypted with it may still be readable. A per-device fallback key is used when no key store is available. Falls back to memory if preferences are unavailable. clear() only removes keys with the configured prefix.auto: uses the first backend of autoOrder (default: simple_secure_storage, flutter_secure_storage, encryptedPrefs) that passes a health check, then memory. Values written, removed or cleared on a fallback backend are applied to the preferred backend once it works again.memory: in-memory only.PlayxSecurePrefsSettings.encryptKeys (default false) hides key names where storage would expose them: encrypted prefs (all platforms, including web) and flutter_secure_storage on Android. Each value is stored under an HMAC-SHA256 of its name, keyed by a key kept in secure storage, and the name is kept inside the encrypted value. Existing values are converted when it is turned on or off. The auto journal is encrypted as well.PlayxSecurePrefsSettings.throwOnError (default true). When false, storage errors are logged instead of thrown, and memory is used if the backend can't be created.PlayxSecurePrefs.migrateFromFlutterSecureStorage() moves existing data when switching an app away from the default backend.PlayxSecurePrefs.storageType, PlayxSecurePrefs.isInitialized and PlayxSecurePrefs.dispose(). PlayxCore.dispose() now also disposes PlayxSecurePrefs.Environment configuration (see Environment configuration)
.env, then .env.<environment> (from environment, --dart-define=PLAYX_ENV=<name> or the Flutter flavor), then additionalFiles, secure env, mergeWith, PLAYX_DEFINES and dartDefines. Later files can reference earlier values.--dart-define values without declaring them in code: --dart-define=PLAYX_DEFINES="DEBUG=true;API_URL=..." (or base64: encoded .env content) is read automatically. Disable with usePlayxDefines: false. dartDefines covers individual --dart-define / --dart-define-from-file values.requiredKeys, failing at startup with a PlayxEnvException listing missing keys. Missing files are logged, or throw when isOptional is false.getNum, getUri, getEnum, getDuration, getList (comma-separated or JSON), getMap and getObject, each with a maybeGet* variant.EnvValues: an immutable set of values with all the typed getters, exposed as PlayxEnv.values and usable on its own (for example for remote config).isLoaded, environment, loadedFiles, all, containsKey and isSecure, plus loadFromString, setMockValues and dispose() for tests. PlayxCore.dispose() now also disposes PlayxEnv.Secure env (see Secure env)
.env.secrets (or CI variables) and run dart run playx_core:secure_env (dart run playx:secure_env in apps using playx) to generate an encrypted Dart file, passed as PlayxEnvSettings.secureEnv. Names and values are encrypted with AES-256-GCM and the key is embedded split, or passed with --dart-define=PLAYX_ENV_KEY.--from-env, --from-env-prefix PLAYX_SECRET_ and --define for CI, and an encrypted PLAYX_SECURE_DEFINES define. Secure values are excluded from PlayxEnv.all.doc/ci/. Generated files start with // dart format off so the byte lists stay compact.Preferences
PlayxPrefs, PlayxAsyncPrefs, PlayxPrefsWithCache and PlayxSecurePrefs to store maps, lists and objects: setMap/maybeGetMap/getMap, setList/maybeGetList/getList (with optional toJson/fromJson item converters) and setObject/maybeGetObject/getObject. Invalid or mismatched stored values return null or the fallback.Extensions and utilities (see Extensions and Utilities)
PlayxNumPaddingExtensions on num (p, px, py, pAll, pLR, pTB, pZero, single-side pt, pb, pl, pr, and RTL-aware ps/pe as EdgeInsetsDirectional) and PlayxWidgetPaddingExtensions on Widget (withPadding, pAll, pSymmetric, pOnly, pDirectional, pZero), returning Padding. Values are unscaled; scale the number first (16.r.p) when using a scaling package.border_extensions.dart): radius, ellipticalRadius, borderRadius with Top/Bottom/Left/Right and RTL-aware Start/End variants, roundedShape, border and borderSide on num; border/borderSide on Color; clipRounded, clipBorderRadius and bordered on widgets.String.capitalizedInitialChar (Unicode-safe initial) and String.toPrettyJson().BuildContext.crossAxisCount(...) for responsive grid columns.ColorUtils (fromHex, fromRGB) is now exported from playx_core.dart.toLocalDateTime* and asLocalDateTime* accept a utcOffset to read timestamps without zone information in a given zone (for example a server sending local Saudi time).onError callback (MapOnError<T, S>) on MapUtils.mapAsync, MapUtils.mapAsyncInIsolate and the MapAsync<T> extension methods. When provided, errors thrown while running the mapper (or while dispatching the isolate task) are caught, logged (subject to printError), and the value returned by onError is returned instead of rethrowing. If onError is null (the default), errors are rethrown after logging.Logging (see Logging)
PlayxCore.bootCore(loggerSettings:) configures the PLAYX CORE logger: turn colors off (no more ^[[38;5;4m in consoles that don't render ANSI), add the time, hide the boot messages with level: LogLevel.warning, or send logs elsewhere.PlayxLoggerSettings.printLoggerName and printDateTime now work (they were accepted but ignored). New options: dateTimeFormat (PlayxLogDateTimeFormat), dateTimeFormatter, printLevel ([INFO]-style labels) and target (PlayxLogTarget: debugPrint, stdout or developerLog) to choose the output channel, for example to avoid the flutter: prefix that the platform adds to print and debugPrint. Messages are written as [time] [LEVEL] [name] [tag] message.NO_COLOR, TERM=dumb, a stdout terminal without ANSI support). --dart-define=PLAYX_LOG_COLORS=true|false forces them on or off for a build, for example in an Android Studio run configuration, whose Run panel prints ANSI codes as text.PlayxLogTarget.developerLog now passes the logger name, the level and error/stackTrace to dart:developer's log (styled by Android Studio and DevTools) instead of formatted text.DefaultColoredLoggerFormatter (plain single lines) has a const constructor.LogLevel, AnsiPen, LoggerFormatter, LoggerFilter, LoggerOutput, LogDetails, ExtendedLoggerFormatter, ColoredLoggerFormatter and TalkerLoggerSettings are re-exported, so apps don't need a direct talker_logger dependency.Documentation
doc/: getting started, preferences, secure preferences, environment configuration, secure env, extensions, utilities, logging, testing and a migration guide. The guides are published as a searchable website (with the API reference) on GitHub Pages by .github/workflows/docs.yml. The README is now a concise overview that links to them, and the example app demonstrates environments and secure env.flutter_secure_storage ^11.2.0, simple_secure_storage ^0.4.3, flutter_dotenv ^6.0.1, pointycastle, flutter_lints ^6.0.0 and lints ^6.0.0. Ranges were widened for shared_preferences (>=2.3.0 <3.0.0), get_it (>=8.0.0 <10.0.0), equatable (>=2.0.7 <4.0.0), talker_logger, worker_manager and web.clearOnReinstall no longer requires PlayxPrefs to be created. It keeps using the same flag, so existing installs are not cleared.WebUtils now uses the web implementation on WebAssembly builds too (the condition is dart.library.js_interop instead of dart.library.html).package:playx_core/playx_core.dart rather than files under src/.BuildContext.form threw outside a Form instead of returning null (it now uses Form.maybeOf).asListInt and asListIntOr rejected values that asListIntOrNull accepts, such as [1, '2', 3.0]; they now convert the same way.PlayxAsyncPrefs.maybeGetString, maybeGetInt, maybeGetDouble and maybeGetBool did not catch asynchronous errors; they now return null as documented._mapAsync isolate entry point (removed a redundant try/catch that only rethrew).context.size resolves to BuildContext's own render size rather than the MediaQuery size; use context.width, context.height or context.aspectRatio for the screen size.PlayxLogger's documentation example used a PlayxLoggerSettings(name: ...) argument that doesn't exist.PlayxCore, secure storage backends and edge cases, env, secure env and its command, extensions, conversion helpers and web behavior (including browser tests).Your coding agent can read these notes before it upgrades. Set up the MCP server →
Refactored PlayxColorExtensions to eliminate deprecated dart:ui getters, transitioning to Flutter 3.24 wide-gamut compatibility (a, r, g, b). Added fr…
'data.user.name') in all safe_json_convert functions.toEnum/asEnum and toUri/asUri safe conversion functions.toListOrNull by adding a fallback to List<T>.from(value) for safer runtime casting.TalkerPlayxLogger to strictly respect the enabled configuration, utilize debugPrint, and automatically disable colored output in Web environments to avoid unformatted ANSI codes.PlayxColorExtensions to eliminate deprecated dart:ui getters, transitioning to Flutter 3.24 wide-gamut compatibility (a, r, g, b). Added fromHex, lighten, darken, and isDark helper methods.String, Iterable, DateTime, Duration, bool, BuildContext) to include new highly-requested utilities:
toIntOrNull(), isNumeric, isValidEmail, toSlug(), and NullableStringExtensions on String? (e.g., isNullOrEmpty).chunked, groupBy, sortedBy, and numeric aggregates (sum, average).startOfDay, endOfMonth, and startOfWeek.ColorScheme properties (e.g., onPrimary, surfaceContainer) directly to BuildContext for agile theming.Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Add new asTOr and asT safe json convert functions.
printError param to **MapUtils** mapAsync and mapAsyncInIsolate methods to determine whether to print errors or not.asyncMapInIsolate in NestedIterablesExtensions to include a printError parameter and printEachItemError parameter to determine whether to print errors for each item or not.Nothing published for this version
Nothing published for this version
Nothing published for this version
> Note: This release has breaking changes.
Note: This release has breaking changes.
New System Utilities (common_utils.dart)
setNavigationBarColor: Set navigation bar color and icon brightness.setOrientation: Lock screen orientation with optional rotation.hideKeyboard / showKeyboard: Control keyboard visibility.enterFullScreen / exitFullScreen: Toggle immersive full-screen mode.copyToClipboard / getClipboardText / clearClipboard: Manage clipboard content.setStatusBarColor now sets statusBarBrightness for improved iOS support.Safe Conversion Utilities (safe_convert.dart & safe_json_convert.dart)
Added:
toNumOrNull, toNumOr, toNumtoDateTimeOrNull, toDateTimeOr, toDateTimetoLocalDateTimeOrNull, toLocalDateTimeOr, toLocalDateTimeImproved:
fromJson<T, S>)asTOrNull: Now cleaner and more robustRefactored for consistency, better error handling, and improved documentation.
This version introduces a modern, powerful, and highly configurable logging system using the talker_logger package.
PlayxLogger with a modular and extensible system.PlayxBaseLogger: Abstract base for all logger implementations.TalkerPlayxLogger: Concrete logger using talker_logger, supports customization (name, colors, log levels, filters, formatters).PlayxLoggerSettings: Configure behavior globally (log level, console output, filters, etc.).PlayxLogger: Static utility class to manage and use named logger instances.PlayxCore now initializes a default logger named 'PLAYX CORE' on setup.
Internal operations like preference booting, environment loading, and error tracking now leverage the enhanced logger:
PlayxLogger.d('Debug message');
PlayxCore.logger.error('An error occurred', error:error);
Existing utilities (MapperUtilities, IterableExtensions) now use the new logger for standardized logging.
talker_logger: ^4.7.7 to pubspec.yaml.Nothing published for this version
Updates minimum supported SDK version to Flutter 3.24/Dart 3.5.
Add new printError param to MapUtils mapAsync and mapAsyncInIsolate methods to determine whether to print errors or not.
printError param to **MapUtils** mapAsync and mapAsyncInIsolate methods to determine whether to print errors or not.asyncMapInIsolate in NestedIterablesExtensions to include a printError parameter and printEachItemError parameter to determine whether to print errors for each item or not.> Note: This release has breaking changes.
Note: This release has breaking changes.
mapAsync and mapAsyncInIsolate now require the following parameters:
T data: The data to be mapped.Mapper<T, S> mapper: A required named parameter for the transformation logic.Iterable<T>
asyncMap and asyncMapInIsolate to require Mapper<T, S> mapper as a named parameter.NestedIterablesExtensions<T>:
asyncFlatMap. Use flatMapAsync instead.flatMap and flatMapAsync to require Mapper<T, S> mapper as a named parameter.mapAsyncInIsolate to map items in an isolate using workerManager by default.useWorkManager parameter:
true, uses workerManager to execute tasks.false, falls back to the compute method.bootCore)
PlayxPrefsSettings: Handles configurations for createPlayxPrefs, createPlayxAsyncPrefs, and createPlayxPrefsWithCache methods, which are now moved from the bootCore method.WorkManagerSettings: Supports additional configurations in the bootCore method.createSecurePrefs parameter to control the creation of secure storage during the boot process.mapAsync and mapAsyncInIsolate methods in the MapAsync<T> extension:
mapAsync now takes a Mapper<T, S> mapper as a required named parameter.mapAsyncInIsolate now includes the following parameters:
Mapper<T, S> mapper: Required transformation logic.bool useWorkManager: Defaults to true. Specifies whether to use workerManager or compute.fix: getDouble method in PlayxPrefs and PlayxAsyncPrefs return double not double or null.
getDouble method in PlayxPrefs and PlayxAsyncPrefs return double not double or null.refactor: Update safe_convert methods asIntOr, asDoubleOr, asBoolOr, asStringOr, asListOr, asMapOr, asListTOr, asListTFromJsonOr, asListIntOr, asListS
safe_convert methods asIntOr, asDoubleOr, asBoolOr, asStringOr, asListOr, asMapOr, asListTOr, asListTFromJsonOr, asListIntOr, asListStringOr, asTOr to take dynamic json instead of a Map<String,dynamic> json value.> Note: This release has breaking changes.
Note: This release has breaking changes.
safe_convert methods
asInt, asDouble, asBool, asString and asList, asMap, asListT, asListTFromJson ,asListInt, asListString, asT now throws FormatException if the result was invalid.asIntOr, asDoubleOr, asBoolOr, asStringOr, asListOr, asMapOr, asListTOr, asListTFromJsonOr, asListIntOr, asListStringOr, asTOr methods to provide a fallback value if the result was invalid.asListTFromJson method to convert a list of dynamic values to a list of a specific type.fromJson to asTOrNull, asT and asTOr.Nothing published for this version
- Update Readme
Added PlayxAsyncPrefs for non-blocking shared preferences handling.
PlayxAsyncPrefs for non-blocking shared preferences handling.PlayxPrefsWithCache for faster data retrieval with in-memory caching.GetIt integration for dependency injection management.PlayxCore to include GetIt instance management.PlayxPlatform class to provide platform-specific utilities.Add a new clearOnReinstall method to PlayxSecurePrefs to clear all the keys stored in the secure prefs when the app is reinstalled.
clearOnReinstall method to PlayxSecurePrefs to clear all the keys stored in the
secure prefs when the app is reinstalled.clearOnReinstall parameter to PlayxSecurePrefsSettings to clear all the keys stored
in the secure prefs when the app is reinstalled which is set to true by default.- Update packages.
Remove functions that check date weekDay and month from DateExtensionsand replace them with dayOfTheWeek() and monthOfTheYear().
DateExtensionsand replace them
with dayOfTheWeek() and monthOfTheYear().ColorExtensions and ColorUtils to create custom utilities for colors.IterableExtensions to add extensions
like lastWhereOrNull, lastWhereOr, firstWhereOr to
Iterables.PlayxEnv to not require a .env file to be present in the project when isOptional is
set true.FutureExtensions Extensions on [Future] to provide additional functionality.`Remove flutter_readable package from dependencies.
flutter_readable package from dependencies.PlayxCore to convert safely convert any dynamic value to the correct
type.- Update exports.
- Update exports.
> Note: This release has breaking changes.
Note: This release has breaking changes.
PlayXCore was renamed to PlayxCore.PlayxCore like also, let, run, takeIf
and takeUnless.toBoolean extension to String to convert string to boolean.\PlayxCore features.> Note: This release has breaking changes.
Note: This release has 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 .PlayxEnv : Wrapper for configure any the application with global variables using a .env
file`.PlayxCore bootCore method to take PlayxEnvSettings parameter which is used to
configure flutter_dotenv and load the .env file.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 .Move Intl package, DateExtensions and NumExtensions to playx_localization package.
Intl package, DateExtensions and NumExtensions to playx_localization package.- update packages and exports.
- Enhancements to SecurePrefs.
SecurePrefs.Nothing published for this version
Nothing published for this version
Add SecurePrefs to be able to store encrypted keys in the device.
SecurePrefs to be able to store encrypted keys in the device.Add format extension for strings to format stings.
Add support for Dart 3.0.0 and Flutter 3.10
DateExtensions, DurationExtensions , NumDurationExtensions
and NumExtensions.- update Readme
- update packages
add capitalizeFirstChar(String str)
capitalizeFirstChar(String str)capitalizeFirstCharForEachWord(String str)- initial release.
One column per quarter.