FluxStore 6.0.0: Flutter 3.41, hybrid payments, and universal links

FluxStore 6.0.0 focuses on Flutter 3.41, hybrid payments, and universal links. The release notes below preserve the official feature details, configuration examples, and fixes published by InspireUI.

Released March 29, 2026. View the official FluxStore WooCommerce changelog.

NEW FEATURE

Core Updates

Flutter 3.41.x Upgrade

Upgrade to the latest Flutterchannel stable v3.41.x

To make sure you are using the correct Flutter version, run this command:

flutter --version

To upgrade Flutter 3.41.x , please close all your IDE and run these commands in the project folder

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

To update/migrate the app to the latest version

• Follow this “Upgrade source code and Flutter” guide.
• Input your purchase code to configs/env.props file (if not input, the app will crash):

• Helpful guide “How To Easily Upgrade Sourcecode To The Next Version”

To fix the build issue with the new Flutter version

After upgrading, you may meet the cache issue of iOS while building the application. Please run this command to fix:

flutter precache --ios

In the new version, we have some breaking changes:

• You need to upgrade your Xcode version to 26.x to be able to run the app as well as upload to TestFlight

---

Hybrid Payment for WooCommerce

Supported: WooCommerce, MultiVendor (Dokan/WCFM)

• New checkout flow: Native checkout to enter address to select shipping to create order via API to app opens the payment page in a WebView (payment only, no full checkout page) to customer pays to order complete. This feature is used to replace the old MStore Checkout webview

Watch the video

• If the customer cancels payment, the order remains with Pending payment status - a Pay button is shown on the Order Confirmation and Order History screens
• Enable with the new config in lib/env.dart:

"paymentConfig": {
  "EnableWebviewCheckout": false,
  "EnableNativeCheckout": true,
+  // Only works when EnableNativeCheckout is true
+  "EnableHybridPayment": true,
},

---

Modempay Payment Gateway

Supported: WooCommerce | Currency: GMD only

Watch the video

• Integrated Modempay as a new native payment gateway - supports wallet, card, and bank payment methods
• Plugin: https://docs.modempay.com/plugins/woocommerce
• Get your keys from merchant.modempay.com/developers
• Add this config to lib/env.dart:

"modemPayConfig": {
  "paymentMethodIds": ["modempay"],
  "publicKey": "pk_test_...",  // for getCheckoutUrlViaForm
  "paymentMethods": ["wallet", "card", "bank"],
  "returnUrl": "fluxstore://inspireui.com",
  "production": false,
  "enabled": true,
},

---

Universal Links / App Links

Supported: All frameworks | BREAKING CHANGE

• Support iOS Universal Links and Android App Links - users tapping your website URLs (product, category, blog, etc.) on their phone will open the app at the correct screen instead of the browser
• Update dynamicLinkConfig in lib/env.dart:

"dynamicLinkConfig": {
  "type": "selfhosted",
  "serviceConfigs": {
    "selfhosted": {
      "supportedDomains": ["yourdomain.com"],
      "handleHttpsLinks": true,
      "handleCustomScheme": true,
      "customScheme": "fluxstore",
    },
  },
},

