Guides

Release notes

v2.1.1 (August 20, 2026)

  • Fixed: the sandbox environment now points to https://sandbox-sync.aero.inc (previously https://sandbox.aerosync.com). If you allowlist AeroSync domains in a firewall or CSP policy, update it to the new host.

v2.1.0 (August 20, 2026)

  • Added typed multi-account success models — AeroSyncSingleAccountSuccessPayload, AeroSyncLinkedAccount, AeroSyncMultiAccountSuccessPayload, and the AeroSyncSuccessPayload base type, exported from the package barrel
  • Call AeroSyncSuccessPayload.fromJson(map) inside onSuccess to parse the raw map into a typed multi-account or single-account payload; narrow with is/is!
  • Purely additive — AeroSyncWidget.onSuccess keeps its existing untyped signature, so no existing integration needs to change

v2.0.1 (June 16, 2026)

  • Fixed: corrected installation instructions in README to reference ^2.0.1
  • Fixed: updated minimum Flutter constraint in pubspec.yaml from >=1.17.0 to >=3.44.0 to match the actual SDK requirements

v2.0.0 (June 16, 2026)

Breaking changes:

  • aeroPassUserUuid is now a required parameter on AeroSyncWidget
  • Removed dev and staging environments — only 'sandbox' and 'production' are supported
  • AeroSyncWidget now automatically dismisses when onSuccess or onClose fires — do not call Navigator.pop inside these callbacks
  • Removed AeroSyncEmbeddedView (to be re-introduced in a future release)

Added:

  • Flutter Web support — AeroSyncWidget now works on Flutter Web with two launch modes via the widgetLaunchType parameter: 'systemBrowser' (default, opens a centered popup window; OAuth bank flows stay inside the same popup throughout the full redirect chain) or 'host' (renders inline as an <iframe> embed)
  • AeroSyncNavigatorObserver — add to MaterialApp(navigatorObservers: [...]) to automatically handle iOS OAuth return routing
  • opacity style property — pass 'opacity': 0.0–1.0 in the style map to control the transparency of the widget container (iOS, Android, and Flutter Web)
  • MFA support via handleMFA, jobId, and connectionId parameters

Fixed:

  • OAuth external browser not opening on Android (and iOS via the same code path) — the SDK now intercepts the widget's launchExternalWindow event and opens the OAuth URL in the device's browser instead of passing it through unhandled

Migration guide:

  • Add aeroPassUserUuid: 'your-user-uuid' to all AeroSyncWidget usages
  • Remove any Navigator.pop calls from onSuccess and onClose callbacks — the SDK handles dismissal automatically
  • Replace 'dev' / 'staging' environment values with 'sandbox'
📘

Upgrading from v1.3.4?

See the Migrating from v1.x section of the Flutter Plugin doc for a full parameter-by-parameter migration table, or the Flutter Plugin (Legacy v1.3.4) page for the old API reference.

v1.3.4 (May 27, 2026)

  • Fixed onSuccess, onClose, and onEvent callbacks never firing — Flutter bridge readiness (isFlutterInAppWebViewReady) was not being established reliably after page navigation
  • Fixed onLoad callback never firing due to incorrect host comparison

v1.3.3 (May 26, 2026)

  • Updated README.md documentation
  • Removed dev and staging environments — only sandbox and production are supported

v1.3.2 (May 26, 2026)

  • Fixed onClose callback not firing after widget updates
  • Fixed onEvent and onError callbacks not delivering data correctly
  • Widget now dismisses reliably on both success and close flows

v1.3.1 (October 2, 2025)

  • Fixed Flutter Web event handling and return values
  • Made the style parameter optional — now defaults to standard dimensions (375x688)
  • Improved documentation for the style parameter with detailed property descriptions, default values, and ARGB format examples

v1.3.0 (September 30, 2025)

  • Added support for Flutter Web — the SDK now automatically uses a secure iframe when running in a web browser
  • The same AerosyncSDKPage widget now works seamlessly across iOS, Android, and Web
  • Made the deeplink parameter optional to improve the developer experience for web-only applications
  • Added various stability fixes for navigation and event handling to support cross-platform compatibility

v1.2.1 (July 23, 2025)

  • Updated README.md for the 1.2.1 release

v1.2.0 (July 23, 2025)

  • Added theme parameter to customize widget appearance — supports 'light' and 'dark' (default 'light')
  • Updated documentation with theme usage examples
  • Fixed MFA validation logic to only require jobId and userId when handleMFA is true (not just non-null)

v1.1.0 (October 17, 2024)

  • Added a new Sandbox environment for testing
  • New Aerosync URL

v1.0.6 (March 30, 2024)

  • Removed unused dependencies
  • Overall improvements

v1.0.5 (February 27, 2024)

  • Minor bug fixes
  • Response JSON changes — check README for details

v1.0.4 (February 1, 2024)

  • Minor bug fixes
  • Added parameters to handle MFA-only invocation

v1.0.3 (December 21, 2023)

  • Changes for a better experience with the testing environment

v1.0.2 (December 14, 2023)

  • Fixed onClose event bug

v1.0.1 (December 11, 2023)

  • Minor bug fixes

v1.0.0 (November 24, 2023)

  • Major bug fixes
  • Added support for the style parameter to customize the widget
  • Added support for OAuth popup window authentication
  • Added an example
  • Added environment variables: dev, staging, production
  • Added the deeplink parameter
  • Widened library dependency ranges for broader Flutter version compatibility

Updated about 1 month ago

Did this page help you?