FluxStore 5.5.0 focuses on Offline mode, 16 KB support, and Dynamic Links. The release notes below preserve the official feature details, configuration examples, and fixes published by InspireUI.
Released October 9, 2025. View the official FluxStore WooCommerce changelog.
NEW FEATURE
Core Updates
Flutter 3.35.5 Upgrade
Upgrade latest Flutterchannel stable v3.35.5
To make sure you are using the correct Flutter version, run this command:
flutter --version
To upgrade Flutter 3.35.5 , 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.propsfile (if not input, the app will crash):
- Helpful guide “How To Easily Upgrade Sourcecode To The Next Version”
To fix build issue with 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 for Android platform:
- Upgraded
compileSdkVersion 35tocompileSdkVersion 36 - Upgraded
ndkVersion "25.1.8937393"tondkVersion "28.1.13356709" - Disable Impeller rendering engine (Android only)
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.
You can disregard the Edge-to-edge warning.
You can disregard these warnings:
Edge-to-edge may not display for all users:
From Android 15, apps targeting SDK 35 will display edge-to-edge by default. Apps targeting SDK 35 should handle insets to make sure that their app displays correctly on Android 15 and later. Investigate this issue and allow time to test edge-to-edge and make the required updates. Alternatively, call enableEdgeToEdge() for Kotlin or EdgeToEdge.enable() for Java for backward compatibility.
Your app uses deprecated APIs or parameters for edge-to-edge:
One or more of the APIs you use or parameters that you set for edge-to-edge and window display have been deprecated in Android 15. Your app uses the following deprecated APIs or parameters:
android.view.Window.setStatusBarColor
android.view.Window.setNavigationBarDividerColor
android.view.Window.setNavigationBarColor
FluxBuilder Dynamic Links Integration
A complete deep linking and tracking system that enhances navigation, marketing campaigns, and user engagement.
Manage everything easily through the FluxBuilder app builder.
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.
Offline Mode
Added offline browsing capabilities with:
- Offline status indicator
- Cached loaded product and category data for use without internet
- Automatic reconnection
- Queued actions synchronized when back online
Configuration
Change the file lib/env.dart as below
Map<String, dynamic> environment = {
...
"offlineModeConfig": {
"enable": true,
}
...
};
Firebase Remote Config Update
Improved the handling of Firebase Remote Config to balance update frequency and quota limitations. When a new version is uploaded, it is fetched and cached immediately, but applied only on the next app launch.
Ensures stable updates without applying unexpected changes mid-session.
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/
UI & Layout Improvements
Cart Item BoxFit Options
You can now update image BoxFit for cart items for more consistent visuals.
Configuration
Make changes in the file lib/env.dart as below:
"cartDetail": {
"minAllowTotalCartValue": 0,
"maxAllowQuantity": 10,
/// Cart Style: normal, style01
"style": "style01",
+ /// Product Image Box Fit. Default: cover
+ "boxFit": "cover",
},
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.
Video Background Layout
Added support for video-based backgrounds on the home and dynamic screens, enabling immersive storefront experiences.
Configuration
Open the file lib/configs/config_en.json and add “video” for “Background” as below:
Priority: video > image > color
"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
},
Scrollable Backgrounds
Introduced scrollable backgrounds for home and dynamic screens for more flexible and engaging UI layouts. When scrolling home or dynamic screen, the background will also scroll together for a more natural effect. (Not applied for Tab Menu and Scrollable screens.)
Configuration
Open the file lib/configs/config_en.json and set “isScrollable” as below:
"Background": {
"height": 0.35,
"color": "#026DCD",
"image": "https://trello.com/1/cards/5dc3b80702a7994eec2ea5d0/attachments/5dc3b80802a7994eec2ea5d1/download/woman.jpg",
+ "isScrollable": true
},
Sub-Category Depth Display
Improved category display with support for showing multiple levels of sub-categories.
Configuration
Open the file lib/env.dart, and then configure as below:
{
"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
}
Note:
• categoryMenuShowDepth : only support productCategoryMenuStyle that is "tab"
App Exit Behaviors
Configurable app exit options for Android device mainly, including double-tap to exit, exit confirmation dialogs, and instant close.
We have also fixed the back behavior for webview app
Configuration
Set and select exit app type directly in the file lib/env.dart as below:
"advanceConfig": {
+ /// systemDefault, exitImmediately, requireConfirmPopup, requireDoubleTap
+ "exitAppType": "requireConfirmPopup",
},
WebView & Payment Enhancements
Support for custom Thank You Page URLs
Store owners can add custom/translated checkout success URLs. The app will auto-detect checkout success events on any platform with webview checkout.
Configuration
Open the file lib/env.dart, and then configure as below:
"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",
+ ],
}
Support for opening products directly in WebView
Now you can decide product type to open in Webview or Native Product Detail, giving you consistent logic and more flexible control (works for both product and listing apps).
Configuration
Open the file lib/env.dart, and set as below:
{
"productCard": {
+ "typeShouldOpenInWebview": [],
"boxFit": "cover",
"boxShadow": null,
"defaultImage": "assets/images/no_product_image.png"
},
}
Demo
"typeShouldOpenInWebview": [
"grouped",
"auction",
"external",
"subscription",
"appointment",
]
External links open in the system browser instead of in-app WebView
Any URL that is not part of your app will now open in the external browser instead of inside the in-app webview. This makes navigation clearer, prevents broken flows, and gives users a smoother experience.
Configuration
Open the file lib/env.dart and configure as below:
"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": [],
+ },
Default External domains list:
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
];
Razorpay Enhancements
- Updated razorpay payment flow for WooCommerce
- Order ID and Invoice ID are now included in Razorpay checkout for improved payment tracking.
- Added a dialog to clearly show multi-currency options, making international payments smoother and more user-friendly.
IMPORTANT UPDATE
- Refactor!: drop support Firebase Dynamic Link
- Drop support the Better REST API Featured Images plugin
- Clarify the address by showing more details
- Update
productListItemHeightconfig in Animation Category Layout - Recalculate
lineHeightin 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
textareafor WooCommerce product addons
This release contains many fixes
- Fixed: Edge to Edge issue on Android 15
- Fixed: cannot build android due to com.facebook.android:facebook-android-sdk error
- Fixed: cache/delay fees/taxes issues when checkout
- Fixed (YithProductAddons): input style when open bottomshet at home screen
- Fixed: exception when loading country
- Fixed: spacing in checkout success UI screen
- Fixed: not update color when change theme for dialog add to cart
- Fixed: corner cart overlaps button in flat style
- Fixed (Magento): type cast exception when fetching products
- Fixed: render html for product description in Magento
- Fixed: crash when open midtrans payment for android release mode
- Fixed: change tab without initial tab data
- Fixed: back behavior for webview
- Fixed: crash android app if pay with stripe
- Fixed: Can't show category name [MyListing, ListingPro]
- Fixed: my rating not showing on listing woo app
- Fixed: parse margin for product badge
- Fixed: get first currency if default currency is null
- Fixed: Show corresponding error code and fix issue when login
- Fixed (review): type cast exception, not show on product detail
- Fixed: type cast error for include param in boost engine request
- Fixed: always show first tab instead of default tab
- Fixed: opencart does not show image properly
- Fixed (Wallet): Pay by wallet option display for smaller order price
- Fixed: show id only as delay or not load brand in filter
- Fixed: comma and dot position in currency
- Fixed: price range on listing card
- Fixed: show shipping fee without tax
- Fixed: multi language for Product review
- Fixed: not apply alignment for title of menu list item
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.propsfile (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.propsfile (if not input, the app will crash):