• iOS setup: Upload apple-app-site-association (no extension) to https://yourdomain.com/.well-known/apple-app-site-association with Content-Type: application/json
• Android setup: Upload assetlinks.json to https://yourdomain.com/.well-known/assetlinks.json
• Required: Set websiteUrl and websiteDomain in configs/env.props
• Supported deep link paths: /product/*, /product-category/*, /collections/*, /brand/*, /product-tag/*, /store/*, /listing/*, /blog/*, /post/*

---

Booking Module

Supported: WooCommerce (****WooCommerce Appointments plugin), Serverless (Firebase) | BREAKING CHANGE

• The Booking module has now been moved from extended to a regular license

---

Date Picker for Product Add-ons

• Support date picker widget for WooCommerce Product Add-Ons fields
• Customers can select a specific date when ordering a service or time-sensitive product

---

Wishlist Empty State Image

Supported: All frameworks

• Added emptyImage and boxFit options to wishListConfig in lib/env.dart to customize the image shown on an empty Wishlist screen
• Supports local assets and remote image URLs

"wishListConfig": {
  ...
+  "emptyImage": "assets/images/empty_wishlist.png",
+  "boxFit": "contain",
},

---

Product List Tile - Image Position Config

Supported: All frameworks (except GPT, WordPress, Vendor Admin, Delivery, WebApp)

• Controls whether the product thumbnail appears on the left or right side of the tile

• Automatically adapts to RTL languages (when null, the default RTL behavior applies)

• New imageOnLeft option for product layouts using "layout": "listTile" in lib/config/config_xx.json

{
  "layout": "listTile",
+  "imageOnLeft": false,
}

---

Cart Performance & Reliability

• Fixed a critical issue causing server overload (due to 80-90+ simultaneous API calls) during checkout
• Reduced server load by batching product API requests when checking cart
• Added pull-to-refresh in the Cart screen
• Cart is now verified before checkout - out-of-stock or unavailable items are flagged immediately with clear error messages

Watch the video

---

Wallet Config Refactor

Supported: WooCommerce, MultiVendor (Dokan/WCFM) | BREAKING CHANGE (backward-compatible)

• All TeraWallet settings are now consolidated into a single walletConfig block in lib/env.dart
• New teraWalletName option: set a custom wallet brand name globally without overriding individual translation strings

"advanceConfig": {
-  "EnableTeraWalletWithdrawal": false,
},
+"walletConfig": {
+  "enableTeraWallet": false,
+  "enableTeraWalletWithdrawal": false,
+  "teraWalletName": null,  // null = use default "TeraWallet" name
+},

Note: Old env.dart configs remain backward-compatible. MultiSite: use configurations per site to enable/disable wallet, instead of walletEnabled in multiSiteConfig.

---

Share Link Metadata Support

• Product and blog share links now include Open Graph metadata (title, description, image)
• Rich link previews appear automatically in messaging apps and social networks

IMPORTANT UPDATE

• [BREAKING CHANGE] EnableReview renamed to EnablePreview in checkout screen config (all 88 translation files updated) - if you override this key in env.dart or config_xx.json, rename it accordingly
• [BREAKING CHANGE] Wallet config restructured: move EnableTeraWalletWithdrawal from advanceConfig to new walletConfig.enableTeraWalletWithdrawal block (old env.dart remains backward-compatible - see feature #14)
• Blog category images are now handled more reliably - banners load consistently across all frameworks
• Product list now displays tag/brand names instead of raw IDs
• YouTube iframe videos in blog/product/HTML content now load correctly
• Support enabling/disabling login on Listing platforms (MyListing, ListingPro) that do not have booking support configured
• Updated flutter_facebook_auth and facebook_app_events to latest versions - requires Xcode 26.x or later to build for iOS
• Updated MyFatoorah payment SDK to the latest version

This release contains many fixes

• Fixed: wrong currency used for wallet cart payments
• Fixed: WebView crashing when opened (Vendor Admin, Delivery)
• Fixed(HTML): YouTube iframe not loading video content inside HTML content blocks
• Fixed: Arabic text search failing
• Fixed: shipping methods not appearing when no saved address exists
• Fixed(Rating): missing star caused by widget overflow
• Fixed(SearchScreen): text position in RTL
• Fixed: time parsing error causing the product list to display nothing
• Fixed: app not falling back to local config when cloud config/Mstore API caching is unavailable
• Fixed: fee names with encoded HTML entities displaying raw symbols
• Fixed: countdown timer position width issue in RTL layout
• Fixed(BoostEngine): falling back to cached result when remote data is missing
• Fixed(HomeScreen): product horizontal layout overlapping after switching app language
• Fixed: Size Guide not appearing due to case sensitivity in title matching
• Fixed: URL error display on HTML content pages
• Fixed(Magento): product variant details not loading or updating when a variant option is selected
• Fixed: shipping address being updated unexpectedly during checkout navigation
• Fixed: categoryMenuShowDepth config missing from some category menu layouts
• Fixed(Checkout): email field not validated when marked as not required
• Fixed(Loyalty): incorrect loyalty card priority in reward display

How to update/migrate the app to the latest version?

• Follow this “Upgrade source code and Flutter” guide.
• Input your purchase code to configs/env.props file (if not input, the app will crash):

• Helpful guide “How To Easily Upgrade Sourcecode To The Next Version”

How to activate FluxStore on FluxBuilder tool?

• Follow this guide:

[support.inspireui.com

https://support.inspireui.com/help-center/articles/42/47/124/upgrade-source-code-and-flutter](https://support.inspireui.com/help-center/articles/42/47/124/upgrade-source-code-and-flutter)

• Input your purchase code to configs/env.props file (if not input, the app will crash):

---

Upgrade and product links

• Read the official FluxStore 6.0.0 changelog
• Upgrade FluxStore source code and Flutter
• Activate FluxStore in FluxBuilder
• Download FluxBuilder
• Purchase FluxStore WooCommerce