FluxStore MAX changelog

• Design Your App Faster! Use FluxBuilder (Drag-and-Drop App Builder) https://fluxbuilder.com/download
• Quick Start (No-Code) https://docs.fluxbuilder.com
• Activation Guide: Learn how to sync and activate your FluxStore app inside FluxBuilder here.

IMPORTANT UPDATE

🔄 Core Updates

(1) Flutter 3.47.x Upgrade ⬆

• Upgrade to the latest Flutter channel stable v3.47.x [Android] Update compileSdk from 36 to 37

flutter --version

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”

(2) Required App Update + Custom Dialog Text

Supported: All Apps

• Force users to update when a new version is available in the store, or keep the update optional with a customizable dialog title, message, and button labels.
• Demo Screenshots:

"advanceConfig": {
  "versionCheck": {
    "enable": true,
    "iosId": null,
    "iOSAppStoreCountry": null,
    "androidId": null,
    "androidPlayStoreCountry": null,
+   "forcedUpdate": false,
+   "dialogTitle": null,
+   "dialogText": null,
+   "updateButtonText": null,
+   "dismissButtonText": null,
  }
}

"versionCheck": {
  "enable": true,
  "iosId": null,
  "iOSAppStoreCountry": null,
  "androidId": null,
  "androidPlayStoreCountry": null,
  "forcedUpdate": false,
  "dialogTitle": null,
  "dialogText": null,
  "updateButtonText": null,
  "dismissButtonText": null
}

"versionCheck": {
  "enable": true,
  "iosId": null,
  "iOSAppStoreCountry": null,
  "androidId": null,
  "androidPlayStoreCountry": null,
  "forcedUpdate": false,
  "dialogTitle": "New version availale",
  "dialogText": "Would you like to update it now?",
  "updateButtonText": "Update Now",
  "dismissButtonText": null
}

"versionCheck": {
  "enable": true,
  "iosId": null,
  "iOSAppStoreCountry": null,
  "androidId": null,
  "androidPlayStoreCountry": null,
  "forcedUpdate": true,
  "dialogTitle": "App Update Required",
  "dialogText": "Please update to continue using the app",
  "updateButtonText": "Update",
  "dismissButtonText": null
}

(3) Search Products by Image ⚡️

Supported Apps: WooCommerce, MultiVendor, Shopify, Listing, Magento, Opencart, Strapi, Prestashop, Notion, BigCommerce, Haravan, Serverless (Firebase), MAX-Multisites

• Let shoppers search for Products faster with Image Search in your E-commerce App. Simply upload an image and find similar products in seconds.
• This feature is available for Extended license. Please contact the support team to receive the n8n workflow and instructions.
• Demo video:

"searchConfig": {
+   // Required Extended license
+   "imageSearchUrl": "image-search-endpoint",
+   "imageSearchApiKey": null
}

(4) Realtime Chat Push via OneSignal User ID

Supported: All Apps

• Pass sender and receiver user ids through the normal chat screen flow.
• Persist chat user id in Firestore chat room users.
• Read Firestore chat user id with email fallback for backward compatibility.

(5) Ability to show/hide “See All” in Header Views

Supported: All Apps

• Enable feature to show/hide the “See All” button in the Blog, Product, Vertical, and Brand list header views. The Brand Carousel does not have a “See All” button.
• Demo Screenshots:

  

{
  "HorizonLayout": [
    {
      "layout": "threeColumn",
+     "showSeeAll": false
    }
  ],
  "VerticalLayout": {
+   "showSeeAll": false
  }
}

(6) Google & Facebook Login for Web/PWA

Supported: All Apps

• Google: on web, the official Google Identity Services button is rendered and the web client ID is configured from env.dart
• Facebook: initialize the JS SDK on web/macOS with facebookAppId before login

"loginSetting": {
  "showGoogleLogin": true,
+ "googleWebClientId": "YOUR_GOOGLE_WEB_CLIENT_ID.apps.googleusercontent.com",
}

(7) Hide Short Description on Product Detail

Supported Apps: WooCommerce, MultiVendor, Shopify, Magento, Opencart, Strapi, Prestashop, Notion, BigCommerce, Haravan, Serverless (Firebase), MAX-Multisites

• Added a new option to show or hide the Short Description across all Product Detail layouts.
• Demo Screenshots:

  

"productDetail": {
+   /// Show/hide the short description on the product detail page.
+   "showShortDescription": true,
}

(8) Correct Address Field Mapping

Supported: All Apps

• The apartment field in the Native Checkout was mapped to the WooCommerce company field. The unused block address field has been replaced with company, while the apartment field now correctly maps to address2.
• Demo Screenshots:

  

"addressFields": [
  {
-   "type": "block",
+   "type": "company",
    "visible": true,
    "editable": true,
    "position": 11,
    "required": false,
    "defaultValue": ""
  }
]

(9) Name-Based User Avatar 👤

Supported Apps: WooCommerce, MultiVendor, Shopify, Listing, Magento, Opencart, Strapi, Prestashop, Notion, BigCommerce, Haravan, GPT, Serverless (Firebase), MAX-Multisites, WordPress

• Replace the generic user icon with an Avatar generated from the User’s Name in the Settings profile item.
• Demo Screenshots:

  

(10) Hybrid Payment for Bookings ⚡️

Supported: Listing (Listeo) App

• Enable hybrid payment option for Listeo booking checkout, giving users more ways to complete their bookings.
• Demo Video:

"paymentConfig": {
  /// Only work when `EnableNativeCheckout` is true.
  "EnableHybridPayment": true,
}

(11) Show Payment After Booking ✨

Supported: Listing (Listeo) App

• After a successful listing booking, the app now opens the BookingPaymentScreen to complete payment. A skeleton loading state has also been added for Thai PromptPay.
• Demo Video:

(12) Updated Payment Methods Screen

Supported: Listing (Listeo) App

• Improved the listing booking Payment Methods screen with a clearer payment-method layout and a more intuitive continue action, making the checkout experience easier to navigate.
• Demo Screenshots:

  

(13) Disable “Pay Now” for On-Hold & Processing

Supported: Listing (Listeo) App

• Only pending and failed orders can be paid.
• “Pay Now” is hidden for on-hold, processing, completed, cancelled, and refunded bookings. Listeo also blocks payment for expired bookings.

(14) Vendor Info on Listing Detail ✨

Supported: Listing (Listeo + Dokan) App

• Display vendor information directly on the Listing Detail screen, making it easier for users to identify the vendor behind each listing.
• Demo Screenshots:

  

"productDetail": {
  /// Only for Listeo
+ "expandVendorInfo": true,
}

(15) Related Vendor Products on Listing Detail

Supported: Listing (Listeo/MyListing) App

• Show related products from the same vendor on Listeo and MyListing detail. Listeo requires Store Section to be enabled.
• Demo Screenshots:

  

"productDetail": {
  // Listing only (Listeo/MyListing): Listeo requires Store Section to be enabled
+ "showRelatedVendorProducts": true,
}

(16) Coupon Widget on Listing Detail

Supported: Listing (Listeo) App

• Add a Coupon Block to the Listing Detail screen, allowing users to easily discover and apply available coupons before proceeding with their booking.
• Demo Screenshots:

  

"productDetail": {
+ "expandCoupon": true,
}

(17) Listeo Editor: Field Value Below Label

Supported: Listing (Listeo) App

• Move each field value below its label in the Listeo editor to match the web listing form layout, providing a more consistent and familiar editing experience.
• Demo Screenshots:

  

(18) Headline for Listeo Editor Fields

Supported: Listing (Listeo) App

(19) Vendor Sales Chart: Filters & Types 📊

Supported: Manager App

• Filter sales stats by week, month, year, or all time.
• Switch between SaleStatsChart types.
• Support vendor admin sale stats series and trends.

(20) Improved Delivery Assignment Flow

