Skip to main content

Release: 3.12

· 6 min read
Pierre Martin
Pierre Martin
CTO & Co-founder @ Front-Commerce

Documentation completeness, LLM Support, new Gezy Features and an update on Magento2 compatibility​

Front-Commerce 3.12 brings significant improvements to our ecosystem.

We've completed the comprehensive 3.x documentation with LLM optimization to help you work more efficiently with AI coding assistants.

This release also introduces new Gezy features including RMA workflows, sitemap generation, and product customization capabilities.

Additionally, we're announcing an upcoming Magento2 module major version and welcoming our new QA team who has revamped our testing infrastructure for better stability and coverage.

Read on to discover all the details of this release!

Complete 3.x Documentation and LLM Support​

We're finally able to announce a major milestone in our documentation journey that represents months of dedicated work from our team!

🎉 The comprehensive 3.x documentation is now complete! This wasn't just a simple migration — we meticulously reviewed, updated, and enhanced every single documentation topic from 2.x to ensure it accurately reflects the current state of Front-Commerce 3.x. We've also filled critical documentation gaps by adding detailed guides for features that previously lacked proper coverage.

As announced in our previous changelog, the documentation follows the four quadrants of documentation to ensure a consistent and user-friendly experience.

Taking this a step further, we've also begun optimizing our documentation specifically for Large Language Models (LLMs) and AI code assistants such as Cursor, GitHub Copilot, Claude, and ChatGPT. It means that these tools can now provide contextually accurate Front-Commerce-aware responses, helping you write better code faster and with fewer errors. In 2025, many more AI-related features will be introduced in Front-Commerce… for users and developers. This only is the first step.

Component override assisted by Cursor

💬 Your feedback is crucial! As we work to make our documentation more accessible to AI tools, we'd love to hear from you. Have you tried using AI coding assistants with our documentation? What was your experience like? Did they provide accurate Front-Commerce-specific guidance?

Please share your insights with us so we can continue refining and improving this integration for everyone's benefit. Report any failed tasks or issues you encountered while using AI tools with our documentation in your daily work to our support team.

Follow our guide to start using our documentation with your AI assistants.

New Gezy features​

This release introduces new features for Gezy users.

RMA: we've added a complete return management workflow for Gezy stores:

  • Create return requests with a search filter to locate returnable items
  • View a list of all return requests in customer account
  • Access detailed information for each return request

Sitemap Generation: sitemap now contains all products and categories pages.

Product Customization: customizable product options are now supported in Gezy, and support:

  • Text field input (single-line)
  • Text area input (multi-line)
  • Selection components for customizable product options

Upcoming Magento2 module major version supporting latest versions​

Front-Commerce will soon be compatible with the latest Magento versions. It doesn't require any changes to the Front-Commerce JS codebase, but will require an update of the PHP Magento2 module.

We couldn't finalize the Magento2 module release in time for this announcement, but we expect to release a new major version next week.

This version will support the latest versions of Magento2 and PHP, and will remove deprecated code and features for EOL Magento versions. We also introduced some technical quality related tools to improve the code quality and detect issues earlier.

Welcome our new QA team!​

During this release, we also onboarded a new Lundi Matin team to Front-Commerce. The automated QA team has taken over our E2E test suite and rewrote it from the ground up to use Playwright and CodeceptJS instead of Cypress.

They've increased the test coverage with new scenarios and improved the stability of the tests. This new team will also be responsible for reporting bugs and regressions to our core team as we move forward. Several fixes for detected issues have already been included in this release.

This enhanced QA process ensures that Front-Commerce continues to meet the exacting standards you expect, providing confidence and stability as we grow and evolve under Lundi Matin.

Other changes​

Features

  • Remix:
    • we now redirect url with trailing slash to url without, to prevent duplicate content and specific issues with dynamic routes
  • Theme:
    • we now support select components to select custom options on customizable products
    • we added an option to disable option edition from the cart page
    • we improved the Cart Item removal API by requiring itemId in useCartItemRemoveForm hook instead of removeItem function to make the API more predictable and type-safe. Please, follow our migration guide to ensure your project is compatible.
  • Gezy:
    • we now support Viva.com payments
    • we now support sorting in product search results
  • Payzen:
    • we added an option to disable automatic payment capture
  • Core:
    • we updated debug flags scopes for front-commerce:cache in the codebase

Bug Fixes

  • General:

    • we fixed an issue where the Service Worker would fail to load on Firefox in localhost. To apply this fix for versions prior to 3.12.x, you should run the following codemod:

      pnpm run migrate --transforms=sw-async

    • we now prevent negative quantities to be added to the cart at every layer of the application and for all platforms

  • Remix:

    • we fixed an issue where dynamic routes may not match when receiving a large number of requests simultaneously

  • Gezy:

    • the selection of an option in the GezyConfigurator now works as expected
    • logging out using Gezy extension now properly deletes the connect.sid cookie

  • Theme:

    • the Image component's fetchpriority prop now has valid React name
    • the NumberInput component now properly enforces min and max value constraints on input changes
    • we fixed an issue which would not allow to modify custom options in cart item
    • adding item to cart without specifying custom options now displays a feedback error as expected
    • AddToCart errors are now displayed on the product detail page as expected

  • Core:

    • we fixed a regression causing pnpm translate to fail due to an import changed in formatjs during an update

  • TwicPics:

    • Twicpics overrides now work as expected

Fixes from 3.12 and 2.35 have also been backported into previous minor versions. The following patch versions were released: 3.11.1, 3.10.3, 3.9.5, 3.8.9, 3.7.10, 3.6.12, 3.5.14, and 3.4.16.

Upgrade Front-Commerce (Migration guides): 3.12.0
Read the full changelog (Customers only): 3.12.0.