FluxStore 6.2.0 Changelog

FluxStore 6.2.0 updates the app foundation to Flutter 3.44.x and adds more control over storefront layouts, authentication, notifications, analytics, and empty states.

This release also includes two configuration migrations. Review the authConfig and currencyConfig sections before merging 6.2.0 into an existing project.

Release highlights

Flutter 3.44.x support with updated dependencies.
Better notification behavior across foreground, background, topic, image, and deep-link flows.
New storefront tools including brand carousel and image comparison layouts.
Custom empty states for search and cart screens.
More flexible authentication with a unified provider and registration-field configuration.
Improved analytics for login, registration, cart, and product-detail events.

Before you upgrade

Close your IDE, switch to the stable Flutter channel, and refresh the project dependencies:

flutter channel stable
flutter upgrade --force
flutter clean
flutter pub get

Confirm the installed version:

flutter --version

Some plugins may report Swift Package Manager or Kotlin Gradle Plugin warnings during the first build. These warnings do not prevent the app from running.

For an existing project, follow the source code and Flutter upgrade guide. Add your purchase code to configs/env.props before running the app.

Storefront and customer experience

Custom search empty states

Search screens can now use a custom image and fit mode when no keyword is entered or no result is found.

Supported integrations include WooCommerce, Dokan, WCFM, Shopify, Magento, OpenCart, Strapi, PrestaShop, Notion, BigCommerce, Haravan, and FluxStore MAX.

{
  "searchConfig": {
    "emptyImage": "assets/images/empty_search.png",
    "boxFit": "contain"
  }
}

Custom cart empty states

The cart screen now supports its own empty-state image and fit mode. Cart synchronization settings have also moved into cartDetail.

{
  "cartDetail": {
    "boxFit": "cover",
    "emptyImage": "assets/images/leaves.png",
    "enableSyncCartFromWebsite": false,
    "enableSyncCartToWebsite": false
  }
}

Infinite brand carousel

WooCommerce, Dokan, and WCFM apps can add an autoplaying brand carousel to the homepage.

{
  "layout": "brandCarousel",
  "autoPlay": true,
  "loop": true,
  "showName": true
}

The new imageCompare homepage layout lets customers drag between before and after images.

{
  "layout": "imageCompare",
  "beforeImage": "assets/images/before.jpg",
  "afterImage": "assets/images/after.jpg",
  "trackWidth": 3.0,
  "borderRadius": 12.0
}

More storefront controls

WooCommerce and PrestaShop filters can hide invalid attribute values that would return an empty product list.
WebView navigation can route supported dynamic links and deep links to native app screens.
Login can show a configurable Continue as Guest action.
WooCommerce, Dokan, and WCFM checkout flows now preserve customer notes more reliably.

Enable native dynamic-link handling in WebView:

{
  "webViewConfig": {
    "handleDynamicLink": true
  }
}

Enable the guest action on the login screen:

{
  "authConfig": {
    "showContinueAsGuestInLogin": true
  }
}

Notifications and customer tracking

FluxStore 6.2.0 refreshes the notification screen and notification-detail cards. Android behavior has also been corrected across several common flows:

Notifications respect the user's Firebase topic preference.
Opening the app no longer clears Android notifications unexpectedly.
Foreground notifications display consistently.
Notification images and deep links resolve correctly.

OneSignal integrations can now associate the user's language, email address, and phone number with the OneSignal profile.

Authentication configuration migration

Breaking change: authentication settings now use a unified authConfig structure.

The new structure keeps the default method, providers, and registration fields together:

{
  "authConfig": {
    "defaultMethod": "emailPassword",
    "providers": {},
    "registration": {
      "email": { "show": true, "require": true },
      "firstName": { "show": true, "require": true },
      "lastName": { "show": true, "require": true },
      "phone": { "show": false, "require": false },
      "username": { "show": true, "require": false }
    }
  }
}

Move existing authentication and registration-field settings into this structure before removing the previous keys.

Currency configuration migration

Breaking change: currency settings have moved from advanceConfig into currencyConfig.

{
  "currencyConfig": {
    "defaultCurrencyCode": "USD",
    "currencies": [],
    "enableWOOCSCurrencySwitcher": true
  }
}

Remove DefaultCurrency, Currencies, and EnableWOOCSCurrencySwitcher from advanceConfig after confirming the new values.

Analytics updates

Tracking events have been reorganized for more consistent reporting:

Login and registration events now include SMS, Facebook, Google, and email/password methods.
Duplicate view-cart events have been removed.
Product-detail view events contain more reliable data.
Facebook App Events and Firebase Analytics dependencies have been updated.

Commerce fixes

Fixed guest checkout failures caused by order-status permissions for BACS and cash-on-delivery payments.
Fixed hidden catalog products appearing in SKU search.
Fixed missing regular prices on variable products.
Fixed attribute options disappearing when unselected attributes are null.
Fixed incorrect WooCommerce backorder labels when stock is still available.
Fixed product visibility rules for user groups and category controls.

App and device fixes

Fixed the Android navigation bar color after opening the app.
Fixed WebView microphone access on Android by handling MODIFY_AUDIO_SETTINGS.
Fixed scaled video playback on tablets and desktop layouts.
Fixed a rental date-range assertion.
Corrected several language names in env.dart.

FluxStore 6.2.0: Flutter 3.44, richer notifications, and new storefront controls