Supported: Manager App

(21) Improved Vendor Store Info Setup

Supported: Manager App

• Prevent skipping vendor onboarding steps
• Add Street 2 field to vendor address
• Add vendor store email visibility toggle
• Allow removing vendor logo and banner
• Load vendor address states by country

(22) Improve Full Size Detail Scrolling

Supported Apps: WooCommerce, MultiVendor, Shopify, Listing, Magento, Opencart, Strapi, Prestashop, Notion, BigCommerce, Haravan, Serverless (Firebase), MAX-Multisites

• Update the Full-size Product Detail (or Listing Detail) layout to support smoother full-screen scrolling.
• Demo Video:

(23) Improved Post Management Screen ♻️

Supported: WordPress App

• Improve Blog Management for authors or admins with default post status, publish/draft/pending filters, post editing and deletion, automatic refresh after changes, and unsaved-change warnings when leaving the screen.
• Demo Video:

"advanceConfig": {
+   /// Default status when author/admin add New Blog.
+   /// Support 'draft', 'publish', 'pending', 'private'.
+   "NewBlogStatus": "draft",
},
"defaultSettings": [
  ...
+ "post",
  ...
],
"blogDetail": {
  ...
+ "defaultImage": "assets/images/no_image.png"
}

(24) More Blog List Layouts + Default Layout

Supported: WordPress App

• Add more layouts for the Blog List in the Filter screen and set a default layout from Setting.BlogListLayout.
• Supported values: list, columns, card, horizontal, listTile, simpleList.

"Setting": {
  "MainColor": "#3FC1BE",
  "ProductListLayout": "list",
+ "BlogListLayout": "list" // list, columns, card, horizontal, listTile, simpleList
}

(25) Order Status Tabs, Colors & Tracking Timeline

Supported Apps: WooCommerce, MultiVendor, Shopify, Manager.

• orderReturned
• readytopick
• picking
• delivering
• delivered
• driverAssigned when delivery assignment is enabled.
• outForDelivery when delivery assignment is enabled.
• failedDelivery when delivery assignment is enabled.

• Driver Assigned
• Out For Delivery
• Failed Delivery Attempt
• Refund Requested

"orderConfig": {
  "version": 1, // 1 or 2
+ /// Show delivery-related statuses in Order History filters.
+ /// Includes Driver Assigned, Out For Delivery, and Failed Delivery Attempt.
+ /// Requires a supported delivery-driver status integration.
+ "enableDeliveryStatusFilter": false,
},
"managerConfig": {
  "appLogo": "assets/images/app_icon_transparent.png",
  "appName": "FluxStore Admin",
  /// Enable assigning orders to delivery boys.
  /// Requires integration with FluxStore Delivery and FluxStore Manager.
- "enableDeliveryFeature": false,
+ "enableOrderAssignment": false,
}

(26) Improved WooCommerce Appointments

• Improve the available-date color for previous and next month navigation.
• Show “No slot available” when no appointment slots are available.

IMPORTANT UPDATE

• Multivendor App: Show vendor onboarding after SMS registration/login when vendor auto-approval is enabled on web.
• WooCommerce Apps: Add authentication for User Point APIs to fix security issues. Requires updating to the latest Mstore API plugin 4.21.2
• ⬆️ Updated dependencies to latest versions

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”

• Design Your App Faster! Use FluxBuilder (Drag-and-Drop App Builder) https://fluxbuilder.com/download
• Quick Start (No-Code) https://docs.fluxbuilder.com
• Activation Guide: Learn how to sync and activate your FluxStore app inside FluxBuilder here.

IMPORTANT UPDATE

🔄 Core Updates

(1) Flutter 3.47.x Upgrade ⬆

flutter --version

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

(2) [BREAKING CHANGE] User Point update

Supported: WooCommerce

• Design Your App Faster! NEW FluxBuilder IS LIVE (Drag-and-Drop App Builder) - MANY FREE TEMPLATES https://fluxbuilder.com/download
• Quick Start (No-Code) https://docs.fluxbuilder.com
• Activation Guide: Learn how to sync and activate your FluxStore app inside FluxBuilder here.

NEW FEATURE

🔄 Core Updates

(1) Update Google Play Policy 💥

Supported: All Apps

• Updated target API level for Android builds to Android 16 (API level 36).
• Updated com.revenuecat.purchases:purchases to the latest version.

(2) Tab Bar Minimize Support 🫧

Supported: All Apps

"TabBarConfig": {
+ "showMinimize": true
}

(3) Liquid Glass Bottom TabBar 💧

Supported: All Apps

• Adds liquid glass rendering mode - an iOS 26-style liquid glass effect to the tab bar background.

"TabBarConfig": {
+  "liquidGlass": true
}

(4) Floating Tab Bar 🎈

Supported: All Apps

"TabBarConfig": {
+  "floating": true
}

(5) OTP Length Configuration for SMS Verification 🔢

Supported: All Apps

"authConfig": {
 "providers": {
  "sms": {
+   "otpLength": null // 6 as default
  }
 }
}

(6) Video Shopping Sorting Config Support 🎬

Supported: Woo/Shopify

{
    "layout": "videos",
    "icon": "assets/icons/tabs/icon-videos.png",
    "styleVersions": ["1", "2"],
+   "order": "asc",
+   "orderby": "date"
}

• orderby supports date, modified (default), title, rand, id, menu_order.
• order supports ASC or DESC (default).

(7) Custom Filter Screen Support 🧭

Supported: All Apps

"filterConfig": {
    "showLayout": true,
    "showSort": true,
    "showPriceSlider": false,
    "showCategory": false,
    "showListingLocation": false,
    "showBrand": false,
    "showTag": false,
    "showFeature": false,
    "showAttribute": false,
		"supportedSortByOptions": ["date", "price"]
}

• supportedSortByOptions accepts: onSale, featured, date, price, title, popularity, rating, menu_order, rand, relevance.
• Empty or null keeps framework-specific default options.

(8) Language Expansion 🌐

Supported: All Apps

(9) HTML Link Handling Improvement 🔗

Supported: All Apps

(10) Testimonial Style Variants 💬

Supported: All Apps

(11) Phone Number Verification Upgrade ☎️

Supported: All Apps

• Upgrade Phone Number Verification to the latest version for improved stability and support for more phone number formats.
• Fix: phone still the same on back to address screen
• Fix: avoid missing phone number unexpectedly

(12) Product Detail Price Visibility 💰

Supported: All Apps

"productDetail": {
+ "showPrice": true
}

(13) Secure Screen Configuration 🛡️

Supported: All Apps

"secureScreenConfig": {
	 "enable": false,
	 "screens": []
}

• Set enable=true with empty screens to block app-wide.
• Or set enable=true with screens list to block specific routes only.

(14) External Product Button Text Support 🔘

Supported: WooCommerce

(15) Checkout Fields Manager ✅

Supported: WooCommerce, MultiVendor

"advanceConfig": {
+ "EnableWooCheckoutFieldManager": true
}

• Requires the latest MStore API plugin version.

(16) Delivery Time During Checkout 🚚

Supported: WooCommerce, MultiVendor

"advanceConfig": {
    /// Enable Delivery Date/Time when doing checkout
    /// Ref: https://support.inspireui.com/help-center/articles/35/37/160/delivery-date-picker
    "EnableDeliveryDateOnCheckout": false
}

• Requires the latest MStore API plugin version.

(17) Cashfree Payment Gateway Integration 💳

Supported: WooCommerce, MultiVendor, MAX-Multisites

"cashfreeConfig": {
+ "paymentMethodIds": ["cashfree"],
+ "enabled": true
}

• Install and activate Cashfree for WooCommerce plugin.
• Requires the latest MStore API plugin version.

(18) Delivery Online Option in Profile Settings 🔧

Supported: WooCommerce, MultiVendor

"defaultSettings": [
 ...,
+ "deliveryOnline",
 ...
]

(19) Store Name Style Options 🎨

Supported: MultiVendor

"productCard": {
+ "storeStyle": "normal" // normal, style01, hide
},
"cartDetail": {
+ "showStoreName": true
}

(20) Shopify Password Reset 🔐

Supported: Shopify

(21) Profile Add Listing Controls 🔧

Supported: Listing , ⚠️ BREAKING CHANGE

"defaultSettings": [
 ...,
+ "addListing",
 ...
]

• Existing apps must add addListing or this menu item will be missing.

(22) Listeo Calendar View Widget 📅

Supported: Listeo

"productDetail": {
+ "expandCalendarView": true
}

(23) Listeo Editor Fields Section 🧱

Supported: Listeo

• Requires the latest MStore API plugin version.

(24) Support Quantity for Bookable Options 🧾

Supported: Listeo Booking

• Give your customers a more flexible booking experience by allowing them to select quantities for bookable options directly in your Listeo app.
• Requires the latest MStore API plugin version.

(25) Booking Options for Children and Animals 🐾

Supported: Listeo Booking

• Adds children and animals options in booking flow.
• Includes min/max warning behavior improvements for guest constraints.
• Requires the latest MStore API plugin version.

(26) PrestaShop Endpoint Migration 🔄

Supported: Prestashop , ⚠️ BREAKING CHANGE

(27) Product Management Enhancements ✨

Supported: Vendor

(28) Brand Selection in Product Editor 🏷️

Supported: Manager

(29) Existing Tag Selection for Products 🧩

Supported: Manager

IMPORTANT UPDATE

• 🔄 [BREAKING CHANGE] Profile Add Listing settings now support show/hide and sorting with updated behavior.
• 🔄 [BREAKING CHANGE] Prestashop endpoints migrated to a new structure. Review custom endpoint usage after upgrade.
• ⬆️ Updated dependency set to latest compatible versions.

• Design Your App Faster! Use FluxBuilder (Drag-and-Drop App Builder) https://fluxbuilder.com/download
• Quick Start (No-Code) https://docs.fluxbuilder.com
• Activation Guide: Learn how to sync and activate your FluxStore app inside FluxBuilder here.

NEW FEATURE

🔄 Core Updates

(1) Flutter 3.44.x Upgrade ⬆

flutter --version

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

(2) Notification Improvements 🔔

Supported: All frameworks

• Improved notification screen, notification detail cards UI/UX.

• Fixed Android notifications are still shown when users disable Firebase topic flow.
• Fixed Android notification is cleared unexpectedly when opening the app.
• Fixed Android foreground notification display behavior.
• Fixed image and deeplink issues in notification flows.

(3) OneSignal User Tracking Upgrade 🔔

Supported: All frameworks

• Added tracking for user language, email, and phone number on OneSignal integration.

(4) Search Empty State Customization 🔎

Supported: WooCommerce, MultiVendor (Dokan/WCFM), Shopify, Magento, Opencart, Strapi, Prestashop, Notion, BigCommerce, Haravan, MAX-Multisites

• Added empty image support for search screen (no keyword / no result).
• Edit in the source code: open the file lib/env.dart and configure as below:

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

(5) Cart Empty State Customization 🛒

Supported: WooCommerce, MultiVendor (Dokan/WCFM), Shopify, Magento, Opencart, Strapi, Prestashop, Notion, BigCommerce, Haravan, Serverless (Firebase), MAX-Multisites

• Added empty-state image and fit customization for cart screen.
• Grouped cart sync options into cart config.
• In the source code,  open the file lib/env.dart and modify the field cartDetail as below: 

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

(6) Infinite Brand Carousel Layout ✨

Supported: WooCommerce, MultiVendor (Dokan/WCFM)

• Added new infinite brand carousel layout with autoplay and loop options.
• In the source code, open lib/config/config_en.json and config as below.

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

(7) New Image Compare Widget 🖼️

Supported: All frameworks

• Added imageCompare homepage layout widget for before/after showcase. Perfect for showcasing before/after transformations directly on your Homepage. Makes your app look professional!
• In the source code: open the file lib/config/config_en.json and configure as below

+ {
+   "layout": "imageCompare",
+   "beforeImage": "...",
+   "afterImage": "...",
+   "trackWidth": 3.0,
+   "borderRadius": 12.0,
+ }

(8) Hide Invalid Filter Values 🔍

Supported: WooCommerce, PrestaShop Apps

• Added support to hide invalid attribute/feature values on filter to avoid empty product result.

(9) Dynamic Link Handling in WebView 🔗

Supported: All frameworks

• Added support for dynamic links and deep links during WebView navigation, allowing supported links to be redirected to native app screens instead of loading inside the WebView
• In the source code, open the file lib/env.dart and configure webViewConfig as below:

"webViewConfig": {
+ "handleDynamicLink": true,
}

(10) Continue as Guest on Login 🚪

Supported: WooCommerce, MultiVendor (Dokan/WCFM), Shopify, Listing (Listeo/ListingPro/MyListing), Magento, Opencart, Strapi, Prestashop, Notion, BigCommerce, Haravan, GPT, WordPress

• Added configurable “Continue as Guest” button on login flow.
• In the source code, go to the lib/env.dart file, in authConfig, set true or false for showContinueAsGuestInLogin as below:

"authConfig": {
+ "showContinueAsGuestInLogin": false,
}

(11) Customer Note Flow Improvement 📝

Supported: WooCommerce, MultiVendor (Dokan/WCFM)

• Fixed missing customer note during checkout/order creation if enabling hybrid payment.
• Customer notes are now displayed reliably in order detail when available.

(12) PrestaShop Product Feature Support ✨

Supported: PrestaShop | ⚠️ BREAKING CHANGE

• Added support for product features and feature-based filtering in Prestashop.
• Support matching min-max values for product price range in filter.
• Requires new Prestashop module and API permission updates for product_feature_values, product_features, product_price_range

(13) PrestaShop Share Link Support 🔗

Supported: PrestaShop, WebApp

• Added product and product list share-link handling for PrestaShop.
• Requires new PrestaShop module.
• Requires adding all category rewrite links in the dynamic link path mapping.

"dynamicLinkConfig": {
  "serviceConfigs": {
    "selfhosted": {
      "customPaths": {
        "product": [
+         "/category_link_rewrite/",
        ],
      },
    },
  },
}

(14) Date On Sale in Vendor Admin 📆

Supported: Vendor Admin (Manager App)

• Helps sellers add Sales Start and End Dates when creating or updating products on the app.
• A sale countdown timer displays on the Product Details screen.

(15) Prevent Vendor Add New Attributes 🔧

Supported: WooCommerce, MultiVendor (Dokan/WCFM)

• Added configuration to disable vendors from creating new attributes while editing products.

"vendorConfig": {
+ "DisableVendorAddAttribute": false,
}

(16) Catalog Visibility in Vendor Admin 👓

Supported: Vendor Admin (Manager App)

• Added support for catalog visibility while creating/updating product.
• Requires the latest MStore API plugin.

(17) FAQ Section in Listing Detail ⁉️

Supported: Listing (Listeo/ListingPro App)

• Added FAQ section support in listing detail layouts.
• In the source code, open the file lib/env.dart and configure as below: 

"productDetail": {
+ "expandFAQs": true,
}

(18) Booking Rules: Min/Max Guests and Min Stay 🔧

Supported: Listing (Listeo App)

• Listeo App now supports Max/min Guests and Minimum Stay Day restrictions directly in the booking flow. Perfect for smoother property management! 🏠✨

(19) Mandatory Fee in Booking Summary 🏷️

Supported: Listing (Listeo)

• Added mandatory fee row in the booking summary widget to make the total amount clearer before payment.

(20) Listing ProductTitle Enhancements ✅

Supported: Listing (Listeo/ListingPro/MyListing App)

• Added instant booking icon support in ProductTitle (Listeo).

• Updated verified icon and reused ProductTitle in large card list UI.

(21) Listeo Classified Price Display ♻️

Supported: Listing (Listeo App)

• Improved price display behavior for Classified listing type in Listeo.

(22) Auth Config Refactor ⬆

Supported: All frameworks | ⚠️ BREAKING CHANGE

• Introduced unified authConfig structure in the file lib/env.dart to support flexible sign-up fields and modern provider config.

+ "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},
+   },
+ }

(23) Tracking Events Refactor ♻️

Supported: All frameworks

• Updated tracking events to improve consistency and maintainability.
  • Tracking login/register method events: sms, facebook, google, email/password
  • Fixed duplicate view cart events
  • Improved the view of the product detail event
• Upgrade the Facebook App Event and Firebase Analytics package to the latest version

(24) Currency Config Refactor ♻️

Supported: All frameworks | ⚠️ BREAKING CHANGE

• Extracted currency-related settings from advanceConfig in the file lib/env.dartinto dedicated currencyConfig.

"advanceConfig": {
-		"DefaultCurrency": ..., 
-		"Currencies": ..., 
-		"EnableWOOCSCurrencySwitcher": true
}
+ "currencyConfig": {
+   "defaultCurrencyCode": "USD",
+   "currencies": [...],
+   "enableWOOCSCurrencySwitcher": true,
+ }

IMPORTANT UPDATE

• ⬆ Upgrade dependencies to the latest version

NEW FEATURE

🔄 Core Updates

(1) Update easy_paypal to Comply with Google Play Policies ⬆

Supported: All frameworks

(2) Fix Android Build Error: local_auth compileSdk Incompatibility 🔧

Supported: All frameworks

(3) Fix Android Build Error: stripe_android / stripe_ios compileSdk Incompatibility 🔧

Supported: All frameworks (Extended source code only)

(4) Image & Color Support for Product Variation Swatches in Cart 🛒

Supported: WooCommerce, MultiVendor (Dokan/WCFM)

(5) Center Text Alignment in TabBar 🎨

Supported: WooCommerce, MultiVendor (Dokan/WCFM)

(6) Update Choose Plan Screen — Membership Ultimate 💄

Supported: WooCommerce, MultiVendor (Dokan/WCFM)

(7) Add Store Profile Image (Dokan / WCFM) ✨

Supported: MultiVendor (Dokan/WCFM)

"vendorConfig": {
  ...
+  /// Default Store banner image.
+  "DefaultStoreBanner": "",
+  /// Default Store profile image (avatar).
+  "DefaultStoreProfile": "",
+  "ProfileFit": "cover",
  ...
}

(8) Fix Store Social Info Not Showing + Update Contact UI 🐛

Supported: MultiVendor (Dokan/WCFM)

(9) Add Store Open/Closed Status Messages (Dokan) 🔧 

Supported: MultiVendor (Dokan)

(10) Support Message for Booking Listing ✨

Supported: Listing (Listeo)

(11) Add Logo for Listing Themes 💄

Supported: Listing (Listeo/ListingPro/MyListing)

🔄 Core Updates

• Fixed: Unable to press the order button on the first attempt — the place order button was unresponsive on the first load because selectedId was still null after payment methods loaded
• Fixed: config JSON not applied when changing language
• Fixed (Shopify): App crash on launch due to type cast of null to String when parsing blog post image URL in ShopifyBlog
• Fixed: Build issue due to connectivity_plus package

NEW FEATURE

🔄 Core Updates

(1) Flutter 3.41.x Upgrade ⬆

flutter --version

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

flutter precache --ios

(2) Hybrid Payment for WooCommerce 💳

Supported: WooCommerce, MultiVendor (Dokan/WCFM)

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

• 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,
},

(3) Modempay Payment Gateway 💳

Supported: WooCommerce | Currency: GMD only

• 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,
},

(4) 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/*

(5) Booking Module 📅

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

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

(6) Booking History (Listing) 📅

Supported: Listing (Listeo) | ⚠️ BREAKING CHANGE

• Support show/hide and custom ordering of the Booking History item on the Settings / Profile screen
• Action required: Add "booking" to the defaultSettings array in lib/env.dart or lib/config/config_xx.json when upgrading:

"defaultSettings": [
  ...
+  "booking",
  ...
],

(7) 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

(8) Listing: More Detail Screen Fields 📋

Supported: Listing (Listeo, ListingPro, MyListing)

• Support displaying additional taxonomy fields (categories, regions, features, tags) expanded on the Listing detail screen

• Support showing icon/image for Category, Listing Type Category, Regions, Features — falls back to a tick icon if none set
• Add new options in productDetail in lib/env.dart:

"productDetail": {
  // Only for Listeo
  "expandEventsCategories": true,
  "expandServicesCategories": true,
  "expandRentalsCategories": true,
  "expandClassifiedsCategories": true,

  // Only for FluxStore Listing (ListingPro/MyListing)
  "expandRegions": true,
  "expandFeatures": true,

  // Not supported for Listeo, MyListing
  "expandTags": true,
}

(9) 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",
},

(10) 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,
}

(11) Review Widget: Title Field Support ⭐️

• Support the Title field in the Review widget on the product detail screen

• Available for ListingPro and Shopify frameworks

(12) 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

(13) MultiSite — Override All Config Values 🏪

• Supported: FluxStore MAX
• Previously limited to a predefined set of special configs (advanceConfig, loginSetting, paymentConfig, productDetail, blogDetail, vendorConfig, reviewConfig)
  → Allow overriding all configuration values from the multi-site config per sub-app

(14) 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.

(15) MultiSite Switcher ↩️

Supported: FluxStore MAX | ⚠️ BREAKING CHANGE

• The multi-site switcher button is now fully configurable from FluxBuilder via lib/config/config_xx.json — previously it was hardcoded
• Option 1: Show in Logo bar via showSwitcherSite in HorizonLayout > logo:

{
    "HorizonLayout": [
        {
            "layout": "logo",
            "showMenu": true,
            "showSearch": true,
            "showLogo": true,
+           "showSwitcherSite": true,
            "enableBackground": true
        }
    ]
}

• Option 2: Add as a custom AppBar item using the new multisites_switcher type

{
    "AppBar": {
        "showOnScreens": [
            "home"
        ],
        "enable": true,
        "snap": true,
        "pinned": true,
        "floating": true,
        "elevation": 0,
        "alwaysShowAppBar": true,
        "items": [
            {
+               "type": "multisites_switcher",
                "pos": 400,
                "alignment": "center",
                "fontFamily": "CupertinoIcons",
                "fontWeight": "400",
                "icon": "globe",
                "iconSize": 24.0,
                "radius": 18.0,
                "height": 16.0,
                "backgroundColor": "0",
                "marginLeft": 4.0,
                "marginRight": 16.0,
                "marginTop": 4.0,
                "marginBottom": 4.0,
                "paddingLeft": 4.0,
                "paddingRight": 4.0,
                "paddingTop": 4.0,
                "paddingBottom": 4.0
            }
        ]
    }
}

• Breaking: Remove showAppBarSwitcherSite from multiSiteConfig (in lib/env.dart) — it is no longer used

(16) 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

(17) Support apply coupon when booking listing 🎁

Supported: Listing (Listeo)

• Support applying WooCommerce coupons to listing bookings

(18) Enhance Booking History UI with more details and options ✨

Supported: Listing (Listeo)

• Enhance Booking History UI with more details and options

  

• Support Cancel and Delete Booking

  

• [New feature] View and Download Purchased Tickets to support QR Code Verification System - https://docs.purethemes.net/listeo/knowledge-base/qr-code-verification-system/

• Add Chat with Owner option in Booking History screen

• 🔄 [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] MultiSite Switcher config moved: remove showAppBarSwitcherSite from multiSiteConfig in env.dart; use showSwitcherSite in FluxBuilder config_xx.json LogoConfig instead (see feature #15)
• 🔄 [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

NEW FEATURE

(1) Flutter 3.38.5 Upgrade ⬆

flutter --version

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

flutter precache --ios

(2) Full Support for Xcode 26 & iOS 15 Minimum Deployment 💥

• Fully compatible with Xcode 26, ensuring smooth builds and future-proof iOS development.
• Minimum iOS deployment target has been upgraded to iOS 15.0 (previously iOS 14.0).

(3) FiboSearch Integration 🔎

• Seamless integration with the FiboSearch (Ajax Search) plugin
• Displays instant search results while typing, without page reloads
• Improves search accuracy and product discovery for users
• Fully compatible with existing FluxStore search UI and product data

  "searchConfig": {
    /// Enable Ajax Search using either AjaxSearchPro or FiboSearch plugin
    /// ref: https://support.inspireui.com/help-center/articles/35/37/196/ajax-search-pro
    "ajaxSearch": {
      "enable": true,
      "plugin": "fiboSearch" //fiboSearch, ajaxSearchPro
    },

    /// Enable search by SKU in search screen
    "enableSkuSearch": true
  }

(4) WhatsApp Order Integration 💬

• Allow customers to send their order details directly via WhatsApp after a successful checkout.
• Integrate seamlessly with the existing payment flow.
• Message templates are fully customizable, with order information automatically populated for convenience.
• Support Native payment only (not support webview payment)

{
  "whatsAppOrderConfig": {
    "phoneNumber": "12124567890",
    "message": "Hello, I would like to place an order. Here are the details:\n\n{order_details}\n\nTotal Amount: {total_amount}\n\nThank you!",
    "paymentMethodIds": [
      "lwc-whatsapp-order"
    ],
    "autoOpenWhatsAppAfterOrder": false
  }
}

(5) Video Splash Screen 🎬

• Supports video playback on app launch instead of static images.
• Ideal for branding, promotions, or storytelling.

  "splashScreen": {
    "enable": true,

    /// duration in milliseconds, used for all types except "rive", "flare" and "video"
    "duration": 2000,

    ///  Type should be: 'fade-in', 'zoom-in', 'zoom-out', 'top-down', 'rive',
    ///  'flare', 'static', 'video'
    "type": "video",
    "image": "assets/videos/splashscreen.mp4", // https://demo.mstore.io/wp-content/uploads/2025/09/splashscreen.mp4

    /// AnimationName's is used for 'rive' and 'flare' type
    "animationName": "fluxstore",

    "boxFit": "contain",
    "backgroundColor": "#ffffff",
    "paddingTop": 0,
    "paddingBottom": 0,
    "paddingLeft": 0,
    "paddingRight": 0,
  },

(6) Auction Product Support 🔖

• Added support for the plugin WooCommerce Auctions - WordPress Simple Auctions , allowing customers to place bids directly from the app.
• Displays key auction information such as current bid, starting price, bid increment, auction start/end time, and auction status.
• Supports real-time bid updates when users refresh the product detail screen.
• Available for Extended license.

(7) Rental Product 🏠

• Allow customers to select rental dates directly on the product detail screen.
• Rental availability is validated in real time, and pricing is calculated accurately throughout the cart and checkout flow.
• Available for Extended license.

"EnableRentalProductsWoo": true,

(8) Social Login on Registration Screen 🔐

• Users can sign up instantly using supported social accounts.
• Reduces friction during account creation.
• Helps increase conversion and user retention.

 "loginSetting": {
    "showAppleLogin": true,
    "showFacebook": false,
    "showSMSLogin": true,
    "showGoogleLogin": true,
+   "showSocialInRegistration": false,
 }

(9) Show / Hide Sign In & Sign Up on Onboarding 🚪

• Choose whether to display Sign In and Sign Up buttons on onboarding screens.
• Ideal for guest-first experiences or content-first apps.

  "onBoardingConfig": {
    'enableOnBoarding': true,
    'version': 1,
    'autoCropImageByDesign': true,
    'isOnlyShowOnFirstTime': true,
    'showLanguage': true,
    'showLanguagePopup': false,
+   // Currently, only available for version 1
+   'showSignInSignUp': true,
  },

(10) Short Description on Product Card 📝

• Easily show or hide short descriptions on the product detail screen.
• Useful for clean layouts or minimal product pages.

  "productCard": {
    "defaultImage": 'assets/images/no_product_image.png',
    'showShortDescription': true,
    ...
  },

{
   "HorizonLayout":[
      {
         "layout":"",     ///twoColumn, threeColumn, fourColumn, card, saleOff, listTile, quiltedGridTile, carousel
         "showShortDescription":true,
         ...
      }
   ],
   "VerticalLayout":{
      "layout":"",     ///pinterest, menu, card, columns, columnsWithFilter, topProducts, menuWithCustomCategories
      "showShortDescription":true,
      ...
   }
   "TabBar": [
      {
         "layout": "category",
         "categoryLayout": "card",     ///card, sideMenuWithSub, columns, topMenu, animation, grid, sideMenuWithSub, 
                                                          ///sideMenuWithGroup, ///multi-level, ///fancy-scroll
         "icon": "assets/icons/tabs/icon-category.png"
      },
   ],
   ...
}

(11) Share Link for Product List Configuration 🔗

• Remove previous limitations in link creation, ensuring shared links always navigate to the intended screen regardless of layout configuration
• Users can now generate and open share links correctly even when layouts are / are not tied to a specific category, brand, or tag.

(12) Split Payment for Dokan (Stripe Connect & PayPal Marketplace) 💸

• Website must use Dokan Pro
• The following Dokan modules must be activated:
  • ✅ Stripe Connect
  • ✅ PayPal Marketplace

(13) Brand Layout Update 🏷️

• Support customizable image display.
• Allow highlighting specific brands list.

    {
        "name": "Brands",
        "layout": "brand",
        ...
        "imageBoxFit": "contain",
        "topBrand": [] // ID of brands
    },

• Upgrade(ios): migrate OneSignalNotificationServiceExtension to adapt with Xcode 26
• Allow to hide contact information in the store details screen
• Improve(UI): show login prompt for WebView auth
• Show stock quantity on product List & Product Detail
• Support loadmore in Menu with Custom Categories
• Support multilingual for time ago in Realtime Chat
• Chore: update phone field labels to comply with App Store guideline 5.1.1

NEW FEATURE

🔄 Core Updates

(1) Flutter 3.35.5 Upgrade ⬆

flutter --version

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

flutter precache --ios

(2) 16KB Memory Page Size Support 👍

• To ensure your app works correctly on the latest versions of Android, FluxStore 5.5.0 supports 16 KB memory page sizes to target Android 15+ by updating the NDK version and Rive dependencies.
• You may request an extension to this deadline until May 1st, 2026, by following this guide.

(3) FluxBuilder Dynamic Links Integration 🌟

• Project & Link Management
  • Added Create Projects Screen for developers to generate and configure deep link projects.
  • New Links Tables for managing all generated links, including validation and redirection rules.

• Analytics & Tracking
  • Introduced Analytics Links Dashboard to monitor clicks, sessions, and conversions in real time.

(4) Offline Mode ✨

• Offline status indicator
• Cached loaded product and category data for use without internet
• Automatic reconnection
• Queued actions synchronized when back online

Map<String, dynamic> environment = {
   ...
   "offlineModeConfig": {
        "enable": true,
    }
   ...
};

(5) Firebase Remote Config Update

🛒 WooCommerce Enhancements

(6) Extra Fees for WooCommerce

• The WooCommerce Extra Fees plugin lets you apply dynamic extra fees at checkout based on your customer’s choices, making your pricing strategies more flexible and transparent.
• Supported Plugin: https://wordpress.org/plugins/woo-conditional-product-fees-for-checkout/

(7) WCFM Live Chat 💭

 "configChat": {
    "wcfmLiveChatConfig": {
      "enable": false,
      "adminName": "InspireUI",
    },
  },
  "smartChat": [
    {
      "app": "wcfmLiveChat",
      "imageData":
          "https://trello.com/1/cards/611a38c89ebde41ec7cf10e2/attachments/611a392cceb1b534aa92a83e/previews/611a392dceb1b534aa92a84d/download",
      "description": "WCFM Live Chat",
    },
  ],

🛍️ Shopify Enhancements

(8) Shopify Re-Order Functionality

(9) Shopify User Address Management System 💫

🖼️ UI & Layout Improvements

(10) Cart Item BoxFit Options

  "cartDetail": {
    "minAllowTotalCartValue": 0,
    "maxAllowQuantity": 10,

    /// Cart Style: normal, style01
    "style": "style01",

+    /// Product Image Box Fit. Default: cover
+    "boxFit": "cover",
  },

(11) YITH WooCommerce Badge Management

• Apply graphic badges to highlight discounts, promotions, and key features of your products.
• Supported plugin: https://yithemes.com/themes/plugins/yith-woocommerce-badge-management
• This feature is now available for both Regular License and Extended License.

(12) Video Background Layout 🎞️

  "Background": {
    "height": 1,
    "color": "#026DCD",
    "image": "https://trello.com/1/cards/5dc3b80702a7994eec2ea5d0/attachments/5dc3b80802a7994eec2ea5d1/download/woman.jpg",
+   "video": "https://storage.googleapis.com/gtv-videos-bucket/sample/ForBiggerMeltdowns.mp4",
+   "fit": null, // For Image only
    "isScrollable": false
  },

(13) Scrollable Backgrounds

  "Background": {
    "height": 0.35,
    "color": "#026DCD",
    "image": "https://trello.com/1/cards/5dc3b80702a7994eec2ea5d0/attachments/5dc3b80802a7994eec2ea5d1/download/woman.jpg",
+   "isScrollable": true
  },

(14) Hide Vendor in Product Detail Screen

  "productDetail": {
    "height": 0.6,
    "marginTop": 0,
    "safeArea": false,
    "showBrand": true,
+   "showVendor": true,
  }

(15) Sub-Category Depth Display

    {
      "type": "image",
      "wrap": true,
      "horizontalItem": false,
      "columns": 4,
      "layout": "category",
      "marginLeft": 15.0,
      "marginRight": 15.0,
      "marginTop": 10.0,
      "marginBottom": 10.0,
      "separateWidth": 24.0,
      "shadow": null,
      "gradientStyle": false,
      "items": [
        {
          "originalColor": false,
          "backgroundColor": null,
          "title": null,
          "name": null,
          "keepDefaultTitle": false,
          "colors": [
            "ff3cc2bf",
            "ff3cc2bf"
          ]
        },
      "productCategoryMenuStyle": "tab",
      "categoryMenuShowDepth": true
    }

(16) App Exit Behaviors ♦️

  "advanceConfig": {
+   /// systemDefault, exitImmediately, requireConfirmPopup, requireDoubleTap
+   "exitAppType": "requireConfirmPopup",
  },

📱 Listing Enhancements

(17) Phone Number on Listing Cards

  "productCard": {
    "showPhoneNumber": true,
    ...
  },

(18) Show/Hide Address in Listing Cards

(19) FlatStyle in Listing Detail Layout 🌸

• Only support for Listeo theme

  "productDetail": {
      ...
      "layout": "flatStyle",
      ...
  }

🌐 WebView & Payment Enhancements

(20) Support for custom Thank You Page URLs 💞

"paymentConfig": {
    /// List of possible slugs for the successful checkout page on the website.
    /// It will be used to determine when the order is placed successfully and
    /// closes the webview checkout screen, trigger the cart deletion action.
    /// Also displays the native thank you page.
+   "CheckoutSuccessPageSlug": [
+     "objednavka-prijata",
+     "thank-toan-thanh-cong",
+     "thank-toan/thanh-cong",
+     "/xac-nhan-don-hang",
+   ],
}

(21) Support for opening products directly in WebView

{
  "productCard": {
+   "typeShouldOpenInWebview": [],
    "boxFit": "cover",
    "boxShadow": null,
    "defaultImage": "assets/images/no_product_image.png"
  },
}

    "typeShouldOpenInWebview": [
      "grouped",
      "auction",
      "external",
      "subscription",
      "appointment",
    ]

(22) External links open in the system browser instead of in-app WebView

  "advanceConfig": {
-   /// Disable inAppWebView to use webview_flutter
-   /// so webview can navigate to external app.
-   /// Useful for webview checkout which need to handle payment in another app.
-   "inAppWebView": false,
-   'AlwaysClearWebViewCache': false,
-   'AlwaysClearWebViewCookie': false,
-   "WebViewScript": "",
  },
+  "webViewConfig": {
+    "webViewMode": "webViewFlutter", // `inAppWebView` or `webViewFlutter`
+    "alwaysClearWebViewCache": false,
+    "alwaysClearWebViewCookie": false,
+    "webViewScript": "",

+    /// List of domains that should open the external app instead of the webview.
+    /// Just add the domain name only, do not add full URL. For example: "example.com"
+    /// If not set, we will use our default list from [kExternalDomains]
+    "externalDomains": [],

+    /// List of domains that should be loaded in the webview.
+    /// If the list is empty, all domains will be opened in the webview if it is
+    /// not in [externalDomains]. Otherwise, if the domain is not in this list, it
+    /// will be opened in the external browser.
+    /// Just add the domain name only, do not add full URL. For example: "example.com"
+    "internalDomains": [],
+  },

const kExternalDomains = [
  'wa.me', // Whatsapp
  'wa.link', // Whatsapp
  'api.whatsapp.com', // Whatsapp
  'm.me', // Messenger
  'messenger.com', // Messenger
  'www.messenger.com', // Messenger
  'ig.me', // Instagram
  'instagram.com', // Instagram
  'www.instagram.com', // Instagram
  'x.com', // X
  'facebook.com', // Facebook
  'www.facebook.com', // Facebook
  'youtube.com', // Youbute
  'www.youtube.com', // Youbute
  'youtu.be', // Youbute
  't.me', // Telegram
  'telegram.org', // Telegram
  'play.google.com', // Google play
  'apps.apple.com', // App store
  'zalo.me', // Zalo
];

(23) Razorpay Enhancements 💰

1. Updated razorpay payment flow for WooCommerce
2. Order ID and Invoice ID are now included in Razorpay checkout for improved payment tracking.

   

3. Added a dialog to clearly show multi-currency options, making international payments smoother and more user-friendly.

   

• 💥 Refactor!: drop support Firebase Dynamic Link
• Drop support the Better REST API Featured Images plugin
• Clarify the address by showing more details
• Update productListItemHeight config in Animation Category Layout
• Recalculate lineHeight in ProductTitle
• Add height config in Top Products Layout and Quilted Grid Tile
• Refactor: hide Firebase realtime chat/WCFM Live chat if disable instead of show error
• Chore(ui): phone input alignment in RTL languages
• Add Product List Item Height config to support product card configs in Fancy scroll layout
• Refactor: show increment_id instead of entity_id for order Magento
• Support textarea for WooCommerce product addons

NEW FEATURE

🔧 Core Features & Enhancements

1. Update Target API Level to Meet Google Play Requirements 💥

2. Support for YITH Addons

3. Support for Direct Link Sharing

  "dynamicLinkConfig": {
    "type": "selfhosted",
  },

4. New Video Shopping UI Styles

"TabBar": [
    {
      "layout": "videos",
      "styleVersions": [ // Add the versions you want to display here. You can arrange them in any order you prefer. If not set, only version 1 will be used as the default.
        "1",
        "2",
        "3",
        "4",
        "5",
        "6",
        "7",
        "8",
        "9"
      ],
      "icon": "assets/icons/tabs/icon-videos.png"
    }

5. Order Attribution Tracking via WebView Checkout

6. Display Product Category on Product Cards

🌍 Localization and International Support

7. Support for Amharic Language

8. Support for Saudi Riyal Symbol (SAR)

  "advanceConfig": {
    ...,
    "Currencies": [
      ...,
      {
        'symbol': '\ue900',
        'decimalDigits': 2,
        'symbolBeforeTheNumber': true,
        'currency': 'Saudi Riyal',
        'currencyCode': 'SAR',
      }
    ]
  }

🛠️ Advanced Configurations and Platform Enhancements

9. Flexible Shipment Tracking Configuration

• 🔧 Custom Tracking URL Support
  Store owners can now configure their own tracking URLs, enabling integration with third-party logistics providers or custom-built tracking systems.
• 🚫 Option to Disable AfterShip Integration
  A new setting allows AfterShip tracking to be disabled entirely, providing more flexibility for merchants who prefer alternative tracking methods or wish to manage logistics independently.

  "afterShip": {
+   "enabled": true,
    "tracking_url": "https://fluxstore.aftership.com", // Old URL, not using if `custom_tracking_url` is not empty
+   "custom_tracking_url": "https://fluxstore.aftership.com/{slug}/{trackingNumber}", // Default null
},

10. Instagram Story: Separated Display Time per Slide

• If a specific time is set per item → that time is used
• If not set → fallback to the video’s duration (if available)
• If video duration is not available → use the global default setting

          {
            "time": 5,
            "items": [
              {
                "id": "[#6ade0]",
                "image": "https://trello.com/1/cards/685321344e242df4e72be312/attachments/685b60f57568cc0b3a6825c8/download/David_Arizona_2025_-_IG_Reels_Promo_Voice_Actors.jpg",
                "video": "https://animewonderfest.com/wp-content/uploads/2025/06/IG-Reel-arizona-Promo-David-Matranga.mp4"
              },
              {
                "id": "[#aa32b]",
+               "time": 15, // default null
                "image": "https://trello.com/1/cards/685321344e242df4e72be312/attachments/685b6044be49b99d81f5342b/download/Matthew_Promo_-_Arizona_2025_-_Reels_-_Announcement_Posts.jpg",
                "video": "https://animewonderfest.com/wp-content/uploads/2025/06/IG-Announcement-Arizona-Promo-Matthew-Rudd.mp4"
              }
            ],
            "limit": 10,
            "layout": "instagramStory",
            "usePath": false,
            "itemWidth": 100,
            "marginTop": 10,
            "hideAvatar": false,
            "itemHeight": 200,
            "marginLeft": 15,
            "viewLayout": "media",
            "hideCaption": false,
            "itemSpacing": 16,
            "marginRight": 15,
            "marginBottom": 10,
            "enableBackground": false,
            "itemBorderRadius": 10
          }

11. Listing: Owner Role Registration Support

  "vendorConfig": {
    ...
    /// Show Register by Owner (Only for Fluxstore Listing)
    "OwnerRegister": true/false,
    ...
}

12. Custom Search Type Configuration for Products and Listings

1. Support search product in Listeo merge Dokan widgets
2. Support History Text and Recent Searches by productType
3. Handle logic show QRCode by productType and platform

        {
            "layout": "logo",
            "showSearch": true,
            "showLogo": true,
            "productType": true/false,
            ...
        },

        {
            "layout": "header_search",
            "productType": true/false,
            ...
        },

        {
            "layout": "header_text",
            "productType": true/false,
            ...
        },

        {
            "layout": "bannerImage",
            "title": {
                "productType": true/false,
                ...
            },
            ...
        },

13. Support Large Category UX

    "categoryConfig": {
      // Enable this option when the store has more than 100 category items
      "enableLargeCategories": true,
      "deepLevel": 3,
    },

🧩 FluxStore MAX Enhancements

14. Multi-site Switcher Layout (FluxStore MAX Support)

• MultiSiteSwitcherConfig: Defines the layout’s global settings and style.
• MultiSiteSwitcherStoreConfig: Handles individual store styling and folder mapping.
• MultiSiteSwitcherLayout: The main widget that renders the switcher UI based on the config.

• Customizable Appearance:
  Developers can define layout properties such as background color, spacing, border radius, and image display for each store.
• Dynamic Store Configuration:
  Each store can have its own icon, selected-state image, and color. The configuration supports both default and selected styles.
• Flexible UI Controls:
  Optional properties like button size, spacing, and image fit modes give you full control over the layout design.
• Integration with env.dart:
  You can configure the visibility of the store switcher button in the app bar using showAppBarSwitcherSite under multiSiteConfigs.

"multiSiteConfigs": [
  {
    "configFolder": "us_store",
    "showAppBarSwitcherSite": true
  }
]

{
  "layout": "multiSiteSelection",
  "backgroundColor": "#FFEAD5",
  "borderRadius": 10.0,
  "widthButton": 120.0,
  "heightButton": 35.0,
  "spacing": 10.0,
  "stores": [
    {
      "folder": "us_store",
      "image": "https://example.com/us-flag.png",
      "imageSelected": "https://example.com/us-flag-selected.png",
      "colorSelected": "#3FC1BE"
    },
    {
      "folder": "vi_store",
      "image": "https://example.com/vn-flag.png",
      "imageSelected": "https://example.com/vn-flag-selected.png",
      "colorSelected": "#FF6B6B"
    }
  ]
}

15. Shopify Support for FluxStore MAX

15. Update currency and country based on site config

• Added _updateCurrencyForSite method to handle updating currency and country when a new site configuration is selected.
• If the site config specifies a currencyCode, the app will attempt to find a matching currency from the kAdvanceConfig.currencies list.
• If a countryCode is also provided in the site config, it will override the country code of the found currency.
• If the site config's currencyCode is not found or not provided, the app will fall back to the kAdvanceConfig.defaultCurrency.
• The getPrefConfig method now prioritizes currency and country settings from multiSiteConfig before falling back to kAdvanceConfig.defaultCurrency or persisted settings.
• When changing the multi-site configuration via changeMultiSite, the currency and country are now updated according to the new site's settings.

IMPORTANT UPDATE

• 💥 Clarify address infor
• 💦 Confirmation dialog for Order Cancellation and Refund
• 🌟 Show corresponding error code when creating user

• ⌛ Optimize PlacePicker initial map loading
• 🔰 Add stock quantity in Back Order Products
• 🔷 Update (productListLayout): optimize shop product list layout
• 🌐 Refactor(map): optimize map screen layout and carousel responsive

NEW FEATURE

(1) Flutter 3.32.x Upgrade 🔥

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

flutter precache --ios

• To activate FluxStore on FluxBuilder tool ☘️ ChartSort

(2) Optimize Image performance 💯

• To optimize image performance, replace the outdated Generate Image feature with Optimole for real-time resizing and optimization. The plugin enhance loading speed and image quality by dynamically adjusting images based on visitor's screen size.

...
  "advanceConfig": {
   ...
        "OptimizeImage": {
            "enable": true,
            "plugin": "optimole" // Support "re-generate-image" plugin (old) & "optimole" plugin (new)
        },
   ...
  }
...

(3) Loyalty Feature 👑

• A loyalty feature allows Woocommerce site customers to earn points for shopping, which can be exchanged for rewards. Key elements include a reward system, QR code integration, and an admin dashboard for management (include QR Scan, Add/Redeem points, Coupons management)
• The feature is available for Extended license.

Configuration

In env.dart file, set enabled: true for loyaltyConfig to enable loyalty feature.

• Demo Screenshots

  

  

  

  

(4) Show/Hide Indicator for Banner Items ✨

• Add an optional dot indicator for banners on Home screen via showIndicator config — now fully customizable.
• Demo Screenshot

  

{
    "showIndicator": false
}

(5) Smart Banner (PopUp): Allow Tap Outside To Close ✋

• Make popups feel more natural! Users can now simply tap outside the banner to close it. Smooth, intuitive UX unlocked.

"SmartEngagementBanner": {
      "popup": {
        "allowTapOutsideToClose": true, // Default: false
        "iconSize": 36,
      },
    }

(6) Product Detail: Update Configurations for Videos 🎯

• Pause or play the video the first time opening Product Detail.
• Mute or play video sound the first time opening Product Detail.
• Show or hide the time indicator.
• Allow double-tapping to open the video in full screen.

  "productDetail": {
    /// Video config
    "showVideo": true,
    "isSoundOn": false,
    "autoPlayVideo": false,
    "enableTimeIndicator": true,
    "doubleTapToFullScreen": true,
}

(7) Product Detail: Show/Hide Share Product Data 📤

• Now you can show or hide the Share Product Data button on the product detail page with a simple config setting.
• Demo Screenshot

  

  "productDetail": {
    // Allow share product data. Default: true
    "allowShareProductData": false,
  }

(8) Order History: Show/Hide Reorder Button 📌

• Reordering made easy — or hidden. Add flexibility by showing or hiding the "Reorder" button in a customer’s order history screen.
• Demo Screenshots
  • Version 1:

  

  • Version 2:

  

  "orderConfig": {
    "version": 2,
    "enableReorder": false,
  },

(9) Branchio: Add android deepview control parameter to dynamic link 🔗

• Enhance deep linking on Android with new deepview parameter support for better navigation.
• Demo Video

(10) Product Title Text Scaling and Height Calculation 🔠

• Better UI consistency with automatic scaling and height adjustment for product titles.
• The feature is available on the app without configuration.
• Demo Screenshot

  

(11) Show/Hide Download Button ⬇️

• New option to display a download button in order history for digital products.
• Demo Screenshot

  

  "paymentConfig": {
       ...
       /// Show download button in order history detail for Digital/Downloadable Product
       "ShowDownloadButton": true/false,
  }

(12) Smart COD Pro 💰

• The feature is now only available for Extended license.
• Advanced Cash on Delivery options for WooCommerce — includes conditional rules and enhancements.
• Demo Screenshot

  

(13) Listing Merge Dokan 🤝

• Unified and optimized support for Dokan in the Listing layout for smoother vendor integration.
• More features are added to the Listing app to support Dokan products.
• Demo Screenshots

  

  

  

  

  

(14) Account role based access for webview option 🔐

• Show content only to the right users — automatically! With the new role-based webview access, you can control who sees what on webview page based on their login status and user role.
• Woocommerce, Multi Vendors or Listing apps can use this feature.

{
    "requiredLogin": true,
    "roles": []  //"customer", "administrator", "vendor",....
}

(15) Show/Hide Category Image Menu option in Listing 🖼️

• Want category images or just text? Flip the value in config and instantly change your menu style — visual or minimalist.
• Demo Screenshot

  

"advanceConfig": {
      /// false: show category menu as Text https://tppr.me/v3bLI
      /// true: show as Category Image
      "categoryImageMenu": true,
  }

(16) Open image gallery in Listing 🔄

• Tap on images in the listing detail page to view them in a full image gallery modal.
• Demo Video

(17) Show regular price and price in Banner Slider of Listing

• Hide price if none instead of showing "0.0"
• Show regular price and price for Product Horizontal with Banner Slider type.
• Demo Screenshot

  

(18) WCFM: Support Vendor Order Threshold Amount

• This feature adds support for setting a minimum order amount per vendor in multi-vendor stores using WCFM.
• Customers must meet the required threshold for each vendor before proceeding to checkout, helping vendors enforce order value limits individually.
• Demo Screenshot

  

IMPORTANT UPDATE

• 💥 Vendor approval is automatically disabled during registration
• 💦 Fix iOS build issue with FBSDKLoginKit
• 🌟 Handle decimal hours in UTC timezone offset
• 🆙 Update Khmer translation
• ⌛ Support firebase analytics consent mode v2
• 🔰(CartButtonWithQuantity): enhance animation and ui 
• 🔷 Update status translation in SmartRefresher 

NEW FEATURE

(1) Flutter 3.29.x Upgrade 🔥

flutter --version

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

flutter precache --ios

• To activate FluxStore on FluxBuilder tool ☘️ ChartSort

(2) Support padding and align for indicator and number ✨

Demo Screenshot

{
    "HorizonLayout": [
        {
            "layout": "bannerImage",
            "isSlider": true,
            ...
            "indicatorPadding": {
                "bottom": 12,
                "start": 30
            },
            "alignmentNumber": {
                "value": "topEnd" // topStart, topCenter, topEnd, centerStart, centerCenter, centerEnd, bottomStart, bottomCenter, bottomEnd
            }
            "indicatorAlignment": {
              "value": "topCenter" // topStart, topCenter, topEnd, centerStart, centerCenter, centerEnd, bottomStart, bottomCenter, bottomEnd
            },
            ...

        },
        ...
    ],
    ...
}

(3) PhonePe payment 💥

• Available for both Regular and Extended license

  "phonepeConfig": {
    'paymentMethodIds': ['phonepe'],
    'merchantId': 'GANGSTARPGUAT',
    'saltKey': '7eb940c6-b785-42e2-98ca-0419ebf5a219',
    'saltKeyIndex': '1',
    "androidPackageName": "com.inspireui.fluxstore",
    "iOSBundleId": "com.inspireui.mstore.flutter",
    'production': false,
    'enabled': true
  },

(4) Point offline store 🏅

• Shop managers can scan QR codes, enter purchase amounts, and handle point transactions directly at stores. The app shows a digital points card with QR code in the user's profile for easy access.
• The feature is available for an Extended license and require enable the Point and Reward plugin on your site.

"pointsOfflineStoreConfig": {
    "enabled": false,
    "usePointRateForOnePoint": 1, // 1 point = 1$
    "addPointRateForOnePoint": 100, // 1 point = 100$,
    "cardName": "FluxStore Card"
  },

"EnablePointReward": true

(5) New Tab Menu Category 🌸

"productCategoryMenuStyle": "tab”

(6) Blog Service 🛡️

(7) Product Card (PWA) 💡

Demo Screenshot

(8) Display images in notifications on iOS 👑

Demo Screenshot

(9) Support Telugu language ⌛

IMPORTANT UPDATE

• 🔆 DeepLink: fixed issue when using third-party plugins to handle deep links
• 💥 Enhancing permission request flow for better user experience
• 💦 Hotfix (HomeCache): home cache was cached with HTTP cache
• 🎨 (Menu Category): upgrade workflow when open category and support tab menu category
• 🧨 Improve (MyCart): show point input when show keyboard in my cart
• 🌟 Add missing SimpleList layout in Filter
• 🆙 Add Configuration for Order Status Changes [WCFM][Dokan]
• 🎊 Add (deliveryRole): Config to show/hide register as a Delivery boy role
• ⬆️ Support overnight hours for listings
• 🆙 Show dialog under approval when signing up in the MemberShipUltimate feature
• ⌛ Override systemNavigationBarColor
• 🔰 Improve (TabBarCustom): support change background color when show floating
• 🌈 Support shipping methods for listing merge single vendor
• ☑️ Show video buttons in Listeo merge Dokan
• ▶️ Support search product using Get method in Ajax Search Pro
• 🔷 Update notification permission flow
• 🌐 Support Multi Languages in TimeAgo
• 💫 Missing review data in ListingPro theme
• 💰 Update missing config for First Iraqi Bank payment