From 802b9d3caf0187e0021d6143d4cb963dbf02074b Mon Sep 17 00:00:00 2001
From: madhuri-uppu <madhuri.uppu@salesforce.com>
Date: Mon, 9 Jun 2025 14:49:32 -0700
Subject: [PATCH 01/44] Trigger a modal if bonus products exist in AddToCart
 response

---
 .../app/components/_app/index.jsx             |  51 +++---
 .../app/components/product-view/index.jsx     |  55 +++++--
 .../app/hooks/use-bonus-product-modal.js      | 139 +++++++++++++++++
 .../app/hooks/use-bonus-product-modal.test.js | 145 ++++++++++++++++++
 .../app/pages/checkout/index.jsx              |   3 +
 .../app/pages/product-detail/index.jsx        |   7 +-
 6 files changed, 364 insertions(+), 36 deletions(-)
 create mode 100644 packages/template-retail-react-app/app/hooks/use-bonus-product-modal.js
 create mode 100644 packages/template-retail-react-app/app/hooks/use-bonus-product-modal.test.js

diff --git a/packages/template-retail-react-app/app/components/_app/index.jsx b/packages/template-retail-react-app/app/components/_app/index.jsx
index a841ef4930..957155e7b3 100644
--- a/packages/template-retail-react-app/app/components/_app/index.jsx
+++ b/packages/template-retail-react-app/app/components/_app/index.jsx
@@ -33,6 +33,7 @@ import {SkipNavLink, SkipNavContent} from '@chakra-ui/skip-nav'
 
 // Contexts
 import {CurrencyProvider} from '@salesforce/retail-react-app/app/contexts'
+import {BonusProductModalProvider} from '@salesforce/retail-react-app/app/hooks/use-bonus-product-modal'
 
 // Local Project Components
 import Header from '@salesforce/retail-react-app/app/components/header'
@@ -413,32 +414,32 @@ const App = (props) => {
                             </Box>
                             {!isOnline && <OfflineBanner />}
                             <AddToCartModalProvider>
-                                <SkipNavContent
-                                    style={{
-                                        display: 'flex',
-                                        flexDirection: 'column',
-                                        flex: 1,
-                                        outline: 0
-                                    }}
-                                >
-                                    <Box
-                                        as="main"
-                                        id="app-main"
-                                        role="main"
-                                        display="flex"
-                                        flexDirection="column"
-                                        flex="1"
+                                <BonusProductModalProvider>
+                                    <SkipNavContent
+                                        style={{
+                                            display: 'flex',
+                                            flexDirection: 'column',
+                                            flex: 1,
+                                            outline: 0
+                                        }}
                                     >
-                                        <OfflineBoundary isOnline={false}>
-                                            {children}
-                                        </OfflineBoundary>
-                                    </Box>
-                                </SkipNavContent>
-
-                                {!isCheckout ? <Footer /> : <CheckoutFooter />}
-
-                                <AuthModal {...authModal} />
-                                <DntNotification {...dntNotification} />
+                                        <Box
+                                            as="main"
+                                            id="app-main"
+                                            role="main"
+                                            display="flex"
+                                            flexDirection="column"
+                                            flex="1"
+                                        >
+                                            <OfflineBoundary isOnline={false}>
+                                                {children}
+                                            </OfflineBoundary>
+                                        </Box>
+                                    </SkipNavContent>
+                                    {!isCheckout ? <Footer /> : <CheckoutFooter />}
+                                    <AuthModal {...authModal} />
+                                    <DntNotification {...dntNotification} />
+                                </BonusProductModalProvider>
                             </AddToCartModalProvider>
                         </Box>
                     </CurrencyProvider>
diff --git a/packages/template-retail-react-app/app/components/product-view/index.jsx b/packages/template-retail-react-app/app/components/product-view/index.jsx
index 2da2feaa93..01e0f51c5e 100644
--- a/packages/template-retail-react-app/app/components/product-view/index.jsx
+++ b/packages/template-retail-react-app/app/components/product-view/index.jsx
@@ -23,6 +23,7 @@ import {
 } from '@salesforce/retail-react-app/app/components/shared/ui'
 import {useCurrency, useDerivedProduct} from '@salesforce/retail-react-app/app/hooks'
 import {useAddToCartModalContext} from '@salesforce/retail-react-app/app/hooks/use-add-to-cart-modal'
+import {useBonusProductModalContext} from '@salesforce/retail-react-app/app/hooks/use-bonus-product-modal'
 
 // project components
 import ImageGallery from '@salesforce/retail-react-app/app/components/image-gallery'
@@ -131,6 +132,13 @@ const ProductView = forwardRef(
             onOpen: onAddToCartModalOpen,
             onClose: onAddToCartModalClose
         } = useAddToCartModalContext()
+        const {
+            isOpen: isBonusProductModalOpen,
+            onOpen: onBonusProductModalOpen,
+            onClose: onBonusProductModalClose,
+            bonusProducts,
+            addBonusProducts
+        } = useBonusProductModalContext()
         const theme = useTheme()
         const [showOptionsMessage, toggleShowOptionsMessage] = useState(false)
         const {
@@ -272,16 +280,39 @@ const ProductView = forwardRef(
                     return
                 }
                 try {
-                    const itemsAdded = await addToCart(variant, quantity)
-                    // Open modal only when `addToCart` returns some data
-                    // It's possible that the item has been added to cart, but we don't want to open the modal.
-                    // See wishlist_primary_action for example.
+                    const addToCartResponse = await addToCart(variant, quantity)
+                    const itemsAdded = addToCartResponse?.productSelectionValues
+
+                    // Compare existing bonus products with new bonus discount line items
+                    const newBonusItems =
+                        addToCartResponse?.bonusDiscountLineItems?.filter(
+                            (newItem) =>
+                                !bonusProducts.some(
+                                    (existingItem) => existingItem.id === newItem.id
+                                )
+                        ) || []
+
                     if (itemsAdded) {
-                        onAddToCartModalOpen({
-                            product,
-                            itemsAdded,
-                            selectedQuantity: quantity
-                        })
+                        // Show bonus product modal first if there are bonus items
+                        if (newBonusItems?.length > 0) {
+                            // Modify this logic and update bonusProducts list in localStorage with the new bonus items
+                            // that are added to the cart
+                            addBonusProducts(newBonusItems)
+                            onBonusProductModalOpen({
+                                newBonusItems,
+                                allBonusItems: addToCartResponse.bonusDiscountLineItems,
+                                product,
+                                itemsAdded,
+                                selectedQuantity: quantity
+                            })
+                        } else {
+                            // If no bonus items, just show add to cart modal
+                            onAddToCartModalOpen({
+                                product,
+                                itemsAdded,
+                                selectedQuantity: quantity
+                            })
+                        }
                     }
                 } catch (e) {
                     showError()
@@ -366,6 +397,12 @@ const ProductView = forwardRef(
             }
         }, [location.pathname])
 
+        useEffect(() => {
+            if (isBonusProductModalOpen) {
+                onBonusProductModalClose()
+            }
+        }, [location.pathname])
+
         useEffect(() => {
             if (
                 !isProductASet &&
diff --git a/packages/template-retail-react-app/app/hooks/use-bonus-product-modal.js b/packages/template-retail-react-app/app/hooks/use-bonus-product-modal.js
new file mode 100644
index 0000000000..48a7201b8a
--- /dev/null
+++ b/packages/template-retail-react-app/app/hooks/use-bonus-product-modal.js
@@ -0,0 +1,139 @@
+/*
+ * Copyright (c) 2025, Salesforce, Inc.
+ * All rights reserved.
+ * SPDX-License-Identifier: BSD-3-Clause
+ * For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/BSD-3-Clause
+ */
+import React, {useContext, useState, useEffect} from 'react'
+import {useLocation} from 'react-router-dom'
+import {
+    Modal,
+    ModalCloseButton,
+    ModalContent,
+    ModalOverlay,
+    useBreakpointValue,
+    ModalHeader,
+    ModalBody,
+    Heading
+} from '@salesforce/retail-react-app/app/components/shared/ui'
+import {useAddToCartModalContext} from '@salesforce/retail-react-app/app/hooks/use-add-to-cart-modal'
+import {isServer} from '@salesforce/retail-react-app/app/utils/utils'
+import PropTypes from 'prop-types'
+
+export const BonusProductModalContext = React.createContext()
+
+export const useBonusProductModalContext = () => useContext(BonusProductModalContext)
+
+export const BonusProductModalProvider = ({children}) => {
+    const bonusProductState = useBonusState()
+
+    return (
+        <BonusProductModalContext.Provider value={bonusProductState}>
+            {children}
+            <BonusProductModal />
+        </BonusProductModalContext.Provider>
+    )
+}
+BonusProductModalProvider.propTypes = {
+    children: PropTypes.node.isRequired
+}
+
+export const BonusProductModal = () => {
+    const {isOpen, data, onClose, onOpen} = useBonusProductModalContext()
+    const size = useBreakpointValue({base: 'full', lg: '2xl', xl: '4xl'})
+
+    if (!isOpen) {
+        return null
+    }
+    return (
+        <Modal size={size} isOpen={isOpen} onClose={onClose} scrollBehavior="inside" isCentered>
+            <ModalOverlay />
+            <ModalContent
+                margin="0"
+                borderRadius={{base: 'none', md: 'base'}}
+                bgColor="gray.50"
+                containerProps={{'data-testid': 'bonus-product-modal'}}
+            >
+                <ModalHeader paddingY="8" bgColor="white">
+                    <Heading as="h1" fontSize="2xl"></Heading>
+                </ModalHeader>
+                <ModalCloseButton />
+                {/* Add your modal content here */}
+                <ModalBody bgColor="white" padding="0" marginBottom={{base: 40, lg: 0}}></ModalBody>
+            </ModalContent>
+        </Modal>
+    )
+}
+
+export const useBonusState = () => {
+    const [state, setState] = useState({
+        isOpen: false,
+        data: {},
+        bonusProducts: !isServer ? JSON.parse(localStorage.getItem('bonusProducts') || '[]') : []
+    })
+    const {pathname} = useLocation()
+    const {onOpen: onAddToCartModalOpen} = useAddToCartModalContext()
+
+    useEffect(() => {
+        if (state.isOpen) {
+            setState((prev) => ({
+                ...prev,
+                isOpen: false
+            }))
+        }
+    }, [pathname])
+
+    const addBonusProducts = (newBonusItems) => {
+        setState((prev) => {
+            const updatedBonusProducts = [...prev.bonusProducts, ...newBonusItems]
+            // Store in localStorage only in browser environment
+            if (!isServer) {
+                localStorage.setItem('bonusProducts', JSON.stringify(updatedBonusProducts))
+            }
+            return {
+                ...prev,
+                bonusProducts: updatedBonusProducts
+            }
+        })
+    }
+
+    const clearBonusProducts = () => {
+        setState((prev) => ({
+            ...prev,
+            bonusProducts: []
+        }))
+        if (!isServer) {
+            localStorage.removeItem('bonusProducts')
+        }
+    }
+
+    return {
+        isOpen: state.isOpen,
+        data: state.data,
+        bonusProducts: state.bonusProducts,
+        addBonusProducts,
+        clearBonusProducts,
+        onClose: () => {
+            setState((prev) => ({
+                ...prev,
+                isOpen: false,
+                data: {}
+            }))
+            // Show AddToCartModal after BonusProductModal is closed
+            if (state.data.product) {
+                onAddToCartModalOpen({
+                    product: state.data.product,
+                    itemsAdded: state.data.itemsAdded,
+                    selectedQuantity: state.data.selectedQuantity
+                })
+            }
+        },
+        onOpen: (data) => {
+            setState((prev) => ({
+                ...prev,
+                isOpen: true,
+                data
+            }))
+        }
+    }
+}
diff --git a/packages/template-retail-react-app/app/hooks/use-bonus-product-modal.test.js b/packages/template-retail-react-app/app/hooks/use-bonus-product-modal.test.js
new file mode 100644
index 0000000000..49ef212f15
--- /dev/null
+++ b/packages/template-retail-react-app/app/hooks/use-bonus-product-modal.test.js
@@ -0,0 +1,145 @@
+/*
+ * Copyright (c) 2025, Salesforce, Inc.
+ * All rights reserved.
+ * SPDX-License-Identifier: BSD-3-Clause
+ * For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/BSD-3-Clause
+ */
+import React from 'react'
+import {renderHook, act} from '@testing-library/react'
+import {
+    useBonusState,
+    BonusProductModalProvider,
+    useBonusProductModalContext
+} from './use-bonus-product-modal'
+import {useAddToCartModalContext} from './use-add-to-cart-modal'
+import {useLocation} from 'react-router-dom'
+
+// Mock the dependencies
+jest.mock('react-router-dom', () => ({
+    useLocation: jest.fn()
+}))
+
+jest.mock('./use-add-to-cart-modal', () => ({
+    useAddToCartModalContext: jest.fn()
+}))
+
+// Mock localStorage
+const localStorageMock = (() => {
+    let store = {}
+    return {
+        getItem: jest.fn((key) => store[key]),
+        setItem: jest.fn((key, value) => {
+            store[key] = value
+        }),
+        removeItem: jest.fn((key) => {
+            delete store[key]
+        }),
+        clear: jest.fn(() => {
+            store = {}
+        })
+    }
+})()
+
+Object.defineProperty(window, 'localStorage', {
+    value: localStorageMock
+})
+
+describe('useBonusState', () => {
+    beforeEach(() => {
+        // Reset all mocks before each test
+        jest.clearAllMocks()
+        localStorageMock.clear()
+        useLocation.mockReturnValue({pathname: '/'})
+        useAddToCartModalContext.mockReturnValue({
+            onOpen: jest.fn()
+        })
+    })
+
+    it('should initialize with empty state', () => {
+        const {result} = renderHook(() => useBonusState())
+
+        expect(result.current.isOpen).toBe(false)
+        expect(result.current.data).toEqual({})
+        expect(result.current.bonusProducts).toEqual([])
+    })
+
+    it('should load products from localStorage on initialization', () => {
+        const mockProducts = [{id: 1, name: 'Product 1'}]
+        localStorageMock.setItem('bonusProducts', JSON.stringify(mockProducts))
+
+        const {result} = renderHook(() => useBonusState())
+
+        expect(result.current.bonusProducts).toEqual(mockProducts)
+    })
+
+    it('should add products and update localStorage', () => {
+        const {result} = renderHook(() => useBonusState())
+        const newProducts = [{id: 2, name: 'Product 2'}]
+
+        act(() => {
+            result.current.addBonusProducts(newProducts)
+        })
+
+        expect(result.current.bonusProducts).toEqual(newProducts)
+        expect(localStorageMock.setItem).toHaveBeenCalledWith(
+            'bonusProducts',
+            JSON.stringify(newProducts)
+        )
+    })
+
+    it('should clear products and remove from localStorage', () => {
+        const {result} = renderHook(() => useBonusState())
+
+        // First add some products
+        act(() => {
+            result.current.addBonusProducts([{id: 1, name: 'Product 1'}])
+        })
+
+        // Then clear them
+        act(() => {
+            result.current.clearBonusProducts()
+        })
+
+        expect(result.current.bonusProducts).toEqual([])
+        expect(localStorageMock.removeItem).toHaveBeenCalledWith('bonusProducts')
+    })
+
+    it('should handle modal open/close state', () => {
+        const {result} = renderHook(() => useBonusState())
+        const modalData = {product: {id: 1}, itemsAdded: 1, selectedQuantity: 1}
+
+        act(() => {
+            result.current.onOpen(modalData)
+        })
+
+        expect(result.current.isOpen).toBe(true)
+        expect(result.current.data).toEqual(modalData)
+
+        act(() => {
+            result.current.onClose()
+        })
+
+        expect(result.current.isOpen).toBe(false)
+        expect(result.current.data).toEqual({})
+    })
+
+    it('should close modal and open add to cart modal when closing with product data', () => {
+        const mockOnAddToCartModalOpen = jest.fn()
+        useAddToCartModalContext.mockReturnValue({
+            onOpen: mockOnAddToCartModalOpen
+        })
+
+        const {result} = renderHook(() => useBonusState())
+        const modalData = {product: {id: 1}, itemsAdded: 1, selectedQuantity: 1}
+
+        act(() => {
+            result.current.onOpen(modalData)
+        })
+
+        act(() => {
+            result.current.onClose()
+        })
+
+        expect(mockOnAddToCartModalOpen).toHaveBeenCalledWith(modalData)
+    })
+})
diff --git a/packages/template-retail-react-app/app/pages/checkout/index.jsx b/packages/template-retail-react-app/app/pages/checkout/index.jsx
index fa4e8303a2..4ad5113bf6 100644
--- a/packages/template-retail-react-app/app/pages/checkout/index.jsx
+++ b/packages/template-retail-react-app/app/pages/checkout/index.jsx
@@ -38,6 +38,7 @@ import {
 import {useToast} from '@salesforce/retail-react-app/app/hooks/use-toast'
 import LoadingSpinner from '@salesforce/retail-react-app/app/components/loading-spinner'
 import {getConfig} from '@salesforce/pwa-kit-runtime/utils/ssr-config'
+import {useBonusProductModalContext} from '@salesforce/retail-react-app/app/hooks/use-bonus-product-modal'
 
 const Checkout = () => {
     const {formatMessage} = useIntl()
@@ -51,6 +52,7 @@ const Checkout = () => {
     const idps = social?.idps
     const isSocialEnabled = !!social?.enabled
     const isPasswordlessEnabled = !!passwordless?.enabled
+    const {clearBonusProducts} = useBonusProductModalContext()
 
     useEffect(() => {
         if (error || step === 4) {
@@ -64,6 +66,7 @@ const Checkout = () => {
             const order = await createOrder({
                 body: {basketId: basket.basketId}
             })
+            clearBonusProducts()
             navigate(`/checkout/confirmation/${order.orderNo}`)
         } catch (error) {
             const message = formatMessage({
diff --git a/packages/template-retail-react-app/app/pages/product-detail/index.jsx b/packages/template-retail-react-app/app/pages/product-detail/index.jsx
index 0a64b4129b..2f715b4f2a 100644
--- a/packages/template-retail-react-app/app/pages/product-detail/index.jsx
+++ b/packages/template-retail-react-app/app/pages/product-detail/index.jsx
@@ -302,13 +302,16 @@ const ProductDetail = () => {
                 quantity
             }))
 
-            await addItemToNewOrExistingBasket(productItems)
+            const response = await addItemToNewOrExistingBasket(productItems)
 
             einstein.sendAddToCart(productItems)
 
             // If the items were successfully added, set the return value to be used
             // by the add to cart modal.
-            return productSelectionValues
+            return {
+                ...response,
+                productSelectionValues
+            }
         } catch (error) {
             console.log('error', error)
             showError(error)

From 790a72b04cd1d937c5ab41274ae3dce4a859c552 Mon Sep 17 00:00:00 2001
From: madhuri-uppu <madhuri.uppu@salesforce.com>
Date: Mon, 9 Jun 2025 14:53:01 -0700
Subject: [PATCH 02/44] skip changelog


From c2021fa8fbccfa6a274b1fe2bf56a756a1d1a4c1 Mon Sep 17 00:00:00 2001
From: madhuri-uppu <madhuri.uppu@salesforce.com>
Date: Mon, 9 Jun 2025 14:59:56 -0700
Subject: [PATCH 03/44] skip changelog


From 0aadd8b9caa22c66d9a1bc65373bf50615116c9e Mon Sep 17 00:00:00 2001
From: madhuri-uppu <madhuri.uppu@salesforce.com>
Date: Mon, 9 Jun 2025 16:21:11 -0700
Subject: [PATCH 04/44] fixed import issue

---
 .../app/hooks/use-bonus-product-modal.test.js             | 8 ++------
 1 file changed, 2 insertions(+), 6 deletions(-)

diff --git a/packages/template-retail-react-app/app/hooks/use-bonus-product-modal.test.js b/packages/template-retail-react-app/app/hooks/use-bonus-product-modal.test.js
index 49ef212f15..4f26795ed7 100644
--- a/packages/template-retail-react-app/app/hooks/use-bonus-product-modal.test.js
+++ b/packages/template-retail-react-app/app/hooks/use-bonus-product-modal.test.js
@@ -6,12 +6,8 @@
  */
 import React from 'react'
 import {renderHook, act} from '@testing-library/react'
-import {
-    useBonusState,
-    BonusProductModalProvider,
-    useBonusProductModalContext
-} from './use-bonus-product-modal'
-import {useAddToCartModalContext} from './use-add-to-cart-modal'
+import {useBonusState} from '@salesforce/retail-react-app/app/hooks/use-bonus-product-modal'
+import {useAddToCartModalContext} from '@salesforce/retail-react-app/app/hooks/use-add-to-cart-modal'
 import {useLocation} from 'react-router-dom'
 
 // Mock the dependencies

From 69d49b278f3cee4c23d9b271c2089f99210843c0 Mon Sep 17 00:00:00 2001
From: daniel-diaz <daniel.diaz@salesforce.com>
Date: Tue, 10 Jun 2025 13:02:37 -0400
Subject: [PATCH 05/44] Added bonus products on the cart page

---
 .../app/components/product-item/index.jsx     | 147 +++++++++-------
 .../app/components/product-item/index.test.js |  58 +++++-
 .../app/pages/cart/index.jsx                  | 165 +++++++++++++-----
 .../app/pages/cart/index.test.js              |  80 +++++++++
 .../cart/partials/bonus-products-title.jsx    |  28 +++
 .../static/translations/compiled/en-GB.json   |  58 ++++++
 .../static/translations/compiled/en-US.json   |  58 ++++++
 .../static/translations/compiled/en-XA.json   |  74 ++++++++
 .../translations/en-GB.json                   |   6 +
 .../translations/en-US.json                   |   6 +
 10 files changed, 563 insertions(+), 117 deletions(-)
 create mode 100644 packages/template-retail-react-app/app/pages/cart/partials/bonus-products-title.jsx

diff --git a/packages/template-retail-react-app/app/components/product-item/index.jsx b/packages/template-retail-react-app/app/components/product-item/index.jsx
index 4314d476a0..44a9606ca8 100644
--- a/packages/template-retail-react-app/app/components/product-item/index.jsx
+++ b/packages/template-retail-react-app/app/components/product-item/index.jsx
@@ -80,67 +80,94 @@ const ProductItem = ({
 
                             <Flex align="flex-end" justify="space-between">
                                 <Stack spacing={1}>
-                                    <Text
-                                        fontSize="sm"
-                                        color="gray.700"
-                                        aria-label={intl.formatMessage(
-                                            {
-                                                id: 'item_variant.quantity.label',
-                                                defaultMessage:
-                                                    'Quantity selector for {productName}. Selected quantity is {quantity}'
-                                            },
-                                            {
-                                                quantity: product?.quantity,
-                                                productName: product?.name
-                                            }
-                                        )}
-                                    >
-                                        <FormattedMessage
-                                            defaultMessage="Quantity:"
-                                            id="product_item.label.quantity"
-                                        />
-                                    </Text>
-                                    <QuantityPicker
-                                        step={stepQuantity}
-                                        value={quantity}
-                                        min={0}
-                                        clampValueOnBlur={false}
-                                        onBlur={(e) => {
-                                            // Default to last known quantity if a user leaves the box with an invalid value
-                                            const {value} = e.target
+                                    {product.bonusProductLineItem ? (
+                                        <Text
+                                            fontSize="sm"
+                                            color="gray.700"
+                                            aria-label={intl.formatMessage(
+                                                {
+                                                    id: 'item_variant.assistive_msg.quantity',
+                                                    defaultMessage: 'Quantity {quantity}'
+                                                },
+                                                {
+                                                    quantity: product?.quantity
+                                                }
+                                            )}
+                                        >
+                                            <FormattedMessage
+                                                defaultMessage="Quantity: {quantity}"
+                                                id="bonusproduct_item.label.quantity"
+                                                values={{
+                                                    quantity: product.quantity
+                                                }}
+                                            />
+                                        </Text>
+                                    ) : (
+                                        <>
+                                            <Text
+                                                fontSize="sm"
+                                                color="gray.700"
+                                                aria-label={intl.formatMessage(
+                                                    {
+                                                        id: 'item_variant.quantity.label',
+                                                        defaultMessage:
+                                                            'Quantity selector for {productName}. Selected quantity is {quantity}'
+                                                    },
+                                                    {
+                                                        quantity: product?.quantity,
+                                                        productName: product?.name
+                                                    }
+                                                )}
+                                            >
+                                                <FormattedMessage
+                                                    defaultMessage="Quantity:"
+                                                    id="product_item.label.quantity"
+                                                />
+                                            </Text>
+                                            <QuantityPicker
+                                                step={stepQuantity}
+                                                value={quantity}
+                                                min={0}
+                                                clampValueOnBlur={false}
+                                                onBlur={(e) => {
+                                                    // Default to last known quantity if a user leaves the box with an invalid value
+                                                    const {value} = e.target
 
-                                            if (!value) {
-                                                setQuantity(product.quantity)
-                                            }
-                                        }}
-                                        onChange={(stringValue, numberValue) => {
-                                            // Set the Quantity of product to value of input if value number
-                                            if (numberValue >= 0) {
-                                                // Call handler
-                                                onItemQuantityChange(numberValue).then(
-                                                    (isValidChange) =>
-                                                        isValidChange && setQuantity(numberValue)
-                                                )
-                                            } else if (stringValue === '') {
-                                                // We want to allow the use to clear the input to start a new input so here we set the quantity to '' so NAN is not displayed
-                                                // User will not be able to add '' quantity to the cart due to the add to cart button enablement rules
-                                                setQuantity(stringValue)
-                                            }
-                                        }}
-                                        productName={product?.name}
-                                    />
-                                    <VisuallyHidden role="status">
-                                        {product?.name}
-                                        {intl.formatMessage(
-                                            {
-                                                id: 'item_variant.assistive_msg.quantity',
-                                                defaultMessage: 'Quantity {quantity}'
-                                            },
-                                            {
-                                                quantity: product?.quantity
-                                            }
-                                        )}
-                                    </VisuallyHidden>
+                                                    if (!value) {
+                                                        setQuantity(product.quantity)
+                                                    }
+                                                }}
+                                                onChange={(stringValue, numberValue) => {
+                                                    // Set the Quantity of product to value of input if value number
+                                                    if (numberValue >= 0) {
+                                                        // Call handler
+                                                        onItemQuantityChange(numberValue).then(
+                                                            (isValidChange) =>
+                                                                isValidChange &&
+                                                                setQuantity(numberValue)
+                                                        )
+                                                    } else if (stringValue === '') {
+                                                        // We want to allow the use to clear the input to start a new input so here we set the quantity to '' so NAN is not displayed
+                                                        // User will not be able to add '' quantity to the cart due to the add to cart button enablement rules
+                                                        setQuantity(stringValue)
+                                                    }
+                                                }}
+                                                productName={product?.name}
+                                            />
+                                            <VisuallyHidden role="status">
+                                                {product?.name}
+                                                {intl.formatMessage(
+                                                    {
+                                                        id: 'item_variant.assistive_msg.quantity',
+                                                        defaultMessage: 'Quantity {quantity}'
+                                                    },
+                                                    {
+                                                        quantity: product?.quantity
+                                                    }
+                                                )}
+                                            </VisuallyHidden>
+                                        </>
+                                    )}
                                 </Stack>
                                 <Stack>
                                     <HideOnMobile>
diff --git a/packages/template-retail-react-app/app/components/product-item/index.test.js b/packages/template-retail-react-app/app/components/product-item/index.test.js
index b67a3fe2e2..d1e97f5603 100644
--- a/packages/template-retail-react-app/app/components/product-item/index.test.js
+++ b/packages/template-retail-react-app/app/components/product-item/index.test.js
@@ -9,6 +9,7 @@ import ProductItem from '@salesforce/retail-react-app/app/components/product-ite
 import {mockedCustomerProductListsDetails} from '@salesforce/retail-react-app/app/mocks/mock-data'
 import {renderWithProviders} from '@salesforce/retail-react-app/app/utils/test-utils'
 import {screen} from '@testing-library/react'
+import PropTypes from 'prop-types'
 
 jest.mock('@salesforce/commerce-sdk-react', () => {
     const originalModule = jest.requireActual('@salesforce/commerce-sdk-react')
@@ -24,16 +25,55 @@ beforeEach(() => {
 })
 
 jest.setTimeout(60000)
-const MockedComponent = () => {
-    const product = mockedCustomerProductListsDetails.data[0]
-    return <ProductItem product={{...product, productName: product.name}} />
+
+const mockProduct = {
+    ...mockedCustomerProductListsDetails.data[0],
+    productName: mockedCustomerProductListsDetails.data[0].name,
+    bonusProductLineItem: false,
+    quantity: 1
+}
+
+const mockBonusProduct = {
+    ...mockProduct,
+    bonusProductLineItem: true
+}
+
+const MockedComponent = ({
+    product = mockProduct,
+    onItemQuantityChange = async () => {},
+    showLoading = false
+}) => {
+    return (
+        <ProductItem
+            product={product}
+            onItemQuantityChange={onItemQuantityChange}
+            showLoading={showLoading}
+            primaryAction={<button>Primary Action</button>}
+            secondaryActions={<button>Secondary Action</button>}
+        />
+    )
 }
 
-test('renders product item name, attributes and price', async () => {
-    renderWithProviders(<MockedComponent />)
+MockedComponent.propTypes = {
+    product: PropTypes.object,
+    onItemQuantityChange: PropTypes.func,
+    showLoading: PropTypes.bool
+}
+
+describe('ProductItem Component', () => {
+    test('renders product item name, attributes, price and quantity picker', async () => {
+        renderWithProviders(<MockedComponent />)
+
+        expect(await screen.getByText(/apple ipod nano$/i)).toBeInTheDocument()
+        expect(await screen.getByText(/color: green/i)).toBeInTheDocument()
+        expect(await screen.getByText(/memory size: 16 GB$/i)).toBeInTheDocument()
+        expect(screen.queryByRole('spinbutton')).toBeInTheDocument()
+    })
+
+    test('renders bonus product without quantity picker', () => {
+        renderWithProviders(<MockedComponent product={mockBonusProduct} />)
 
-    // look for the element that has sole product name
-    expect(await screen.getByText(/apple ipod nano$/i)).toBeInTheDocument()
-    expect(await screen.getByText(/color: green/i)).toBeInTheDocument()
-    expect(await screen.getByText(/memory size: 16 GB$/i)).toBeInTheDocument()
+        expect(screen.getByText(/quantity: 1$/i)).toBeInTheDocument()
+        expect(screen.queryByRole('spinbutton')).not.toBeInTheDocument()
+    })
 })
diff --git a/packages/template-retail-react-app/app/pages/cart/index.jsx b/packages/template-retail-react-app/app/pages/cart/index.jsx
index af29588766..6603e95e44 100644
--- a/packages/template-retail-react-app/app/pages/cart/index.jsx
+++ b/packages/template-retail-react-app/app/pages/cart/index.jsx
@@ -15,7 +15,8 @@ import {
     GridItem,
     Container,
     useDisclosure,
-    Button
+    Button,
+    Heading
 } from '@salesforce/retail-react-app/app/components/shared/ui'
 
 // Project Components
@@ -23,6 +24,7 @@ import CartCta from '@salesforce/retail-react-app/app/pages/cart/partials/cart-c
 import CartSecondaryButtonGroup from '@salesforce/retail-react-app/app/pages/cart/partials/cart-secondary-button-group'
 import CartSkeleton from '@salesforce/retail-react-app/app/pages/cart/partials/cart-skeleton'
 import CartTitle from '@salesforce/retail-react-app/app/pages/cart/partials/cart-title'
+import BonusProductsTitle from '@salesforce/retail-react-app/app/pages/cart/partials/bonus-products-title'
 import ConfirmationModal from '@salesforce/retail-react-app/app/components/confirmation-modal'
 import EmptyCart from '@salesforce/retail-react-app/app/pages/cart/partials/empty-cart'
 import OrderSummary from '@salesforce/retail-react-app/app/components/order-summary'
@@ -541,53 +543,120 @@ const Cart = () => {
                         >
                             <GridItem>
                                 <Stack spacing={4}>
-                                    {basket.productItems?.map((productItem, idx) => {
-                                        return (
-                                            <ProductItem
-                                                key={productItem.itemId}
-                                                index={idx}
-                                                secondaryActions={
-                                                    <CartSecondaryButtonGroup
-                                                        isAGift={
-                                                            localIsGiftItems[productItem.itemId]
-                                                                ? localIsGiftItems[
-                                                                      productItem.itemId
-                                                                  ]
-                                                                : productItem.gift
-                                                        }
-                                                        onIsAGiftChange={handleIsAGiftChange}
-                                                        onAddToWishlistClick={handleAddToWishlist}
-                                                        onEditClick={(product) => {
-                                                            setSelectedItem(product)
-                                                            onOpen()
-                                                        }}
-                                                        onRemoveItemClick={handleRemoveItem}
-                                                    />
-                                                }
-                                                product={{
-                                                    ...productItem,
-                                                    ...(productsByItemId &&
-                                                        productsByItemId[productItem.itemId]),
-                                                    isProductUnavailable: !isProductsLoading
-                                                        ? !productsByItemId?.[productItem.itemId]
-                                                        : undefined,
-                                                    price: productItem.price,
-                                                    quantity: localQuantity[productItem.itemId]
-                                                        ? localQuantity[productItem.itemId]
-                                                        : productItem.quantity
-                                                }}
-                                                onItemQuantityChange={handleChangeItemQuantity.bind(
-                                                    this,
-                                                    productItem
-                                                )}
-                                                showLoading={
-                                                    isCartItemLoading &&
-                                                    selectedItem?.itemId === productItem.itemId
-                                                }
-                                                handleRemoveItem={handleRemoveItem}
-                                            />
-                                        )
-                                    })}
+                                    {/* Regular Products */}
+                                    {basket.productItems
+                                        ?.filter((item) => !item.bonusProductLineItem)
+                                        .map((productItem, idx) => {
+                                            return (
+                                                <ProductItem
+                                                    key={productItem.itemId}
+                                                    index={idx}
+                                                    secondaryActions={
+                                                        <CartSecondaryButtonGroup
+                                                            isAGift={
+                                                                localIsGiftItems[productItem.itemId]
+                                                                    ? localIsGiftItems[
+                                                                          productItem.itemId
+                                                                      ]
+                                                                    : productItem.gift
+                                                            }
+                                                            onIsAGiftChange={handleIsAGiftChange}
+                                                            onAddToWishlistClick={
+                                                                handleAddToWishlist
+                                                            }
+                                                            onEditClick={(product) => {
+                                                                setSelectedItem(product)
+                                                                onOpen()
+                                                            }}
+                                                            onRemoveItemClick={handleRemoveItem}
+                                                        />
+                                                    }
+                                                    product={{
+                                                        ...productItem,
+                                                        ...(productsByItemId &&
+                                                            productsByItemId[productItem.itemId]),
+                                                        isProductUnavailable: !isProductsLoading
+                                                            ? !productsByItemId?.[
+                                                                  productItem.itemId
+                                                              ]
+                                                            : undefined,
+                                                        price: productItem.price,
+                                                        quantity: localQuantity[productItem.itemId]
+                                                            ? localQuantity[productItem.itemId]
+                                                            : productItem.quantity
+                                                    }}
+                                                    onItemQuantityChange={handleChangeItemQuantity.bind(
+                                                        this,
+                                                        productItem
+                                                    )}
+                                                    showLoading={
+                                                        isCartItemLoading &&
+                                                        selectedItem?.itemId === productItem.itemId
+                                                    }
+                                                    handleRemoveItem={handleRemoveItem}
+                                                />
+                                            )
+                                        })}
+
+                                    {/* Bonus Products Title */}
+                                    {basket.productItems?.some(
+                                        (item) => item.bonusProductLineItem === true
+                                    ) && (
+                                        <Box>
+                                            <BonusProductsTitle />
+                                        </Box>
+                                    )}
+
+                                    {/* Bonus Products */}
+                                    {basket.productItems
+                                        ?.filter((item) => item.bonusProductLineItem === true)
+                                        .map((productItem, idx) => {
+                                            return (
+                                                <ProductItem
+                                                    key={productItem.itemId}
+                                                    index={idx}
+                                                    secondaryActions={
+                                                        <CartSecondaryButtonGroup
+                                                            isAGift={
+                                                                localIsGiftItems[productItem.itemId]
+                                                                    ? localIsGiftItems[
+                                                                          productItem.itemId
+                                                                      ]
+                                                                    : productItem.gift
+                                                            }
+                                                            onIsAGiftChange={handleIsAGiftChange}
+                                                            onAddToWishlistClick={
+                                                                handleAddToWishlist
+                                                            }
+                                                            onEditClick={(product) => {
+                                                                setSelectedItem(product)
+                                                                onOpen()
+                                                            }}
+                                                            onRemoveItemClick={handleRemoveItem}
+                                                        />
+                                                    }
+                                                    product={{
+                                                        ...productItem,
+                                                        ...(productsByItemId &&
+                                                            productsByItemId[productItem.itemId]),
+                                                        isProductUnavailable: !isProductsLoading
+                                                            ? !productsByItemId?.[
+                                                                  productItem.itemId
+                                                              ]
+                                                            : undefined,
+                                                        price: productItem.price,
+                                                        quantity: localQuantity[productItem.itemId]
+                                                            ? localQuantity[productItem.itemId]
+                                                            : productItem.quantity
+                                                    }}
+                                                    showLoading={
+                                                        isCartItemLoading &&
+                                                        selectedItem?.itemId === productItem.itemId
+                                                    }
+                                                    handleRemoveItem={handleRemoveItem}
+                                                />
+                                            )
+                                        })}
                                 </Stack>
                                 <Box>
                                     {isOpen && !selectedItem.bundledProductItems && (
diff --git a/packages/template-retail-react-app/app/pages/cart/index.test.js b/packages/template-retail-react-app/app/pages/cart/index.test.js
index 1476ca7e71..a0ac52e576 100644
--- a/packages/template-retail-react-app/app/pages/cart/index.test.js
+++ b/packages/template-retail-react-app/app/pages/cart/index.test.js
@@ -68,6 +68,55 @@ const mockProductBundleBasket = {
     total: 1
 }
 
+const mockBonusProductBasket = {
+    baskets: [
+        {
+            ...mockCustomerBaskets.baskets[0],
+            productItems: [
+                {
+                    adjustedTax: 2.93,
+                    basePrice: 61.43,
+                    bonusProductLineItem: false,
+                    gift: false,
+                    itemId: '4a9af0a24fe46c3f6d8721b371',
+                    itemText: 'Belted Cardigan With Studs',
+                    price: 61.43,
+                    priceAfterItemDiscount: 61.43,
+                    priceAfterOrderDiscount: 61.43,
+                    productId: '701642889830M',
+                    productName: 'Belted Cardigan With Studs',
+                    quantity: 2,
+                    shipmentId: 'me',
+                    tax: 2.93,
+                    taxBasis: 61.43,
+                    taxClassId: 'standard',
+                    taxRate: 0.05
+                },
+                {
+                    adjustedTax: 0,
+                    basePrice: 0,
+                    bonusProductLineItem: true,
+                    gift: false,
+                    itemId: '5b1a03848f0807f99f37ea93e4',
+                    itemText: 'Free Gift with Purchase',
+                    price: 0,
+                    priceAfterItemDiscount: 0,
+                    priceAfterOrderDiscount: 0,
+                    productId: '013742335262M',
+                    productName: 'Free Gift with Purchase',
+                    quantity: 1,
+                    shipmentId: 'me',
+                    tax: 0,
+                    taxBasis: 0,
+                    taxClassId: 'standard',
+                    taxRate: 0.05
+                }
+            ]
+        }
+    ],
+    total: 1
+}
+
 // Set up and clean up
 beforeEach(() => {
     global.server.use(
@@ -838,6 +887,37 @@ describe('Product bundles', () => {
     })
 })
 
+describe('Bonus products', () => {
+    beforeEach(() => {
+        global.server.use(
+            rest.get('*/customers/:customerId/baskets', (req, res, ctx) =>
+                res(ctx.delay(0), ctx.status(200), ctx.json(mockBonusProductBasket))
+            ),
+            rest.get('*/products', (req, res, ctx) => {
+                return res(ctx.delay(0), ctx.json({data: [mockCartVariant]}))
+            })
+        )
+    })
+
+    test('renders bonus products in cart with correct styling and no quantity picker', async () => {
+        renderWithProviders(<Cart />)
+
+        await waitFor(() => {
+            expect(screen.getByTestId('sf-cart-container')).toBeInTheDocument()
+        })
+
+        const regularProduct = screen.getByTestId('sf-cart-item-701642889830M')
+        const bonusProduct = screen.getByTestId('sf-cart-item-013742335262M')
+
+        expect(regularProduct).toBeInTheDocument()
+        expect(bonusProduct).toBeInTheDocument()
+
+        // Verify bonus product has no quantity picker
+        expect(within(bonusProduct).queryByRole('spinbutton')).not.toBeInTheDocument()
+        expect(within(bonusProduct).getByText('Bonus Product')).toBeInTheDocument()
+    })
+})
+
 describe('Unavailable products tests', function () {
     test('Remove unavailable/out of stock/low stock products from cart', async () => {
         prependHandlersToServer([
diff --git a/packages/template-retail-react-app/app/pages/cart/partials/bonus-products-title.jsx b/packages/template-retail-react-app/app/pages/cart/partials/bonus-products-title.jsx
new file mode 100644
index 0000000000..bfb9c8dc34
--- /dev/null
+++ b/packages/template-retail-react-app/app/pages/cart/partials/bonus-products-title.jsx
@@ -0,0 +1,28 @@
+/*
+ * Copyright (c) 2024, Salesforce, Inc.
+ * All rights reserved.
+ * SPDX-License-Identifier: BSD-3-Clause
+ * For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/BSD-3-Clause
+ */
+import React from 'react'
+import {FormattedMessage} from 'react-intl'
+import {Heading} from '@salesforce/retail-react-app/app/components/shared/ui'
+import {useCurrentBasket} from '@salesforce/retail-react-app/app/hooks/use-current-basket'
+
+const BonusProductsTitle = () => {
+    const {data: basket} = useCurrentBasket()
+    const bonusItemsCount =
+        basket?.productItems?.filter((item) => item.bonusProductLineItem === true).length || 0
+
+    return (
+        <Heading as="h2" fontSize="xl">
+            <FormattedMessage
+                defaultMessage="Bonus Products ({itemCount, plural, =0 {0 items} one {# item} other {# items}})"
+                values={{itemCount: bonusItemsCount}}
+                id="bonus_products_title.title.num_of_items"
+            />
+        </Heading>
+    )
+}
+
+export default BonusProductsTitle
diff --git a/packages/template-retail-react-app/app/static/translations/compiled/en-GB.json b/packages/template-retail-react-app/app/static/translations/compiled/en-GB.json
index 352d183530..8eff508c69 100644
--- a/packages/template-retail-react-app/app/static/translations/compiled/en-GB.json
+++ b/packages/template-retail-react-app/app/static/translations/compiled/en-GB.json
@@ -453,6 +453,64 @@
       "value": "Password Reset"
     }
   ],
+  "bonus_products_title.title.num_of_items": [
+    {
+      "type": 0,
+      "value": "Bonus Products ("
+    },
+    {
+      "offset": 0,
+      "options": {
+        "=0": {
+          "value": [
+            {
+              "type": 0,
+              "value": "0 items"
+            }
+          ]
+        },
+        "one": {
+          "value": [
+            {
+              "type": 7
+            },
+            {
+              "type": 0,
+              "value": " item"
+            }
+          ]
+        },
+        "other": {
+          "value": [
+            {
+              "type": 7
+            },
+            {
+              "type": 0,
+              "value": " items"
+            }
+          ]
+        }
+      },
+      "pluralType": "cardinal",
+      "type": 6,
+      "value": "itemCount"
+    },
+    {
+      "type": 0,
+      "value": ")"
+    }
+  ],
+  "bonusproduct_item.label.quantity": [
+    {
+      "type": 0,
+      "value": "Quantity: "
+    },
+    {
+      "type": 1,
+      "value": "quantity"
+    }
+  ],
   "carousel.button.scroll_left.assistive_msg": [
     {
       "type": 0,
diff --git a/packages/template-retail-react-app/app/static/translations/compiled/en-US.json b/packages/template-retail-react-app/app/static/translations/compiled/en-US.json
index 352d183530..8eff508c69 100644
--- a/packages/template-retail-react-app/app/static/translations/compiled/en-US.json
+++ b/packages/template-retail-react-app/app/static/translations/compiled/en-US.json
@@ -453,6 +453,64 @@
       "value": "Password Reset"
     }
   ],
+  "bonus_products_title.title.num_of_items": [
+    {
+      "type": 0,
+      "value": "Bonus Products ("
+    },
+    {
+      "offset": 0,
+      "options": {
+        "=0": {
+          "value": [
+            {
+              "type": 0,
+              "value": "0 items"
+            }
+          ]
+        },
+        "one": {
+          "value": [
+            {
+              "type": 7
+            },
+            {
+              "type": 0,
+              "value": " item"
+            }
+          ]
+        },
+        "other": {
+          "value": [
+            {
+              "type": 7
+            },
+            {
+              "type": 0,
+              "value": " items"
+            }
+          ]
+        }
+      },
+      "pluralType": "cardinal",
+      "type": 6,
+      "value": "itemCount"
+    },
+    {
+      "type": 0,
+      "value": ")"
+    }
+  ],
+  "bonusproduct_item.label.quantity": [
+    {
+      "type": 0,
+      "value": "Quantity: "
+    },
+    {
+      "type": 1,
+      "value": "quantity"
+    }
+  ],
   "carousel.button.scroll_left.assistive_msg": [
     {
       "type": 0,
diff --git a/packages/template-retail-react-app/app/static/translations/compiled/en-XA.json b/packages/template-retail-react-app/app/static/translations/compiled/en-XA.json
index 75acacecc2..768ad9c36e 100644
--- a/packages/template-retail-react-app/app/static/translations/compiled/en-XA.json
+++ b/packages/template-retail-react-app/app/static/translations/compiled/en-XA.json
@@ -925,6 +925,80 @@
       "value": "]"
     }
   ],
+  "bonus_products_title.title.num_of_items": [
+    {
+      "type": 0,
+      "value": "["
+    },
+    {
+      "type": 0,
+      "value": "Ɓǿǿƞŭŭş Ƥřǿǿḓŭŭƈŧş ("
+    },
+    {
+      "offset": 0,
+      "options": {
+        "=0": {
+          "value": [
+            {
+              "type": 0,
+              "value": "0 īŧḗḗḿş"
+            }
+          ]
+        },
+        "one": {
+          "value": [
+            {
+              "type": 7
+            },
+            {
+              "type": 0,
+              "value": " īŧḗḗḿ"
+            }
+          ]
+        },
+        "other": {
+          "value": [
+            {
+              "type": 7
+            },
+            {
+              "type": 0,
+              "value": " īŧḗḗḿş"
+            }
+          ]
+        }
+      },
+      "pluralType": "cardinal",
+      "type": 6,
+      "value": "itemCount"
+    },
+    {
+      "type": 0,
+      "value": ")"
+    },
+    {
+      "type": 0,
+      "value": "]"
+    }
+  ],
+  "bonusproduct_item.label.quantity": [
+    {
+      "type": 0,
+      "value": "["
+    },
+    {
+      "type": 0,
+      "value": "Ɋŭŭȧȧƞŧīŧẏ: "
+    },
+    {
+      "type": 1,
+      "value": "quantity"
+    },
+    {
+      "type": 0,
+      "value": "]"
+    }
+  ],
   "carousel.button.scroll_left.assistive_msg": [
     {
       "type": 0,
diff --git a/packages/template-retail-react-app/translations/en-GB.json b/packages/template-retail-react-app/translations/en-GB.json
index c6e5c939e7..8d0957a871 100644
--- a/packages/template-retail-react-app/translations/en-GB.json
+++ b/packages/template-retail-react-app/translations/en-GB.json
@@ -177,6 +177,12 @@
   "auth_modal.password_reset_success.title.password_reset": {
     "defaultMessage": "Password Reset"
   },
+  "bonus_products_title.title.num_of_items": {
+    "defaultMessage": "Bonus Products ({itemCount, plural, =0 {0 items} one {# item} other {# items}})"
+  },
+  "bonusproduct_item.label.quantity": {
+    "defaultMessage": "Quantity: {quantity}"
+  },
   "carousel.button.scroll_left.assistive_msg": {
     "defaultMessage": "Scroll carousel left"
   },
diff --git a/packages/template-retail-react-app/translations/en-US.json b/packages/template-retail-react-app/translations/en-US.json
index c6e5c939e7..8d0957a871 100644
--- a/packages/template-retail-react-app/translations/en-US.json
+++ b/packages/template-retail-react-app/translations/en-US.json
@@ -177,6 +177,12 @@
   "auth_modal.password_reset_success.title.password_reset": {
     "defaultMessage": "Password Reset"
   },
+  "bonus_products_title.title.num_of_items": {
+    "defaultMessage": "Bonus Products ({itemCount, plural, =0 {0 items} one {# item} other {# items}})"
+  },
+  "bonusproduct_item.label.quantity": {
+    "defaultMessage": "Quantity: {quantity}"
+  },
   "carousel.button.scroll_left.assistive_msg": {
     "defaultMessage": "Scroll carousel left"
   },

From bfb54b2b087b0134a8f6eb3b63f08a19232868ea Mon Sep 17 00:00:00 2001
From: daniel-diaz <daniel.diaz@salesforce.com>
Date: Tue, 10 Jun 2025 13:06:14 -0400
Subject: [PATCH 06/44] Updated change log

---
 packages/template-retail-react-app/CHANGELOG.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/packages/template-retail-react-app/CHANGELOG.md b/packages/template-retail-react-app/CHANGELOG.md
index e95f90eacf..07422e83ac 100644
--- a/packages/template-retail-react-app/CHANGELOG.md
+++ b/packages/template-retail-react-app/CHANGELOG.md
@@ -3,6 +3,7 @@
 - Improved the layout of product tiles in product scroll and product list [#2446](https://github.com/SalesforceCommerceCloud/pwa-kit/pull/2446)
 - Updated 6 new languagues [#2495](https://github.com/SalesforceCommerceCloud/pwa-kit/pull/2495)
 - Show Bonus Product Label on OrderSummary component [#2524](https://github.com/SalesforceCommerceCloud/pwa-kit/pull/2524)
+- Show Bonus Products on Cart Page [#2547](https://github.com/SalesforceCommerceCloud/pwa-kit/pull/2547)
 
 ## v6.1.0 (May 22, 2025)
 

From a47d9b000c607651a48363a6e7b1d806da9d0dda Mon Sep 17 00:00:00 2001
From: daniel-diaz <daniel.diaz@salesforce.com>
Date: Tue, 10 Jun 2025 13:12:54 -0400
Subject: [PATCH 07/44] Removed unused import

---
 packages/template-retail-react-app/app/pages/cart/index.jsx | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/packages/template-retail-react-app/app/pages/cart/index.jsx b/packages/template-retail-react-app/app/pages/cart/index.jsx
index 6603e95e44..e05e31e5de 100644
--- a/packages/template-retail-react-app/app/pages/cart/index.jsx
+++ b/packages/template-retail-react-app/app/pages/cart/index.jsx
@@ -15,8 +15,7 @@ import {
     GridItem,
     Container,
     useDisclosure,
-    Button,
-    Heading
+    Button
 } from '@salesforce/retail-react-app/app/components/shared/ui'
 
 // Project Components

From c693beab09de4443633a8c7878abc997abf25ef8 Mon Sep 17 00:00:00 2001
From: daniel-diaz <daniel.diaz@salesforce.com>
Date: Tue, 10 Jun 2025 13:50:22 -0400
Subject: [PATCH 08/44] Updated cart secondary buttons remove is gift and
 wishlist for bonus products

---
 .../app/pages/cart/index.jsx                  | 14 +----
 .../partials/cart-secondary-button-group.jsx  | 55 ++++++++++---------
 .../cart-secondary-button-group.test.js       | 25 +++++++--
 3 files changed, 51 insertions(+), 43 deletions(-)

diff --git a/packages/template-retail-react-app/app/pages/cart/index.jsx b/packages/template-retail-react-app/app/pages/cart/index.jsx
index e05e31e5de..f3ddf6371a 100644
--- a/packages/template-retail-react-app/app/pages/cart/index.jsx
+++ b/packages/template-retail-react-app/app/pages/cart/index.jsx
@@ -6,8 +6,7 @@
  */
 import React, {useState, useMemo} from 'react'
 import {FormattedMessage, useIntl} from 'react-intl'
-
-// Chakra Components
+ƒ
 import {
     Box,
     Stack,
@@ -616,17 +615,6 @@ const Cart = () => {
                                                     index={idx}
                                                     secondaryActions={
                                                         <CartSecondaryButtonGroup
-                                                            isAGift={
-                                                                localIsGiftItems[productItem.itemId]
-                                                                    ? localIsGiftItems[
-                                                                          productItem.itemId
-                                                                      ]
-                                                                    : productItem.gift
-                                                            }
-                                                            onIsAGiftChange={handleIsAGiftChange}
-                                                            onAddToWishlistClick={
-                                                                handleAddToWishlist
-                                                            }
                                                             onEditClick={(product) => {
                                                                 setSelectedItem(product)
                                                                 onOpen()
diff --git a/packages/template-retail-react-app/app/pages/cart/partials/cart-secondary-button-group.jsx b/packages/template-retail-react-app/app/pages/cart/partials/cart-secondary-button-group.jsx
index 22e85b6a23..bf83edb327 100644
--- a/packages/template-retail-react-app/app/pages/cart/partials/cart-secondary-button-group.jsx
+++ b/packages/template-retail-react-app/app/pages/cart/partials/cart-secondary-button-group.jsx
@@ -62,6 +62,7 @@ const CartSecondaryButtonGroup = ({
     isAGift = false
 }) => {
     const variant = useItemVariant()
+    const isBonusProduct = variant?.bonusProductLineItem
 
     const {data: customer} = useCurrentCustomer()
     const modalProps = useDisclosure()
@@ -89,7 +90,7 @@ const CartSecondaryButtonGroup = ({
                             id="cart_secondary_button_group.action.remove"
                         />
                     </Button>
-                    {customer.isRegistered && (
+                    {customer.isRegistered && !isBonusProduct && (
                         <Button
                             variant="link"
                             size="sm"
@@ -108,31 +109,33 @@ const CartSecondaryButtonGroup = ({
                         />
                     </Button>
                 </ButtonGroup>
-                <Flex alignItems="center">
-                    <Checkbox
-                        name={`gift-checkbox-${variant.itemId}`}
-                        spacing={2}
-                        isChecked={isAGift}
-                        onChange={(e) => {
-                            const checked = e.target.checked
-                            onIsAGiftChange(variant, checked)
-                        }}
-                    >
-                        <FormattedMessage
-                            defaultMessage="This is a gift."
-                            id="cart_secondary_button_group.label.this_is_gift"
-                        />
-                    </Checkbox>
-                    {/* if you want to provide a link to your gift site, uncomment this section and re-build your translation*/}
-                    {/*<Box marginLeft={1}>*/}
-                    {/*    <Button marginLeft={1} variant="link" size="sm" href="#">*/}
-                    {/*        <FormattedMessage*/}
-                    {/*            defaultMessage="Learn More"*/}
-                    {/*            id="cart_secondary_button_group.link_learn_more"*/}
-                    {/*        />*/}
-                    {/*    </Button>*/}
-                    {/*</Box>*/}
-                </Flex>
+                {!isBonusProduct && (
+                    <Flex alignItems="center">
+                        <Checkbox
+                            name={`gift-checkbox-${variant.itemId}`}
+                            spacing={2}
+                            isChecked={isAGift}
+                            onChange={(e) => {
+                                const checked = e.target.checked
+                                onIsAGiftChange(variant, checked)
+                            }}
+                        >
+                            <FormattedMessage
+                                defaultMessage="This is a gift."
+                                id="cart_secondary_button_group.label.this_is_gift"
+                            />
+                        </Checkbox>
+                        {/* if you want to provide a link to your gift site, uncomment this section and re-build your translation*/}
+                        {/*<Box marginLeft={1}>*/}
+                        {/*    <Button marginLeft={1} variant="link" size="sm" href="#">*/}
+                        {/*        <FormattedMessage*/}
+                        {/*            defaultMessage="Learn More"*/}
+                        {/*            id="cart_secondary_button_group.link_learn_more"*/}
+                        {/*        />*/}
+                        {/*    </Button>*/}
+                        {/*</Box>*/}
+                    </Flex>
+                )}
             </Stack>
             <ConfirmationModal
                 {...REMOVE_CART_ITEM_CONFIRMATION_DIALOG_CONFIG}
diff --git a/packages/template-retail-react-app/app/pages/cart/partials/cart-secondary-button-group.test.js b/packages/template-retail-react-app/app/pages/cart/partials/cart-secondary-button-group.test.js
index 162b304cbc..bd54867cdd 100644
--- a/packages/template-retail-react-app/app/pages/cart/partials/cart-secondary-button-group.test.js
+++ b/packages/template-retail-react-app/app/pages/cart/partials/cart-secondary-button-group.test.js
@@ -16,11 +16,16 @@ import {noop} from '@salesforce/retail-react-app/app/utils/utils'
 const MockedComponent = ({
     onAddToWishlistClick = noop,
     onEditClick = noop,
-    onRemoveItemClick = noop
+    onRemoveItemClick = noop,
+    isBonusProduct = false
 }) => {
-    const product = mockedCustomerProductListsDetails.data[0]
+    const product = {
+        ...mockedCustomerProductListsDetails.data[0],
+        productName: mockedCustomerProductListsDetails.data[0].name,
+        bonusProductLineItem: isBonusProduct
+    }
     return (
-        <ItemVariantProvider variant={{...product, productName: product.name}}>
+        <ItemVariantProvider variant={product}>
             <CartSecondaryButtonGroup
                 onAddToWishlistClick={onAddToWishlistClick}
                 onEditClick={onEditClick}
@@ -33,7 +38,8 @@ const MockedComponent = ({
 MockedComponent.propTypes = {
     onAddToWishlistClick: PropTypes.func,
     onEditClick: PropTypes.func,
-    onRemoveItemClick: PropTypes.func
+    onRemoveItemClick: PropTypes.func,
+    isBonusProduct: PropTypes.bool
 }
 
 beforeEach(() => {
@@ -101,3 +107,14 @@ test('renders secondary with event handlers', async () => {
 
     expect(onRemoveItemClick).toHaveBeenCalledTimes(1)
 })
+
+test('hides wishlist and gift checkbox for bonus product', async () => {
+    const {user} = renderWithProviders(<MockedComponent isBonusProduct={true} />)
+
+    expect(screen.getByRole('button', {name: /remove/i})).toBeInTheDocument()
+    expect(screen.getByRole('button', {name: /edit/i})).toBeInTheDocument()
+    
+
+    expect(screen.queryByRole('button', {name: /add to wishlist/i})).not.toBeInTheDocument()
+    expect(screen.queryByRole('checkbox', {name: /this is a gift/i})).not.toBeInTheDocument()
+})

From 92ec48e7c4d015af999353cc1afb09abdd5daab3 Mon Sep 17 00:00:00 2001
From: daniel-diaz <daniel.diaz@salesforce.com>
Date: Tue, 10 Jun 2025 14:08:46 -0400
Subject: [PATCH 09/44] Add bonus products title partial test

---
 .../partials/bonus-products-title.test.js     | 52 +++++++++++++++++++
 1 file changed, 52 insertions(+)
 create mode 100644 packages/template-retail-react-app/app/pages/cart/partials/bonus-products-title.test.js

diff --git a/packages/template-retail-react-app/app/pages/cart/partials/bonus-products-title.test.js b/packages/template-retail-react-app/app/pages/cart/partials/bonus-products-title.test.js
new file mode 100644
index 0000000000..5cb687b9ec
--- /dev/null
+++ b/packages/template-retail-react-app/app/pages/cart/partials/bonus-products-title.test.js
@@ -0,0 +1,52 @@
+/*
+ * Copyright (c) 2024, Salesforce, Inc.
+ * All rights reserved.
+ * SPDX-License-Identifier: BSD-3-Clause
+ * For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/BSD-3-Clause
+ */
+import React from 'react'
+import {render, screen} from '@testing-library/react'
+import {IntlProvider} from 'react-intl'
+import BonusProductsTitle from './bonus-products-title'
+import {useCurrentBasket} from '@salesforce/retail-react-app/app/hooks/use-current-basket'
+
+// Mock the useCurrentBasket hook
+jest.mock('@salesforce/retail-react-app/app/hooks/use-current-basket')
+
+const MockedComponent = ({basketData}) => {
+    useCurrentBasket.mockReturnValue({data: basketData})
+    return (
+        <IntlProvider messages={{}} locale="en">
+            <BonusProductsTitle />
+        </IntlProvider>
+    )
+}
+
+describe('BonusProductsTitle', () => {
+    beforeEach(() => {
+        jest.clearAllMocks()
+    })
+
+    it('renders title with 1 item when one bonus product', () => {
+        const basketData = {
+            productItems: [
+                {id: '1', bonusProductLineItem: true},
+                {id: '2', bonusProductLineItem: false}
+            ]
+        }
+        render(<MockedComponent basketData={basketData} />)
+        expect(screen.getByText('Bonus Products (1 item)')).toBeInTheDocument()
+    })
+
+    it('renders title with multiple items when multiple bonus products', () => {
+        const basketData = {
+            productItems: [
+                {id: '1', bonusProductLineItem: true},
+                {id: '2', bonusProductLineItem: true},
+                {id: '3', bonusProductLineItem: false}
+            ]
+        }
+        render(<MockedComponent basketData={basketData} />)
+        expect(screen.getByText('Bonus Products (2 items)')).toBeInTheDocument()
+    })
+}) 
\ No newline at end of file

From 84775e50d92de342134663abcc3fd022c95c4e95 Mon Sep 17 00:00:00 2001
From: daniel-diaz <daniel.diaz@salesforce.com>
Date: Tue, 10 Jun 2025 14:22:11 -0400
Subject: [PATCH 10/44] Fixed linting issues

---
 .../app/pages/cart/index.jsx                     | 14 +++++++++++++-
 .../cart/partials/bonus-products-title.test.js   | 16 ++++++++++++++--
 .../partials/cart-secondary-button-group.test.js |  1 -
 3 files changed, 27 insertions(+), 4 deletions(-)

diff --git a/packages/template-retail-react-app/app/pages/cart/index.jsx b/packages/template-retail-react-app/app/pages/cart/index.jsx
index f3ddf6371a..e05e31e5de 100644
--- a/packages/template-retail-react-app/app/pages/cart/index.jsx
+++ b/packages/template-retail-react-app/app/pages/cart/index.jsx
@@ -6,7 +6,8 @@
  */
 import React, {useState, useMemo} from 'react'
 import {FormattedMessage, useIntl} from 'react-intl'
-ƒ
+
+// Chakra Components
 import {
     Box,
     Stack,
@@ -615,6 +616,17 @@ const Cart = () => {
                                                     index={idx}
                                                     secondaryActions={
                                                         <CartSecondaryButtonGroup
+                                                            isAGift={
+                                                                localIsGiftItems[productItem.itemId]
+                                                                    ? localIsGiftItems[
+                                                                          productItem.itemId
+                                                                      ]
+                                                                    : productItem.gift
+                                                            }
+                                                            onIsAGiftChange={handleIsAGiftChange}
+                                                            onAddToWishlistClick={
+                                                                handleAddToWishlist
+                                                            }
                                                             onEditClick={(product) => {
                                                                 setSelectedItem(product)
                                                                 onOpen()
diff --git a/packages/template-retail-react-app/app/pages/cart/partials/bonus-products-title.test.js b/packages/template-retail-react-app/app/pages/cart/partials/bonus-products-title.test.js
index 5cb687b9ec..54f07d4fb8 100644
--- a/packages/template-retail-react-app/app/pages/cart/partials/bonus-products-title.test.js
+++ b/packages/template-retail-react-app/app/pages/cart/partials/bonus-products-title.test.js
@@ -5,9 +5,10 @@
  * For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/BSD-3-Clause
  */
 import React from 'react'
+import PropTypes from 'prop-types'
 import {render, screen} from '@testing-library/react'
 import {IntlProvider} from 'react-intl'
-import BonusProductsTitle from './bonus-products-title'
+import BonusProductsTitle from '@salesforce/retail-react-app/app/pages/cart/partials/bonus-products-title'
 import {useCurrentBasket} from '@salesforce/retail-react-app/app/hooks/use-current-basket'
 
 // Mock the useCurrentBasket hook
@@ -22,6 +23,17 @@ const MockedComponent = ({basketData}) => {
     )
 }
 
+MockedComponent.propTypes = {
+    basketData: PropTypes.shape({
+        productItems: PropTypes.arrayOf(
+            PropTypes.shape({
+                id: PropTypes.string,
+                bonusProductLineItem: PropTypes.bool
+            })
+        )
+    })
+}
+
 describe('BonusProductsTitle', () => {
     beforeEach(() => {
         jest.clearAllMocks()
@@ -49,4 +61,4 @@ describe('BonusProductsTitle', () => {
         render(<MockedComponent basketData={basketData} />)
         expect(screen.getByText('Bonus Products (2 items)')).toBeInTheDocument()
     })
-}) 
\ No newline at end of file
+})
diff --git a/packages/template-retail-react-app/app/pages/cart/partials/cart-secondary-button-group.test.js b/packages/template-retail-react-app/app/pages/cart/partials/cart-secondary-button-group.test.js
index bd54867cdd..9b1d2f1bb5 100644
--- a/packages/template-retail-react-app/app/pages/cart/partials/cart-secondary-button-group.test.js
+++ b/packages/template-retail-react-app/app/pages/cart/partials/cart-secondary-button-group.test.js
@@ -113,7 +113,6 @@ test('hides wishlist and gift checkbox for bonus product', async () => {
 
     expect(screen.getByRole('button', {name: /remove/i})).toBeInTheDocument()
     expect(screen.getByRole('button', {name: /edit/i})).toBeInTheDocument()
-    
 
     expect(screen.queryByRole('button', {name: /add to wishlist/i})).not.toBeInTheDocument()
     expect(screen.queryByRole('checkbox', {name: /this is a gift/i})).not.toBeInTheDocument()

From 7830475c212d159afbed8332694da687feb8e1e6 Mon Sep 17 00:00:00 2001
From: daniel-diaz <daniel.diaz@salesforce.com>
Date: Tue, 10 Jun 2025 14:28:58 -0400
Subject: [PATCH 11/44] Review suggestions

---
 packages/template-retail-react-app/app/pages/cart/index.jsx   | 4 ++--
 .../app/pages/cart/partials/bonus-products-title.jsx          | 2 +-
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/packages/template-retail-react-app/app/pages/cart/index.jsx b/packages/template-retail-react-app/app/pages/cart/index.jsx
index e05e31e5de..044be99187 100644
--- a/packages/template-retail-react-app/app/pages/cart/index.jsx
+++ b/packages/template-retail-react-app/app/pages/cart/index.jsx
@@ -599,7 +599,7 @@ const Cart = () => {
 
                                     {/* Bonus Products Title */}
                                     {basket.productItems?.some(
-                                        (item) => item.bonusProductLineItem === true
+                                        (item) => item.bonusProductLineItem
                                     ) && (
                                         <Box>
                                             <BonusProductsTitle />
@@ -608,7 +608,7 @@ const Cart = () => {
 
                                     {/* Bonus Products */}
                                     {basket.productItems
-                                        ?.filter((item) => item.bonusProductLineItem === true)
+                                        ?.filter((item) => item.bonusProductLineItem)
                                         .map((productItem, idx) => {
                                             return (
                                                 <ProductItem
diff --git a/packages/template-retail-react-app/app/pages/cart/partials/bonus-products-title.jsx b/packages/template-retail-react-app/app/pages/cart/partials/bonus-products-title.jsx
index bfb9c8dc34..36d1e69c3c 100644
--- a/packages/template-retail-react-app/app/pages/cart/partials/bonus-products-title.jsx
+++ b/packages/template-retail-react-app/app/pages/cart/partials/bonus-products-title.jsx
@@ -12,7 +12,7 @@ import {useCurrentBasket} from '@salesforce/retail-react-app/app/hooks/use-curre
 const BonusProductsTitle = () => {
     const {data: basket} = useCurrentBasket()
     const bonusItemsCount =
-        basket?.productItems?.filter((item) => item.bonusProductLineItem === true).length || 0
+        basket?.productItems?.filter((item) => item.bonusProductLineItem).length || 0
 
     return (
         <Heading as="h2" fontSize="xl">

From 83b1dbb1bce4bf6f21a7db90d3c6ce34b8a598a3 Mon Sep 17 00:00:00 2001
From: madhuri-uppu <madhuri.uppu@salesforce.com>
Date: Tue, 10 Jun 2025 12:32:37 -0700
Subject: [PATCH 12/44] removed localstorage and updated bonus products info
 from current basket

---
 .../app/components/_app/index.jsx             |   2 +-
 .../app/components/product-view/index.jsx     |   1 +
 .../app/hooks/use-bonus-product-modal.js      |  31 ++--
 .../app/hooks/use-bonus-product-modal.test.js | 165 +++++++++---------
 4 files changed, 102 insertions(+), 97 deletions(-)

diff --git a/packages/template-retail-react-app/app/components/_app/index.jsx b/packages/template-retail-react-app/app/components/_app/index.jsx
index 957155e7b3..adf086bf87 100644
--- a/packages/template-retail-react-app/app/components/_app/index.jsx
+++ b/packages/template-retail-react-app/app/components/_app/index.jsx
@@ -414,7 +414,7 @@ const App = (props) => {
                             </Box>
                             {!isOnline && <OfflineBanner />}
                             <AddToCartModalProvider>
-                                <BonusProductModalProvider>
+                                <BonusProductModalProvider basket={basket}>
                                     <SkipNavContent
                                         style={{
                                             display: 'flex',
diff --git a/packages/template-retail-react-app/app/components/product-view/index.jsx b/packages/template-retail-react-app/app/components/product-view/index.jsx
index 01e0f51c5e..ff19cd84c6 100644
--- a/packages/template-retail-react-app/app/components/product-view/index.jsx
+++ b/packages/template-retail-react-app/app/components/product-view/index.jsx
@@ -301,6 +301,7 @@ const ProductView = forwardRef(
                             onBonusProductModalOpen({
                                 newBonusItems,
                                 allBonusItems: addToCartResponse.bonusDiscountLineItems,
+                                openAddToCartModalIfNeeded: true,
                                 product,
                                 itemsAdded,
                                 selectedQuantity: quantity
diff --git a/packages/template-retail-react-app/app/hooks/use-bonus-product-modal.js b/packages/template-retail-react-app/app/hooks/use-bonus-product-modal.js
index 48a7201b8a..238aa2b8cf 100644
--- a/packages/template-retail-react-app/app/hooks/use-bonus-product-modal.js
+++ b/packages/template-retail-react-app/app/hooks/use-bonus-product-modal.js
@@ -17,15 +17,14 @@ import {
     Heading
 } from '@salesforce/retail-react-app/app/components/shared/ui'
 import {useAddToCartModalContext} from '@salesforce/retail-react-app/app/hooks/use-add-to-cart-modal'
-import {isServer} from '@salesforce/retail-react-app/app/utils/utils'
 import PropTypes from 'prop-types'
 
 export const BonusProductModalContext = React.createContext()
 
 export const useBonusProductModalContext = () => useContext(BonusProductModalContext)
 
-export const BonusProductModalProvider = ({children}) => {
-    const bonusProductState = useBonusState()
+export const BonusProductModalProvider = ({children, basket}) => {
+    const bonusProductState = useBonusState(basket)
 
     return (
         <BonusProductModalContext.Provider value={bonusProductState}>
@@ -35,7 +34,8 @@ export const BonusProductModalProvider = ({children}) => {
     )
 }
 BonusProductModalProvider.propTypes = {
-    children: PropTypes.node.isRequired
+    children: PropTypes.node.isRequired,
+    basket: PropTypes.object
 }
 
 export const BonusProductModal = () => {
@@ -65,11 +65,11 @@ export const BonusProductModal = () => {
     )
 }
 
-export const useBonusState = () => {
+export const useBonusState = (basket) => {
     const [state, setState] = useState({
         isOpen: false,
         data: {},
-        bonusProducts: !isServer ? JSON.parse(localStorage.getItem('bonusProducts') || '[]') : []
+        bonusProducts: basket?.bonusDiscountLineItems || []
     })
     const {pathname} = useLocation()
     const {onOpen: onAddToCartModalOpen} = useAddToCartModalContext()
@@ -83,13 +83,17 @@ export const useBonusState = () => {
         }
     }, [pathname])
 
+    // Update bonusProducts when basket changes
+    useEffect(() => {
+        setState((prev) => ({
+            ...prev,
+            bonusProducts: basket?.bonusDiscountLineItems || []
+        }))
+    }, [basket])
+
     const addBonusProducts = (newBonusItems) => {
         setState((prev) => {
             const updatedBonusProducts = [...prev.bonusProducts, ...newBonusItems]
-            // Store in localStorage only in browser environment
-            if (!isServer) {
-                localStorage.setItem('bonusProducts', JSON.stringify(updatedBonusProducts))
-            }
             return {
                 ...prev,
                 bonusProducts: updatedBonusProducts
@@ -102,9 +106,6 @@ export const useBonusState = () => {
             ...prev,
             bonusProducts: []
         }))
-        if (!isServer) {
-            localStorage.removeItem('bonusProducts')
-        }
     }
 
     return {
@@ -119,8 +120,8 @@ export const useBonusState = () => {
                 isOpen: false,
                 data: {}
             }))
-            // Show AddToCartModal after BonusProductModal is closed
-            if (state.data.product) {
+
+            if (state.data.openAddToCartModalIfNeeded && state.data.product) {
                 onAddToCartModalOpen({
                     product: state.data.product,
                     itemsAdded: state.data.itemsAdded,
diff --git a/packages/template-retail-react-app/app/hooks/use-bonus-product-modal.test.js b/packages/template-retail-react-app/app/hooks/use-bonus-product-modal.test.js
index 4f26795ed7..fc636038ca 100644
--- a/packages/template-retail-react-app/app/hooks/use-bonus-product-modal.test.js
+++ b/packages/template-retail-react-app/app/hooks/use-bonus-product-modal.test.js
@@ -5,137 +5,140 @@
  * For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/BSD-3-Clause
  */
 import React from 'react'
-import {renderHook, act} from '@testing-library/react'
-import {useBonusState} from '@salesforce/retail-react-app/app/hooks/use-bonus-product-modal'
-import {useAddToCartModalContext} from '@salesforce/retail-react-app/app/hooks/use-add-to-cart-modal'
+import {renderHook, act, render} from '@testing-library/react'
+import {ChakraProvider} from '@chakra-ui/react'
 import {useLocation} from 'react-router-dom'
-
-// Mock the dependencies
+import {
+    useBonusState,
+    BonusProductModalProvider,
+    useBonusProductModalContext,
+    BonusProductModal
+} from '@salesforce/retail-react-app/app/hooks/use-bonus-product-modal'
+
+// Mock react-router-dom's useLocation
 jest.mock('react-router-dom', () => ({
+    ...jest.requireActual('react-router-dom'),
     useLocation: jest.fn()
 }))
 
-jest.mock('./use-add-to-cart-modal', () => ({
-    useAddToCartModalContext: jest.fn()
+// Mock useAddToCartModalContext
+const mockOnAddToCartModalOpen = jest.fn()
+jest.mock('@salesforce/retail-react-app/app/hooks/use-add-to-cart-modal', () => ({
+    useAddToCartModalContext: () => ({onOpen: mockOnAddToCartModalOpen})
 }))
 
-// Mock localStorage
-const localStorageMock = (() => {
-    let store = {}
-    return {
-        getItem: jest.fn((key) => store[key]),
-        setItem: jest.fn((key, value) => {
-            store[key] = value
-        }),
-        removeItem: jest.fn((key) => {
-            delete store[key]
-        }),
-        clear: jest.fn(() => {
-            store = {}
-        })
-    }
-})()
-
-Object.defineProperty(window, 'localStorage', {
-    value: localStorageMock
-})
-
 describe('useBonusState', () => {
     beforeEach(() => {
-        // Reset all mocks before each test
         jest.clearAllMocks()
-        localStorageMock.clear()
-        useLocation.mockReturnValue({pathname: '/'})
-        useAddToCartModalContext.mockReturnValue({
-            onOpen: jest.fn()
-        })
+        useLocation.mockReturnValue({pathname: '/initial'})
     })
 
-    it('should initialize with empty state', () => {
-        const {result} = renderHook(() => useBonusState())
-
+    it('initializes with correct state from basket', () => {
+        const basket = {bonusDiscountLineItems: [{id: 'b1'}]}
+        const {result} = renderHook(() => useBonusState(basket))
         expect(result.current.isOpen).toBe(false)
         expect(result.current.data).toEqual({})
-        expect(result.current.bonusProducts).toEqual([])
+        expect(result.current.bonusProducts).toEqual([{id: 'b1'}])
     })
 
-    it('should load products from localStorage on initialization', () => {
-        const mockProducts = [{id: 1, name: 'Product 1'}]
-        localStorageMock.setItem('bonusProducts', JSON.stringify(mockProducts))
-
-        const {result} = renderHook(() => useBonusState())
-
-        expect(result.current.bonusProducts).toEqual(mockProducts)
+    it('updates bonusProducts when basket changes', () => {
+        const {result, rerender} = renderHook(({basket}) => useBonusState(basket), {
+            initialProps: {basket: {bonusDiscountLineItems: [{id: 'b1'}]}}
+        })
+        rerender({basket: {bonusDiscountLineItems: [{id: 'b2'}]}})
+        expect(result.current.bonusProducts).toEqual([{id: 'b2'}])
     })
 
-    it('should add products and update localStorage', () => {
+    it('addBonusProducts adds items', () => {
         const {result} = renderHook(() => useBonusState())
-        const newProducts = [{id: 2, name: 'Product 2'}]
-
         act(() => {
-            result.current.addBonusProducts(newProducts)
+            result.current.addBonusProducts([{id: 'b3'}])
         })
-
-        expect(result.current.bonusProducts).toEqual(newProducts)
-        expect(localStorageMock.setItem).toHaveBeenCalledWith(
-            'bonusProducts',
-            JSON.stringify(newProducts)
-        )
+        expect(result.current.bonusProducts).toEqual([{id: 'b3'}])
     })
 
-    it('should clear products and remove from localStorage', () => {
+    it('clearBonusProducts empties bonusProducts', () => {
         const {result} = renderHook(() => useBonusState())
-
-        // First add some products
         act(() => {
-            result.current.addBonusProducts([{id: 1, name: 'Product 1'}])
+            result.current.addBonusProducts([{id: 'b4'}])
         })
-
-        // Then clear them
         act(() => {
             result.current.clearBonusProducts()
         })
-
         expect(result.current.bonusProducts).toEqual([])
-        expect(localStorageMock.removeItem).toHaveBeenCalledWith('bonusProducts')
     })
 
-    it('should handle modal open/close state', () => {
+    it('onOpen sets modal open and stores data', () => {
         const {result} = renderHook(() => useBonusState())
-        const modalData = {product: {id: 1}, itemsAdded: 1, selectedQuantity: 1}
-
         act(() => {
-            result.current.onOpen(modalData)
+            result.current.onOpen({foo: 'bar'})
         })
-
         expect(result.current.isOpen).toBe(true)
-        expect(result.current.data).toEqual(modalData)
+        expect(result.current.data).toEqual({foo: 'bar'})
+    })
 
+    it('onClose closes modal and clears data', () => {
+        const {result} = renderHook(() => useBonusState())
+        act(() => {
+            result.current.onOpen({foo: 'bar'})
+        })
         act(() => {
             result.current.onClose()
         })
-
         expect(result.current.isOpen).toBe(false)
         expect(result.current.data).toEqual({})
     })
 
-    it('should close modal and open add to cart modal when closing with product data', () => {
-        const mockOnAddToCartModalOpen = jest.fn()
-        useAddToCartModalContext.mockReturnValue({
-            onOpen: mockOnAddToCartModalOpen
-        })
-
+    it('onClose calls onAddToCartModalOpen if needed', () => {
         const {result} = renderHook(() => useBonusState())
-        const modalData = {product: {id: 1}, itemsAdded: 1, selectedQuantity: 1}
-
+        const data = {
+            openAddToCartModalIfNeeded: true,
+            product: {id: 'p1'},
+            itemsAdded: 2,
+            selectedQuantity: 1
+        }
         act(() => {
-            result.current.onOpen(modalData)
+            result.current.onOpen(data)
         })
-
         act(() => {
             result.current.onClose()
         })
+        expect(mockOnAddToCartModalOpen).toHaveBeenCalledWith({
+            product: {id: 'p1'},
+            itemsAdded: 2,
+            selectedQuantity: 1
+        })
+    })
+
+    it('closes modal on location change', () => {
+        let location = {pathname: '/foo'}
+        useLocation.mockImplementation(() => location)
+        const {result, rerender} = renderHook(() => useBonusState())
+        act(() => {
+            result.current.onOpen({foo: 'bar'})
+        })
+        expect(result.current.isOpen).toBe(true)
+        // Simulate location change
+        location = {pathname: '/bar'}
+        rerender()
+        expect(result.current.isOpen).toBe(false)
+    })
+})
 
-        expect(mockOnAddToCartModalOpen).toHaveBeenCalledWith(modalData)
+describe('BonusProductModalProvider', () => {
+    it('provides context to children', () => {
+        const basket = {bonusDiscountLineItems: [{id: 'b1'}]}
+        const TestChild = () => {
+            const ctx = useBonusProductModalContext()
+            return <div data-testid="ctx">{JSON.stringify(ctx.bonusProducts)}</div>
+        }
+        const {getByTestId} = render(
+            <ChakraProvider>
+                <BonusProductModalProvider basket={basket}>
+                    <TestChild />
+                </BonusProductModalProvider>
+            </ChakraProvider>
+        )
+        expect(getByTestId('ctx').textContent).toContain('b1')
     })
 })

From 0a697ef314527c45c6ab24806e806eebceaf32ae Mon Sep 17 00:00:00 2001
From: madhuri-uppu <madhuri.uppu@salesforce.com>
Date: Tue, 10 Jun 2025 12:40:16 -0700
Subject: [PATCH 13/44] removed unnecessary code

---
 .../template-retail-react-app/app/pages/checkout/index.jsx    | 4 +---
 1 file changed, 1 insertion(+), 3 deletions(-)

diff --git a/packages/template-retail-react-app/app/pages/checkout/index.jsx b/packages/template-retail-react-app/app/pages/checkout/index.jsx
index 4ad5113bf6..899c0f5c96 100644
--- a/packages/template-retail-react-app/app/pages/checkout/index.jsx
+++ b/packages/template-retail-react-app/app/pages/checkout/index.jsx
@@ -38,7 +38,6 @@ import {
 import {useToast} from '@salesforce/retail-react-app/app/hooks/use-toast'
 import LoadingSpinner from '@salesforce/retail-react-app/app/components/loading-spinner'
 import {getConfig} from '@salesforce/pwa-kit-runtime/utils/ssr-config'
-import {useBonusProductModalContext} from '@salesforce/retail-react-app/app/hooks/use-bonus-product-modal'
 
 const Checkout = () => {
     const {formatMessage} = useIntl()
@@ -52,7 +51,7 @@ const Checkout = () => {
     const idps = social?.idps
     const isSocialEnabled = !!social?.enabled
     const isPasswordlessEnabled = !!passwordless?.enabled
-    const {clearBonusProducts} = useBonusProductModalContext()
+
 
     useEffect(() => {
         if (error || step === 4) {
@@ -66,7 +65,6 @@ const Checkout = () => {
             const order = await createOrder({
                 body: {basketId: basket.basketId}
             })
-            clearBonusProducts()
             navigate(`/checkout/confirmation/${order.orderNo}`)
         } catch (error) {
             const message = formatMessage({

From 4a0950c7874b932681e29ed4e6add8fc48e01de2 Mon Sep 17 00:00:00 2001
From: madhuri-uppu <madhuri.uppu@salesforce.com>
Date: Tue, 10 Jun 2025 12:41:05 -0700
Subject: [PATCH 14/44] nit space

---
 packages/template-retail-react-app/app/pages/checkout/index.jsx | 1 -
 1 file changed, 1 deletion(-)

diff --git a/packages/template-retail-react-app/app/pages/checkout/index.jsx b/packages/template-retail-react-app/app/pages/checkout/index.jsx
index 899c0f5c96..fa4e8303a2 100644
--- a/packages/template-retail-react-app/app/pages/checkout/index.jsx
+++ b/packages/template-retail-react-app/app/pages/checkout/index.jsx
@@ -52,7 +52,6 @@ const Checkout = () => {
     const isSocialEnabled = !!social?.enabled
     const isPasswordlessEnabled = !!passwordless?.enabled
 
-
     useEffect(() => {
         if (error || step === 4) {
             window.scrollTo({top: 0})

From 5c7b0bb512a005580266c95b2fd2ab8a9f9d7a45 Mon Sep 17 00:00:00 2001
From: daniel-diaz <daniel.diaz@salesforce.com>
Date: Tue, 10 Jun 2025 16:30:10 -0400
Subject: [PATCH 15/44] Code review comments

---
 .../app/components/product-item/index.jsx     | 109 ++-------------
 .../partials/BonusProductQuantity.jsx         |  43 ++++++
 .../partials/BonusProductQuantity.test.jsx    |  46 ++++++
 .../partials/ProductQuantityPicker.jsx        |  93 ++++++++++++
 .../partials/ProductQuantityPicker.test.jsx   | 132 ++++++++++++++++++
 5 files changed, 327 insertions(+), 96 deletions(-)
 create mode 100644 packages/template-retail-react-app/app/components/product-item/partials/BonusProductQuantity.jsx
 create mode 100644 packages/template-retail-react-app/app/components/product-item/partials/BonusProductQuantity.test.jsx
 create mode 100644 packages/template-retail-react-app/app/components/product-item/partials/ProductQuantityPicker.jsx
 create mode 100644 packages/template-retail-react-app/app/components/product-item/partials/ProductQuantityPicker.test.jsx

diff --git a/packages/template-retail-react-app/app/components/product-item/index.jsx b/packages/template-retail-react-app/app/components/product-item/index.jsx
index 44a9606ca8..ec8e6b2eab 100644
--- a/packages/template-retail-react-app/app/components/product-item/index.jsx
+++ b/packages/template-retail-react-app/app/components/product-item/index.jsx
@@ -6,17 +6,9 @@
  */
 import React from 'react'
 import PropTypes from 'prop-types'
-import {FormattedMessage, useIntl} from 'react-intl'
 
 // Chakra Components
-import {
-    Box,
-    Fade,
-    Flex,
-    Stack,
-    Text,
-    VisuallyHidden
-} from '@salesforce/retail-react-app/app/components/shared/ui'
+import {Box, Fade, Flex, Stack, Text} from '@salesforce/retail-react-app/app/components/shared/ui'
 
 // Project Components
 import {HideOnDesktop, HideOnMobile} from '@salesforce/retail-react-app/app/components/responsive'
@@ -26,7 +18,10 @@ import CartItemVariantName from '@salesforce/retail-react-app/app/components/ite
 import CartItemVariantAttributes from '@salesforce/retail-react-app/app/components/item-variant/item-attributes'
 import CartItemVariantPrice from '@salesforce/retail-react-app/app/components/item-variant/item-price'
 import LoadingSpinner from '@salesforce/retail-react-app/app/components/loading-spinner'
-import QuantityPicker from '@salesforce/retail-react-app/app/components/quantity-picker'
+
+// Partials
+import BonusProductQuantity from '@salesforce/retail-react-app/app/components/product-item/partials/BonusProductQuantity'
+import ProductQuantityPicker from '@salesforce/retail-react-app/app/components/product-item/partials/ProductQuantityPicker'
 
 // Utilities
 import {noop} from '@salesforce/retail-react-app/app/utils/utils'
@@ -53,7 +48,6 @@ const ProductItem = ({
     const {stepQuantity, showInventoryMessage, inventoryMessage, quantity, setQuantity} =
         useDerivedProduct(product)
     const {currency: activeCurrency} = useCurrency()
-    const intl = useIntl()
     return (
         <Box
             position="relative"
@@ -81,92 +75,15 @@ const ProductItem = ({
                             <Flex align="flex-end" justify="space-between">
                                 <Stack spacing={1}>
                                     {product.bonusProductLineItem ? (
-                                        <Text
-                                            fontSize="sm"
-                                            color="gray.700"
-                                            aria-label={intl.formatMessage(
-                                                {
-                                                    id: 'item_variant.assistive_msg.quantity',
-                                                    defaultMessage: 'Quantity {quantity}'
-                                                },
-                                                {
-                                                    quantity: product?.quantity
-                                                }
-                                            )}
-                                        >
-                                            <FormattedMessage
-                                                defaultMessage="Quantity: {quantity}"
-                                                id="bonusproduct_item.label.quantity"
-                                                values={{
-                                                    quantity: product.quantity
-                                                }}
-                                            />
-                                        </Text>
+                                        <BonusProductQuantity product={product} />
                                     ) : (
-                                        <>
-                                            <Text
-                                                fontSize="sm"
-                                                color="gray.700"
-                                                aria-label={intl.formatMessage(
-                                                    {
-                                                        id: 'item_variant.quantity.label',
-                                                        defaultMessage:
-                                                            'Quantity selector for {productName}. Selected quantity is {quantity}'
-                                                    },
-                                                    {
-                                                        quantity: product?.quantity,
-                                                        productName: product?.name
-                                                    }
-                                                )}
-                                            >
-                                                <FormattedMessage
-                                                    defaultMessage="Quantity:"
-                                                    id="product_item.label.quantity"
-                                                />
-                                            </Text>
-                                            <QuantityPicker
-                                                step={stepQuantity}
-                                                value={quantity}
-                                                min={0}
-                                                clampValueOnBlur={false}
-                                                onBlur={(e) => {
-                                                    // Default to last known quantity if a user leaves the box with an invalid value
-                                                    const {value} = e.target
-
-                                                    if (!value) {
-                                                        setQuantity(product.quantity)
-                                                    }
-                                                }}
-                                                onChange={(stringValue, numberValue) => {
-                                                    // Set the Quantity of product to value of input if value number
-                                                    if (numberValue >= 0) {
-                                                        // Call handler
-                                                        onItemQuantityChange(numberValue).then(
-                                                            (isValidChange) =>
-                                                                isValidChange &&
-                                                                setQuantity(numberValue)
-                                                        )
-                                                    } else if (stringValue === '') {
-                                                        // We want to allow the use to clear the input to start a new input so here we set the quantity to '' so NAN is not displayed
-                                                        // User will not be able to add '' quantity to the cart due to the add to cart button enablement rules
-                                                        setQuantity(stringValue)
-                                                    }
-                                                }}
-                                                productName={product?.name}
-                                            />
-                                            <VisuallyHidden role="status">
-                                                {product?.name}
-                                                {intl.formatMessage(
-                                                    {
-                                                        id: 'item_variant.assistive_msg.quantity',
-                                                        defaultMessage: 'Quantity {quantity}'
-                                                    },
-                                                    {
-                                                        quantity: product?.quantity
-                                                    }
-                                                )}
-                                            </VisuallyHidden>
-                                        </>
+                                        <ProductQuantityPicker
+                                            product={product}
+                                            onItemQuantityChange={onItemQuantityChange}
+                                            stepQuantity={stepQuantity}
+                                            quantity={quantity}
+                                            setQuantity={setQuantity}
+                                        />
                                     )}
                                 </Stack>
                                 <Stack>
diff --git a/packages/template-retail-react-app/app/components/product-item/partials/BonusProductQuantity.jsx b/packages/template-retail-react-app/app/components/product-item/partials/BonusProductQuantity.jsx
new file mode 100644
index 0000000000..cda8cb53ed
--- /dev/null
+++ b/packages/template-retail-react-app/app/components/product-item/partials/BonusProductQuantity.jsx
@@ -0,0 +1,43 @@
+/*
+ * Copyright (c) 2025, salesforce.com, inc.
+ * All rights reserved.
+ * SPDX-License-Identifier: BSD-3-Clause
+ * For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/BSD-3-Clause
+ */
+import React from 'react'
+import PropTypes from 'prop-types'
+import {FormattedMessage, useIntl} from 'react-intl'
+import {Text} from '@salesforce/retail-react-app/app/components/shared/ui'
+
+const BonusProductQuantity = ({product}) => {
+    const intl = useIntl()
+    return (
+        <Text
+            fontSize="sm"
+            color="gray.700"
+            aria-label={intl.formatMessage(
+                {
+                    id: 'item_variant.assistive_msg.quantity',
+                    defaultMessage: 'Quantity {quantity}'
+                },
+                {
+                    quantity: product?.quantity
+                }
+            )}
+        >
+            <FormattedMessage
+                defaultMessage="Quantity: {quantity}"
+                id="bonusproduct_item.label.quantity"
+                values={{
+                    quantity: product.quantity
+                }}
+            />
+        </Text>
+    )
+}
+
+BonusProductQuantity.propTypes = {
+    product: PropTypes.object.isRequired
+}
+
+export default BonusProductQuantity
diff --git a/packages/template-retail-react-app/app/components/product-item/partials/BonusProductQuantity.test.jsx b/packages/template-retail-react-app/app/components/product-item/partials/BonusProductQuantity.test.jsx
new file mode 100644
index 0000000000..f55751cedd
--- /dev/null
+++ b/packages/template-retail-react-app/app/components/product-item/partials/BonusProductQuantity.test.jsx
@@ -0,0 +1,46 @@
+/*
+ * Copyright (c) 2025, salesforce.com, inc.
+ * All rights reserved.
+ * SPDX-License-Identifier: BSD-3-Clause
+ * For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/BSD-3-Clause
+ */
+import React from 'react'
+import {render, screen} from '@testing-library/react'
+import {IntlProvider} from 'react-intl'
+import BonusProductQuantity from '@salesforce/retail-react-app/app/components/product-item/partials/BonusProductQuantity'
+
+const mockProduct = {
+    id: 'test-id',
+    quantity: 2,
+    name: 'Test Product'
+}
+
+const renderWithIntl = (component) => {
+    return render(
+        <IntlProvider locale="en" messages={{}}>
+            {component}
+        </IntlProvider>
+    )
+}
+
+describe('BonusProductQuantity', () => {
+    it('renders quantity for bonus product', () => {
+        renderWithIntl(<BonusProductQuantity product={mockProduct} />)
+        expect(screen.getByText('Quantity: 2')).toBeInTheDocument()
+    })
+
+    it('has correct aria label', () => {
+        renderWithIntl(<BonusProductQuantity product={mockProduct} />)
+        const element = screen.getByText('Quantity: 2')
+        expect(element).toHaveAttribute('aria-label', 'Quantity 2')
+    })
+
+    it('handles undefined quantity gracefully', () => {
+        const productWithoutQuantity = {
+            id: 'test-id',
+            name: 'Test Product'
+        }
+        renderWithIntl(<BonusProductQuantity product={productWithoutQuantity} />)
+        expect(screen.getByText('Quantity:')).toBeInTheDocument()
+    })
+})
diff --git a/packages/template-retail-react-app/app/components/product-item/partials/ProductQuantityPicker.jsx b/packages/template-retail-react-app/app/components/product-item/partials/ProductQuantityPicker.jsx
new file mode 100644
index 0000000000..4723951b83
--- /dev/null
+++ b/packages/template-retail-react-app/app/components/product-item/partials/ProductQuantityPicker.jsx
@@ -0,0 +1,93 @@
+/*
+ * Copyright (c) 2025, salesforce.com, inc.
+ * All rights reserved.
+ * SPDX-License-Identifier: BSD-3-Clause
+ * For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/BSD-3-Clause
+ */
+import React from 'react'
+import PropTypes from 'prop-types'
+import {FormattedMessage, useIntl} from 'react-intl'
+import {Text, VisuallyHidden} from '@salesforce/retail-react-app/app/components/shared/ui'
+import QuantityPicker from '@salesforce/retail-react-app/app/components/quantity-picker'
+
+const ProductQuantityPicker = ({
+    product,
+    onItemQuantityChange,
+    stepQuantity,
+    quantity,
+    setQuantity
+}) => {
+    const intl = useIntl()
+
+    return (
+        <>
+            <Text
+                fontSize="sm"
+                color="gray.700"
+                aria-label={intl.formatMessage(
+                    {
+                        id: 'item_variant.quantity.label',
+                        defaultMessage:
+                            'Quantity selector for {productName}. Selected quantity is {quantity}'
+                    },
+                    {
+                        quantity: product?.quantity,
+                        productName: product?.name
+                    }
+                )}
+            >
+                <FormattedMessage defaultMessage="Quantity:" id="product_item.label.quantity" />
+            </Text>
+            <QuantityPicker
+                step={stepQuantity}
+                value={quantity}
+                min={0}
+                clampValueOnBlur={false}
+                onBlur={(e) => {
+                    // Default to last known quantity if a user leaves the box with an invalid value
+                    const {value} = e.target
+
+                    if (!value) {
+                        setQuantity(product.quantity)
+                    }
+                }}
+                onChange={(stringValue, numberValue) => {
+                    // Set the Quantity of product to value of input if value number
+                    if (numberValue >= 0) {
+                        // Call handler
+                        onItemQuantityChange(numberValue).then(
+                            (isValidChange) => isValidChange && setQuantity(numberValue)
+                        )
+                    } else if (stringValue === '') {
+                        // We want to allow the use to clear the input to start a new input so here we set the quantity to '' so NAN is not displayed
+                        // User will not be able to add '' quantity to the cart due to the add to cart button enablement rules
+                        setQuantity(stringValue)
+                    }
+                }}
+                productName={product?.name}
+            />
+            <VisuallyHidden role="status">
+                {product?.name}
+                {intl.formatMessage(
+                    {
+                        id: 'item_variant.assistive_msg.quantity',
+                        defaultMessage: 'Quantity {quantity}'
+                    },
+                    {
+                        quantity: product?.quantity
+                    }
+                )}
+            </VisuallyHidden>
+        </>
+    )
+}
+
+ProductQuantityPicker.propTypes = {
+    product: PropTypes.object.isRequired,
+    onItemQuantityChange: PropTypes.func.isRequired,
+    stepQuantity: PropTypes.number.isRequired,
+    quantity: PropTypes.oneOfType([PropTypes.number, PropTypes.string]).isRequired,
+    setQuantity: PropTypes.func.isRequired
+}
+
+export default ProductQuantityPicker
diff --git a/packages/template-retail-react-app/app/components/product-item/partials/ProductQuantityPicker.test.jsx b/packages/template-retail-react-app/app/components/product-item/partials/ProductQuantityPicker.test.jsx
new file mode 100644
index 0000000000..a944169f45
--- /dev/null
+++ b/packages/template-retail-react-app/app/components/product-item/partials/ProductQuantityPicker.test.jsx
@@ -0,0 +1,132 @@
+/*
+ * Copyright (c) 2025, salesforce.com, inc.
+ * All rights reserved.
+ * SPDX-License-Identifier: BSD-3-Clause
+ * For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/BSD-3-Clause
+ */
+import React from 'react'
+import {render, screen, fireEvent, waitFor} from '@testing-library/react'
+import {IntlProvider} from 'react-intl'
+import {MemoryRouter} from 'react-router-dom'
+import ProductQuantityPicker from '@salesforce/retail-react-app/app/components/product-item/partials/ProductQuantityPicker'
+
+// Mock the hooks that use router context
+jest.mock('@salesforce/retail-react-app/app/hooks/use-variant', () => ({
+    useVariant: () => null
+}))
+
+jest.mock('@salesforce/retail-react-app/app/hooks/use-variation-params', () => ({
+    useVariationParams: () => ({})
+}))
+
+jest.mock('@salesforce/retail-react-app/app/hooks/use-variation-attributes', () => ({
+    useVariationAttributes: () => []
+}))
+
+const mockProduct = {
+    id: 'test-id',
+    quantity: 2,
+    name: 'Test Product',
+    inventory: {
+        stockLevel: 10
+    }
+}
+
+const mockSetQuantity = jest.fn()
+const mockOnItemQuantityChange = jest.fn()
+
+const renderWithIntl = (component) => {
+    return render(
+        <MemoryRouter>
+            <IntlProvider locale="en" messages={{}}>
+                {component}
+            </IntlProvider>
+        </MemoryRouter>
+    )
+}
+
+describe('ProductQuantityPicker', () => {
+    beforeEach(() => {
+        jest.clearAllMocks()
+    })
+
+    it('renders quantity label and picker', () => {
+        renderWithIntl(
+            <ProductQuantityPicker
+                product={mockProduct}
+                onItemQuantityChange={mockOnItemQuantityChange}
+                stepQuantity={1}
+                quantity={2}
+                setQuantity={mockSetQuantity}
+            />
+        )
+        expect(screen.getByText('Quantity:')).toBeInTheDocument()
+        expect(screen.getByRole('spinbutton')).toBeInTheDocument()
+    })
+
+    it('handles quantity change', async () => {
+        mockOnItemQuantityChange.mockResolvedValue(true)
+        renderWithIntl(
+            <ProductQuantityPicker
+                product={mockProduct}
+                onItemQuantityChange={mockOnItemQuantityChange}
+                stepQuantity={1}
+                quantity={2}
+                setQuantity={mockSetQuantity}
+            />
+        )
+        const input = screen.getByRole('spinbutton')
+        fireEvent.change(input, {target: {value: '3'}})
+        await waitFor(() => {
+            expect(mockOnItemQuantityChange).toHaveBeenCalledWith(3)
+            expect(mockSetQuantity).toHaveBeenCalledWith(3)
+        })
+    })
+
+    it('has correct aria label', () => {
+        renderWithIntl(
+            <ProductQuantityPicker
+                product={mockProduct}
+                onItemQuantityChange={mockOnItemQuantityChange}
+                stepQuantity={1}
+                quantity={2}
+                setQuantity={mockSetQuantity}
+            />
+        )
+        const element = screen.getByText('Quantity:')
+        expect(element).toHaveAttribute(
+            'aria-label',
+            'Quantity selector for Test Product. Selected quantity is 2'
+        )
+    })
+
+    it('handles empty input', () => {
+        renderWithIntl(
+            <ProductQuantityPicker
+                product={mockProduct}
+                onItemQuantityChange={mockOnItemQuantityChange}
+                stepQuantity={1}
+                quantity={2}
+                setQuantity={mockSetQuantity}
+            />
+        )
+        const input = screen.getByRole('spinbutton')
+        fireEvent.change(input, {target: {value: ''}})
+        expect(mockSetQuantity).toHaveBeenCalledWith('')
+    })
+
+    it('handles invalid input', () => {
+        renderWithIntl(
+            <ProductQuantityPicker
+                product={mockProduct}
+                onItemQuantityChange={mockOnItemQuantityChange}
+                stepQuantity={1}
+                quantity={2}
+                setQuantity={mockSetQuantity}
+            />
+        )
+        const input = screen.getByRole('spinbutton')
+        fireEvent.change(input, {target: {value: '-1'}})
+        expect(mockOnItemQuantityChange).not.toHaveBeenCalled()
+    })
+})

From afb7dc9dea8e17499d08269a6b0f362c64b6386d Mon Sep 17 00:00:00 2001
From: madhuri-uppu <madhuri.uppu@salesforce.com>
Date: Tue, 10 Jun 2025 14:05:53 -0700
Subject: [PATCH 16/44] fixed 2 failing tests

---
 .../app/components/product-view/index.test.js | 72 +++++++++++++++----
 .../app/utils/test-utils.js                   | 13 +++-
 2 files changed, 67 insertions(+), 18 deletions(-)

diff --git a/packages/template-retail-react-app/app/components/product-view/index.test.js b/packages/template-retail-react-app/app/components/product-view/index.test.js
index b4d1df55ed..1e68f26a33 100644
--- a/packages/template-retail-react-app/app/components/product-view/index.test.js
+++ b/packages/template-retail-react-app/app/components/product-view/index.test.js
@@ -46,9 +46,13 @@ afterEach(() => {
     sessionStorage.clear()
 })
 
+const mockBasket = {bonusDiscountLineItems: []}
+
 test('ProductView Component renders properly', async () => {
     const addToCart = jest.fn()
-    renderWithProviders(<MockComponent product={mockProductDetail} addToCart={addToCart} />)
+    renderWithProviders(<MockComponent product={mockProductDetail} addToCart={addToCart} />, {
+        wrapperProps: {basket: mockBasket}
+    })
     expect(screen.getAllByText(/Black Single Pleat Athletic Fit Wool Suit/i)).toHaveLength(2)
     expect(screen.getAllByText(/299\.99/)).toHaveLength(4)
     expect(screen.getAllByText(/Add to cart/i)).toHaveLength(2)
@@ -58,7 +62,9 @@ test('ProductView Component renders properly', async () => {
 
 test('ProductView Component renders with addToCart event handler', async () => {
     const addToCart = jest.fn()
-    await renderWithProviders(<MockComponent product={mockProductDetail} addToCart={addToCart} />)
+    await renderWithProviders(<MockComponent product={mockProductDetail} addToCart={addToCart} />, {
+        wrapperProps: {basket: mockBasket}
+    })
 
     const addToCartButton = screen.getAllByText(/add to cart/i)[0]
     fireEvent.click(addToCartButton)
@@ -72,7 +78,10 @@ test('ProductView Component renders with addToWishList event handler', async ()
     const addToWishlist = jest.fn()
 
     await renderWithProviders(
-        <MockComponent product={mockProductDetail} addToWishlist={addToWishlist} />
+        <MockComponent product={mockProductDetail} addToWishlist={addToWishlist} />,
+        {
+            wrapperProps: {basket: mockBasket}
+        }
     )
 
     await waitFor(() => {
@@ -91,7 +100,10 @@ test('ProductView Component renders with updateWishlist event handler', async ()
     const updateWishlist = jest.fn()
 
     await renderWithProviders(
-        <MockComponent product={mockProductDetail} updateWishlist={updateWishlist} />
+        <MockComponent product={mockProductDetail} updateWishlist={updateWishlist} />,
+        {
+            wrapperProps: {basket: mockBasket}
+        }
     )
 
     await waitFor(() => {
@@ -109,7 +121,9 @@ test('ProductView Component renders with updateWishlist event handler', async ()
 test('Product View can update quantity', async () => {
     const user = userEvent.setup()
     const addToCart = jest.fn()
-    await renderWithProviders(<MockComponent product={mockProductDetail} addToCart={addToCart} />)
+    await renderWithProviders(<MockComponent product={mockProductDetail} addToCart={addToCart} />, {
+        wrapperProps: {basket: mockBasket}
+    })
 
     let quantityBox
     await waitFor(() => {
@@ -132,7 +146,9 @@ test('Product View handles invalid quantity inputs', async () => {
     const user = userEvent.setup()
 
     // Any invalid input should be reset to minOrderQuantity
-    await renderWithProviders(<MockComponent product={mockProductDetail} />)
+    await renderWithProviders(<MockComponent product={mockProductDetail} />, {
+        wrapperProps: {basket: mockBasket}
+    })
 
     const quantityInput = screen.getByRole('spinbutton', {name: /quantity/i})
     const minQuantity = mockProductDetail.minOrderQuantity.toString()
@@ -156,7 +172,9 @@ test('Product View handles invalid quantity inputs', async () => {
 describe('ProductView Component', () => {
     test('increases quantity when increment button is clicked', async () => {
         const user = userEvent.setup()
-        renderWithProviders(<ProductView product={mockProductDetail} />)
+        renderWithProviders(<ProductView product={mockProductDetail} />, {
+            wrapperProps: {basket: mockBasket}
+        })
 
         const quantityInput = await screen.findByRole('spinbutton')
         const incrementButton = screen.getByTestId('quantity-increment')
@@ -179,7 +197,10 @@ describe('ProductView Component', () => {
 test('renders a product set properly - parent item', () => {
     const parent = mockProductSet
     renderWithProviders(
-        <MockComponent product={parent} addToCart={() => {}} addToWishlist={() => {}} />
+        <MockComponent product={parent} addToCart={() => {}} addToWishlist={() => {}} />,
+        {
+            wrapperProps: {basket: mockBasket}
+        }
     )
 
     // NOTE: there can be duplicates of the same element, due to mobile and desktop views
@@ -204,7 +225,10 @@ test('renders a product set properly - parent item', () => {
 test('renders a product set properly - child item', () => {
     const child = mockProductSet.setProducts[0]
     renderWithProviders(
-        <MockComponent product={child} addToCart={() => {}} addToWishlist={() => {}} />
+        <MockComponent product={child} addToCart={() => {}} addToWishlist={() => {}} />,
+        {
+            wrapperProps: {basket: mockBasket}
+        }
     )
 
     // NOTE: there can be duplicates of the same element, due to mobile and desktop views
@@ -239,7 +263,10 @@ test('validateOrderability callback is called when adding a set to cart', async
             validateOrderability={validateOrderability}
             addToCart={() => {}}
             addToWishlist={() => {}}
-        />
+        />,
+        {
+            wrapperProps: {basket: mockBasket}
+        }
     )
 
     const button = screen.getByRole('button', {name: /add set to cart/i})
@@ -262,7 +289,10 @@ test('onVariantSelected callback is called after successfully selected a variant
             onVariantSelected={onVariantSelected}
             addToCart={() => {}}
             addToWishlist={() => {}}
-        />
+        />,
+        {
+            wrapperProps: {basket: mockBasket}
+        }
     )
 
     const size = screen.getByRole('radio', {name: /xl/i})
@@ -280,7 +310,10 @@ describe('add to cart button loading tests', () => {
                 product={mockProductDetail}
                 addToCart={() => {}}
                 isBasketLoading={true}
-            />
+            />,
+            {
+                wrapperProps: {basket: mockBasket}
+            }
         )
         expect(screen.getByRole('button', {name: /add to cart/i})).toBeDisabled()
     })
@@ -291,7 +324,10 @@ describe('add to cart button loading tests', () => {
                 product={mockProductDetail}
                 addToCart={() => {}}
                 isBasketLoading={false}
-            />
+            />,
+            {
+                wrapperProps: {basket: mockBasket}
+            }
         )
         expect(screen.getByRole('button', {name: /add to cart/i})).toBeEnabled()
     })
@@ -300,7 +336,10 @@ describe('add to cart button loading tests', () => {
 test('renders a product bundle properly - parent item', () => {
     const parent = mockProductBundle
     renderWithProviders(
-        <MockComponent product={parent} addToCart={() => {}} addToWishlist={() => {}} />
+        <MockComponent product={parent} addToCart={() => {}} addToWishlist={() => {}} />,
+        {
+            wrapperProps: {basket: mockBasket}
+        }
     )
 
     // NOTE: there can be duplicates of the same element, due to mobile and desktop views
@@ -330,7 +369,10 @@ test('renders a product bundle properly - child item', () => {
             addToWishlist={() => {}}
             isProductPartOfBundle={true}
             setChildProductOrderability={() => {}}
-        />
+        />,
+        {
+            wrapperProps: {basket: mockBasket}
+        }
     )
 
     const addToCartButton = screen.queryByRole('button', {name: /add to cart/i})
diff --git a/packages/template-retail-react-app/app/utils/test-utils.js b/packages/template-retail-react-app/app/utils/test-utils.js
index c6105b6f37..78dbda747d 100644
--- a/packages/template-retail-react-app/app/utils/test-utils.js
+++ b/packages/template-retail-react-app/app/utils/test-utils.js
@@ -12,6 +12,7 @@ import PropTypes from 'prop-types'
 
 import theme from '@salesforce/retail-react-app/app/theme'
 import {AddToCartModalProvider} from '@salesforce/retail-react-app/app/hooks/use-add-to-cart-modal'
+import {BonusProductModalProvider} from '@salesforce/retail-react-app/app/hooks/use-bonus-product-modal'
 import {ServerContext} from '@salesforce/pwa-kit-react-sdk/ssr/universal/contexts'
 import {IntlProvider} from 'react-intl'
 import {CommerceApiProvider} from '@salesforce/commerce-sdk-react'
@@ -99,7 +100,8 @@ export const TestProviders = ({
     appConfig = mockConfig.app,
     siteAlias = DEFAULT_SITE,
     isGuest = false,
-    bypassAuth = true
+    bypassAuth = true,
+    basket = {bonusDiscountLineItems: []}
 }) => {
     const mounted = useRef()
     // We use this to track mounted state.
@@ -137,7 +139,11 @@ export const TestProviders = ({
                         <CurrencyProvider currency={DEFAULT_CURRENCY}>
                             <Router>
                                 <ChakraProvider theme={theme}>
-                                    <AddToCartModalProvider>{children}</AddToCartModalProvider>
+                                    <AddToCartModalProvider>
+                                        <BonusProductModalProvider basket={basket}>
+                                            {children}
+                                        </BonusProductModalProvider>
+                                    </AddToCartModalProvider>
                                 </ChakraProvider>
                             </Router>
                         </CurrencyProvider>
@@ -158,7 +164,8 @@ TestProviders.propTypes = {
     appConfig: PropTypes.object,
     siteAlias: PropTypes.string,
     bypassAuth: PropTypes.bool,
-    isGuest: PropTypes.bool
+    isGuest: PropTypes.bool,
+    basket: PropTypes.object
 }
 
 /**

From 2600c997c6578cf6778045e63c034c0c085dcbc0 Mon Sep 17 00:00:00 2001
From: daniel-diaz <daniel.diaz@salesforce.com>
Date: Tue, 10 Jun 2025 18:39:08 -0400
Subject: [PATCH 17/44] Fix linting issues

---
 .../app/pages/cart/index.jsx                  | 225 +++++++++---------
 1 file changed, 117 insertions(+), 108 deletions(-)

diff --git a/packages/template-retail-react-app/app/pages/cart/index.jsx b/packages/template-retail-react-app/app/pages/cart/index.jsx
index 044be99187..b266ae328e 100644
--- a/packages/template-retail-react-app/app/pages/cart/index.jsx
+++ b/packages/template-retail-react-app/app/pages/cart/index.jsx
@@ -524,6 +524,20 @@ const Cart = () => {
     if (!isLoading && !basket?.productItems?.length) {
         return <EmptyCart isRegistered={isRegistered} />
     }
+
+    // Categorize products into regular and bonus
+    const categorizedProducts = basket.productItems?.reduce(
+        (acc, productItem) => {
+            if (productItem.bonusProductLineItem) {
+                acc.bonusProducts.push(productItem)
+            } else {
+                acc.regularProducts.push(productItem)
+            }
+            return acc
+        },
+        {regularProducts: [], bonusProducts: []}
+    )
+
     return (
         <Box background="gray.50" flex="1" data-testid="sf-cart-container">
             <Container
@@ -543,119 +557,114 @@ const Cart = () => {
                             <GridItem>
                                 <Stack spacing={4}>
                                     {/* Regular Products */}
-                                    {basket.productItems
-                                        ?.filter((item) => !item.bonusProductLineItem)
-                                        .map((productItem, idx) => {
-                                            return (
-                                                <ProductItem
-                                                    key={productItem.itemId}
-                                                    index={idx}
-                                                    secondaryActions={
-                                                        <CartSecondaryButtonGroup
-                                                            isAGift={
-                                                                localIsGiftItems[productItem.itemId]
-                                                                    ? localIsGiftItems[
-                                                                          productItem.itemId
-                                                                      ]
-                                                                    : productItem.gift
-                                                            }
-                                                            onIsAGiftChange={handleIsAGiftChange}
-                                                            onAddToWishlistClick={
-                                                                handleAddToWishlist
-                                                            }
-                                                            onEditClick={(product) => {
-                                                                setSelectedItem(product)
-                                                                onOpen()
-                                                            }}
-                                                            onRemoveItemClick={handleRemoveItem}
-                                                        />
+                                    {categorizedProducts.regularProducts.map((productItem, idx) => (
+                                        <ProductItem
+                                            key={productItem.itemId}
+                                            index={idx}
+                                            secondaryActions={
+                                                <CartSecondaryButtonGroup
+                                                    isAGift={
+                                                        localIsGiftItems[productItem.itemId]
+                                                            ? localIsGiftItems[productItem.itemId]
+                                                            : productItem.gift
                                                     }
-                                                    product={{
-                                                        ...productItem,
-                                                        ...(productsByItemId &&
-                                                            productsByItemId[productItem.itemId]),
-                                                        isProductUnavailable: !isProductsLoading
-                                                            ? !productsByItemId?.[
-                                                                  productItem.itemId
-                                                              ]
-                                                            : undefined,
-                                                        price: productItem.price,
-                                                        quantity: localQuantity[productItem.itemId]
-                                                            ? localQuantity[productItem.itemId]
-                                                            : productItem.quantity
+                                                    onIsAGiftChange={handleIsAGiftChange}
+                                                    onAddToWishlistClick={handleAddToWishlist}
+                                                    onEditClick={(product) => {
+                                                        setSelectedItem(product)
+                                                        onOpen()
                                                     }}
-                                                    onItemQuantityChange={handleChangeItemQuantity.bind(
-                                                        this,
-                                                        productItem
-                                                    )}
-                                                    showLoading={
-                                                        isCartItemLoading &&
-                                                        selectedItem?.itemId === productItem.itemId
-                                                    }
-                                                    handleRemoveItem={handleRemoveItem}
+                                                    onRemoveItemClick={handleRemoveItem}
                                                 />
-                                            )
-                                        })}
-
-                                    {/* Bonus Products Title */}
-                                    {basket.productItems?.some(
-                                        (item) => item.bonusProductLineItem
-                                    ) && (
-                                        <Box>
-                                            <BonusProductsTitle />
-                                        </Box>
-                                    )}
+                                            }
+                                            product={{
+                                                ...productItem,
+                                                ...(productsByItemId &&
+                                                    productsByItemId[productItem.itemId]),
+                                                isProductUnavailable: !isProductsLoading
+                                                    ? !productsByItemId?.[productItem.itemId]
+                                                    : undefined,
+                                                price: productItem.price,
+                                                quantity: localQuantity[productItem.itemId]
+                                                    ? localQuantity[productItem.itemId]
+                                                    : productItem.quantity
+                                            }}
+                                            onItemQuantityChange={handleChangeItemQuantity.bind(
+                                                this,
+                                                productItem
+                                            )}
+                                            showLoading={
+                                                isCartItemLoading &&
+                                                selectedItem?.itemId === productItem.itemId
+                                            }
+                                            handleRemoveItem={handleRemoveItem}
+                                        />
+                                    ))}
 
                                     {/* Bonus Products */}
-                                    {basket.productItems
-                                        ?.filter((item) => item.bonusProductLineItem)
-                                        .map((productItem, idx) => {
-                                            return (
-                                                <ProductItem
-                                                    key={productItem.itemId}
-                                                    index={idx}
-                                                    secondaryActions={
-                                                        <CartSecondaryButtonGroup
-                                                            isAGift={
-                                                                localIsGiftItems[productItem.itemId]
-                                                                    ? localIsGiftItems[
-                                                                          productItem.itemId
-                                                                      ]
-                                                                    : productItem.gift
-                                                            }
-                                                            onIsAGiftChange={handleIsAGiftChange}
-                                                            onAddToWishlistClick={
-                                                                handleAddToWishlist
-                                                            }
-                                                            onEditClick={(product) => {
-                                                                setSelectedItem(product)
-                                                                onOpen()
-                                                            }}
-                                                            onRemoveItemClick={handleRemoveItem}
-                                                        />
-                                                    }
-                                                    product={{
-                                                        ...productItem,
-                                                        ...(productsByItemId &&
-                                                            productsByItemId[productItem.itemId]),
-                                                        isProductUnavailable: !isProductsLoading
-                                                            ? !productsByItemId?.[
-                                                                  productItem.itemId
-                                                              ]
-                                                            : undefined,
-                                                        price: productItem.price,
-                                                        quantity: localQuantity[productItem.itemId]
-                                                            ? localQuantity[productItem.itemId]
-                                                            : productItem.quantity
-                                                    }}
-                                                    showLoading={
-                                                        isCartItemLoading &&
-                                                        selectedItem?.itemId === productItem.itemId
-                                                    }
-                                                    handleRemoveItem={handleRemoveItem}
-                                                />
-                                            )
-                                        })}
+                                    {categorizedProducts.bonusProducts.length > 0 && (
+                                        <>
+                                            <Box>
+                                                <BonusProductsTitle />
+                                            </Box>
+                                            {categorizedProducts.bonusProducts.map(
+                                                (productItem, idx) => (
+                                                    <ProductItem
+                                                        key={productItem.itemId}
+                                                        index={idx}
+                                                        secondaryActions={
+                                                            <CartSecondaryButtonGroup
+                                                                isAGift={
+                                                                    localIsGiftItems[
+                                                                        productItem.itemId
+                                                                    ]
+                                                                        ? localIsGiftItems[
+                                                                              productItem.itemId
+                                                                          ]
+                                                                        : productItem.gift
+                                                                }
+                                                                onIsAGiftChange={
+                                                                    handleIsAGiftChange
+                                                                }
+                                                                onAddToWishlistClick={
+                                                                    handleAddToWishlist
+                                                                }
+                                                                onEditClick={(product) => {
+                                                                    setSelectedItem(product)
+                                                                    onOpen()
+                                                                }}
+                                                                onRemoveItemClick={handleRemoveItem}
+                                                            />
+                                                        }
+                                                        product={{
+                                                            ...productItem,
+                                                            ...(productsByItemId &&
+                                                                productsByItemId[
+                                                                    productItem.itemId
+                                                                ]),
+                                                            isProductUnavailable: !isProductsLoading
+                                                                ? !productsByItemId?.[
+                                                                      productItem.itemId
+                                                                  ]
+                                                                : undefined,
+                                                            price: productItem.price,
+                                                            quantity: localQuantity[
+                                                                productItem.itemId
+                                                            ]
+                                                                ? localQuantity[productItem.itemId]
+                                                                : productItem.quantity
+                                                        }}
+                                                        showLoading={
+                                                            isCartItemLoading &&
+                                                            selectedItem?.itemId ===
+                                                                productItem.itemId
+                                                        }
+                                                        handleRemoveItem={handleRemoveItem}
+                                                    />
+                                                )
+                                            )}
+                                        </>
+                                    )}
                                 </Stack>
                                 <Box>
                                     {isOpen && !selectedItem.bundledProductItems && (

From bd8f645b49ab803036d0102994576ef85ef72394 Mon Sep 17 00:00:00 2001
From: madhuri-uppu <madhuri.uppu@salesforce.com>
Date: Tue, 10 Jun 2025 15:50:57 -0700
Subject: [PATCH 18/44] fixed a unit test

---
 .../app/components/product-view/index.jsx     | 12 ++++++----
 .../app/pages/product-detail/index.test.js    | 22 ++++++++++++-------
 2 files changed, 22 insertions(+), 12 deletions(-)

diff --git a/packages/template-retail-react-app/app/components/product-view/index.jsx b/packages/template-retail-react-app/app/components/product-view/index.jsx
index ff19cd84c6..767fdd96be 100644
--- a/packages/template-retail-react-app/app/components/product-view/index.jsx
+++ b/packages/template-retail-react-app/app/components/product-view/index.jsx
@@ -281,9 +281,14 @@ const ProductView = forwardRef(
                 }
                 try {
                     const addToCartResponse = await addToCart(variant, quantity)
-                    const itemsAdded = addToCartResponse?.productSelectionValues
+                    
+                    // For regular products: addToCartResponse has productSelectionValues and possibly bonusDiscountLineItems
+                    // For product bundles: addToCartResponse is just the childProductSelections array
+                    const itemsAdded = addToCartResponse?.productSelectionValues || addToCartResponse
+                    const isValidResponse = itemsAdded && (Array.isArray(itemsAdded) || itemsAdded.length > 0)
 
                     // Compare existing bonus products with new bonus discount line items
+                    // Only regular products (not bundles) can have bonusDiscountLineItems
                     const newBonusItems =
                         addToCartResponse?.bonusDiscountLineItems?.filter(
                             (newItem) =>
@@ -292,11 +297,10 @@ const ProductView = forwardRef(
                                 )
                         ) || []
 
-                    if (itemsAdded) {
+                    if (isValidResponse) {
                         // Show bonus product modal first if there are bonus items
                         if (newBonusItems?.length > 0) {
-                            // Modify this logic and update bonusProducts list in localStorage with the new bonus items
-                            // that are added to the cart
+                            // Update bonusProducts list with the new bonus items
                             addBonusProducts(newBonusItems)
                             onBonusProductModalOpen({
                                 newBonusItems,
diff --git a/packages/template-retail-react-app/app/pages/product-detail/index.test.js b/packages/template-retail-react-app/app/pages/product-detail/index.test.js
index 2699837c24..6d035240cc 100644
--- a/packages/template-retail-react-app/app/pages/product-detail/index.test.js
+++ b/packages/template-retail-react-app/app/pages/product-detail/index.test.js
@@ -55,6 +55,8 @@ jest.mock('@salesforce/retail-react-app/app/constants', () => {
     }
 })
 
+const mockBasket = {bonusDiscountLineItems: []}
+
 const MockedComponent = () => {
     return (
         <Switch>
@@ -106,7 +108,7 @@ test('should render product details page', async () => {
         })
     )
 
-    renderWithProviders(<MockedComponent />)
+    renderWithProviders(<MockedComponent />, {wrapperProps: {basket: mockBasket}})
 
     expect(await screen.findByTestId('product-details-page')).toBeInTheDocument()
     await waitFor(() => {
@@ -129,7 +131,7 @@ test('should add to wishlist', async () => {
         })
     )
 
-    renderWithProviders(<MockedComponent />)
+    renderWithProviders(<MockedComponent />, {wrapperProps: {basket: mockBasket}})
     expect(await screen.findByTestId('product-details-page')).toBeInTheDocument()
     // wait for data to fully loaded before taking any action
     await waitFor(() => {
@@ -156,7 +158,7 @@ test('should not add to wishlist if item is already in wishlist', async () => {
         })
     )
 
-    renderWithProviders(<MockedComponent />)
+    renderWithProviders(<MockedComponent />, {wrapperProps: {basket: mockBasket}})
     // wait for data to fully loaded before taking any action
     await waitFor(() => {
         expect(screen.getByRole('link', {name: /mens/i})).toBeInTheDocument()
@@ -182,7 +184,7 @@ describe('product set', () => {
     })
 
     test('render multi-product layout', async () => {
-        renderWithProviders(<MockedComponent />)
+        renderWithProviders(<MockedComponent />, {wrapperProps: {basket: mockBasket}})
 
         await waitFor(() => {
             expect(screen.getByRole('link', {name: /mens/i})).toBeInTheDocument()
@@ -202,7 +204,9 @@ describe('product set', () => {
 
         // Initial basket is necessary to add items to it
         const initialBasket = {basketId: 'valid_id'}
-        renderWithProviders(<MockedComponent />, {wrapperProps: {initialBasket}})
+        renderWithProviders(<MockedComponent />, {
+            wrapperProps: {basket: {...mockBasket, ...initialBasket}}
+        })
 
         await waitFor(
             () => {
@@ -236,7 +240,7 @@ describe('product set', () => {
     })
 
     test('add the set to cart with error messages', async () => {
-        renderWithProviders(<MockedComponent />)
+        renderWithProviders(<MockedComponent />, {wrapperProps: {basket: mockBasket}})
 
         await waitFor(
             () => {
@@ -258,7 +262,7 @@ describe('product set', () => {
     })
 
     test("child products' images are lazy loaded", async () => {
-        renderWithProviders(<MockedComponent />)
+        renderWithProviders(<MockedComponent />, {wrapperProps: {basket: mockBasket}})
         await waitFor(() => {
             expect(screen.getByRole('link', {name: /mens/i})).toBeInTheDocument()
         })
@@ -373,7 +377,9 @@ describe('product bundles', () => {
 
         // Initial basket is necessary to add items to it
         const initialBasket = {basketId: 'valid_id'}
-        renderWithProviders(<MockedComponent />, {wrapperProps: {initialBasket}})
+        renderWithProviders(<MockedComponent />, {
+            wrapperProps: {basket: {...mockBasket, ...initialBasket}}
+        })
 
         await waitFor(() => {
             expect(screen.getAllByText("Women's clothing test bundle")[0]).toBeInTheDocument()

From 392c52f2f68a3ed56c8f46c5bc85b7280344f974 Mon Sep 17 00:00:00 2001
From: madhuri-uppu <madhuri.uppu@salesforce.com>
Date: Tue, 10 Jun 2025 16:08:26 -0700
Subject: [PATCH 19/44] fixed lint errors

---
 .../app/components/product-view/index.jsx                 | 8 +++++---
 1 file changed, 5 insertions(+), 3 deletions(-)

diff --git a/packages/template-retail-react-app/app/components/product-view/index.jsx b/packages/template-retail-react-app/app/components/product-view/index.jsx
index 767fdd96be..81a1e7350b 100644
--- a/packages/template-retail-react-app/app/components/product-view/index.jsx
+++ b/packages/template-retail-react-app/app/components/product-view/index.jsx
@@ -281,11 +281,13 @@ const ProductView = forwardRef(
                 }
                 try {
                     const addToCartResponse = await addToCart(variant, quantity)
-                    
+
                     // For regular products: addToCartResponse has productSelectionValues and possibly bonusDiscountLineItems
                     // For product bundles: addToCartResponse is just the childProductSelections array
-                    const itemsAdded = addToCartResponse?.productSelectionValues || addToCartResponse
-                    const isValidResponse = itemsAdded && (Array.isArray(itemsAdded) || itemsAdded.length > 0)
+                    const itemsAdded =
+                        addToCartResponse?.productSelectionValues || addToCartResponse
+                    const isValidResponse =
+                        itemsAdded && (Array.isArray(itemsAdded) || itemsAdded.length > 0)
 
                     // Compare existing bonus products with new bonus discount line items
                     // Only regular products (not bundles) can have bonusDiscountLineItems

From 90226ae947315069361da9d37bb2050e5df703d6 Mon Sep 17 00:00:00 2001
From: daniel-diaz <daniel.diaz@salesforce.com>
Date: Wed, 11 Jun 2025 15:52:50 -0400
Subject: [PATCH 20/44] Moved mock data, removed un-needed index

---
 .../app/mocks/mock-data.js                    | 49 +++++++++++++++++
 .../app/pages/cart/index.jsx                  |  6 +--
 .../app/pages/cart/index.test.js              | 52 +------------------
 3 files changed, 53 insertions(+), 54 deletions(-)

diff --git a/packages/template-retail-react-app/app/mocks/mock-data.js b/packages/template-retail-react-app/app/mocks/mock-data.js
index 0539350d5a..21c142e68a 100644
--- a/packages/template-retail-react-app/app/mocks/mock-data.js
+++ b/packages/template-retail-react-app/app/mocks/mock-data.js
@@ -5711,3 +5711,52 @@ export const mockPasswordUpdateFalure = {
     detail: 'The update password request is invalid. Customer\u0027s current password is not valid',
     errorMessage: 'Customer\u0027s current password is not valid'
 }
+
+export const mockBonusProductBasket = {
+    baskets: [
+        {
+            ...mockCustomerBaskets.baskets[0],
+            productItems: [
+                {
+                    adjustedTax: 2.93,
+                    basePrice: 61.43,
+                    bonusProductLineItem: false,
+                    gift: false,
+                    itemId: '4a9af0a24fe46c3f6d8721b371',
+                    itemText: 'Belted Cardigan With Studs',
+                    price: 61.43,
+                    priceAfterItemDiscount: 61.43,
+                    priceAfterOrderDiscount: 61.43,
+                    productId: '701642889830M',
+                    productName: 'Belted Cardigan With Studs',
+                    quantity: 2,
+                    shipmentId: 'me',
+                    tax: 2.93,
+                    taxBasis: 61.43,
+                    taxClassId: 'standard',
+                    taxRate: 0.05
+                },
+                {
+                    adjustedTax: 0,
+                    basePrice: 0,
+                    bonusProductLineItem: true,
+                    gift: false,
+                    itemId: '5b1a03848f0807f99f37ea93e4',
+                    itemText: 'Free Gift with Purchase',
+                    price: 0,
+                    priceAfterItemDiscount: 0,
+                    priceAfterOrderDiscount: 0,
+                    productId: '013742335262M',
+                    productName: 'Free Gift with Purchase',
+                    quantity: 1,
+                    shipmentId: 'me',
+                    tax: 0,
+                    taxBasis: 0,
+                    taxClassId: 'standard',
+                    taxRate: 0.05
+                }
+            ]
+        }
+    ],
+    total: 1
+}
diff --git a/packages/template-retail-react-app/app/pages/cart/index.jsx b/packages/template-retail-react-app/app/pages/cart/index.jsx
index b266ae328e..efd365a96b 100644
--- a/packages/template-retail-react-app/app/pages/cart/index.jsx
+++ b/packages/template-retail-react-app/app/pages/cart/index.jsx
@@ -557,10 +557,9 @@ const Cart = () => {
                             <GridItem>
                                 <Stack spacing={4}>
                                     {/* Regular Products */}
-                                    {categorizedProducts.regularProducts.map((productItem, idx) => (
+                                    {categorizedProducts.regularProducts.map((productItem) => (
                                         <ProductItem
                                             key={productItem.itemId}
-                                            index={idx}
                                             secondaryActions={
                                                 <CartSecondaryButtonGroup
                                                     isAGift={
@@ -608,10 +607,9 @@ const Cart = () => {
                                                 <BonusProductsTitle />
                                             </Box>
                                             {categorizedProducts.bonusProducts.map(
-                                                (productItem, idx) => (
+                                                (productItem) => (
                                                     <ProductItem
                                                         key={productItem.itemId}
-                                                        index={idx}
                                                         secondaryActions={
                                                             <CartSecondaryButtonGroup
                                                                 isAGift={
diff --git a/packages/template-retail-react-app/app/pages/cart/index.test.js b/packages/template-retail-react-app/app/pages/cart/index.test.js
index a0ac52e576..59ffe9ac94 100644
--- a/packages/template-retail-react-app/app/pages/cart/index.test.js
+++ b/packages/template-retail-react-app/app/pages/cart/index.test.js
@@ -14,7 +14,8 @@ import {
     mockCustomerBaskets,
     mockEmptyBasket,
     mockCartVariant,
-    mockedCustomerProductLists
+    mockedCustomerProductLists,
+    mockBonusProductBasket
 } from '@salesforce/retail-react-app/app/mocks/mock-data'
 import mockVariant from '@salesforce/retail-react-app/app/mocks/variant-750518699578M'
 import {rest} from 'msw'
@@ -68,55 +69,6 @@ const mockProductBundleBasket = {
     total: 1
 }
 
-const mockBonusProductBasket = {
-    baskets: [
-        {
-            ...mockCustomerBaskets.baskets[0],
-            productItems: [
-                {
-                    adjustedTax: 2.93,
-                    basePrice: 61.43,
-                    bonusProductLineItem: false,
-                    gift: false,
-                    itemId: '4a9af0a24fe46c3f6d8721b371',
-                    itemText: 'Belted Cardigan With Studs',
-                    price: 61.43,
-                    priceAfterItemDiscount: 61.43,
-                    priceAfterOrderDiscount: 61.43,
-                    productId: '701642889830M',
-                    productName: 'Belted Cardigan With Studs',
-                    quantity: 2,
-                    shipmentId: 'me',
-                    tax: 2.93,
-                    taxBasis: 61.43,
-                    taxClassId: 'standard',
-                    taxRate: 0.05
-                },
-                {
-                    adjustedTax: 0,
-                    basePrice: 0,
-                    bonusProductLineItem: true,
-                    gift: false,
-                    itemId: '5b1a03848f0807f99f37ea93e4',
-                    itemText: 'Free Gift with Purchase',
-                    price: 0,
-                    priceAfterItemDiscount: 0,
-                    priceAfterOrderDiscount: 0,
-                    productId: '013742335262M',
-                    productName: 'Free Gift with Purchase',
-                    quantity: 1,
-                    shipmentId: 'me',
-                    tax: 0,
-                    taxBasis: 0,
-                    taxClassId: 'standard',
-                    taxRate: 0.05
-                }
-            ]
-        }
-    ],
-    total: 1
-}
-
 // Set up and clean up
 beforeEach(() => {
     global.server.use(

From 9414838bf7641d68add32e033f3483ba0a3a5349 Mon Sep 17 00:00:00 2001
From: madhuri-uppu <madhuri.uppu@salesforce.com>
Date: Wed, 11 Jun 2025 14:40:22 -0700
Subject: [PATCH 21/44] Addressed PR comments

---
 .../app/components/product-view/index.jsx     |  6 ++--
 .../app/hooks/use-bonus-product-modal.js      |  4 +--
 .../app/hooks/use-bonus-product-modal.test.js | 29 ++++++++++---------
 .../app/mocks/mock-data.js                    |  3 +-
 .../app/pages/product-detail/index.test.js    | 22 +++++++-------
 5 files changed, 33 insertions(+), 31 deletions(-)

diff --git a/packages/template-retail-react-app/app/components/product-view/index.jsx b/packages/template-retail-react-app/app/components/product-view/index.jsx
index 81a1e7350b..c456706bba 100644
--- a/packages/template-retail-react-app/app/components/product-view/index.jsx
+++ b/packages/template-retail-react-app/app/components/product-view/index.jsx
@@ -299,6 +299,9 @@ const ProductView = forwardRef(
                                 )
                         ) || []
 
+                    // Open modal only when `addToCart` returns some data
+                    // It's possible that the item has been added to cart, but we don't want to open the modal.
+                    // See wishlist_primary_action for example.
                     if (isValidResponse) {
                         // Show bonus product modal first if there are bonus items
                         if (newBonusItems?.length > 0) {
@@ -402,9 +405,6 @@ const ProductView = forwardRef(
             if (isAddToCartModalOpen) {
                 onAddToCartModalClose()
             }
-        }, [location.pathname])
-
-        useEffect(() => {
             if (isBonusProductModalOpen) {
                 onBonusProductModalClose()
             }
diff --git a/packages/template-retail-react-app/app/hooks/use-bonus-product-modal.js b/packages/template-retail-react-app/app/hooks/use-bonus-product-modal.js
index 238aa2b8cf..559a195f1f 100644
--- a/packages/template-retail-react-app/app/hooks/use-bonus-product-modal.js
+++ b/packages/template-retail-react-app/app/hooks/use-bonus-product-modal.js
@@ -6,6 +6,8 @@
  */
 import React, {useContext, useState, useEffect} from 'react'
 import {useLocation} from 'react-router-dom'
+import {useAddToCartModalContext} from '@salesforce/retail-react-app/app/hooks/use-add-to-cart-modal'
+import PropTypes from 'prop-types'
 import {
     Modal,
     ModalCloseButton,
@@ -16,8 +18,6 @@ import {
     ModalBody,
     Heading
 } from '@salesforce/retail-react-app/app/components/shared/ui'
-import {useAddToCartModalContext} from '@salesforce/retail-react-app/app/hooks/use-add-to-cart-modal'
-import PropTypes from 'prop-types'
 
 export const BonusProductModalContext = React.createContext()
 
diff --git a/packages/template-retail-react-app/app/hooks/use-bonus-product-modal.test.js b/packages/template-retail-react-app/app/hooks/use-bonus-product-modal.test.js
index fc636038ca..d242b7af53 100644
--- a/packages/template-retail-react-app/app/hooks/use-bonus-product-modal.test.js
+++ b/packages/template-retail-react-app/app/hooks/use-bonus-product-modal.test.js
@@ -33,7 +33,7 @@ describe('useBonusState', () => {
         useLocation.mockReturnValue({pathname: '/initial'})
     })
 
-    it('initializes with correct state from basket', () => {
+    test('initializes with correct state from basket', () => {
         const basket = {bonusDiscountLineItems: [{id: 'b1'}]}
         const {result} = renderHook(() => useBonusState(basket))
         expect(result.current.isOpen).toBe(false)
@@ -41,7 +41,7 @@ describe('useBonusState', () => {
         expect(result.current.bonusProducts).toEqual([{id: 'b1'}])
     })
 
-    it('updates bonusProducts when basket changes', () => {
+    test('updates bonusProducts when basket changes', () => {
         const {result, rerender} = renderHook(({basket}) => useBonusState(basket), {
             initialProps: {basket: {bonusDiscountLineItems: [{id: 'b1'}]}}
         })
@@ -49,7 +49,7 @@ describe('useBonusState', () => {
         expect(result.current.bonusProducts).toEqual([{id: 'b2'}])
     })
 
-    it('addBonusProducts adds items', () => {
+    test('addBonusProducts adds items', () => {
         const {result} = renderHook(() => useBonusState())
         act(() => {
             result.current.addBonusProducts([{id: 'b3'}])
@@ -57,7 +57,7 @@ describe('useBonusState', () => {
         expect(result.current.bonusProducts).toEqual([{id: 'b3'}])
     })
 
-    it('clearBonusProducts empties bonusProducts', () => {
+    test('clearBonusProducts empties bonusProducts', () => {
         const {result} = renderHook(() => useBonusState())
         act(() => {
             result.current.addBonusProducts([{id: 'b4'}])
@@ -68,7 +68,7 @@ describe('useBonusState', () => {
         expect(result.current.bonusProducts).toEqual([])
     })
 
-    it('onOpen sets modal open and stores data', () => {
+    test('onOpen sets modal open and stores data', () => {
         const {result} = renderHook(() => useBonusState())
         act(() => {
             result.current.onOpen({foo: 'bar'})
@@ -77,7 +77,7 @@ describe('useBonusState', () => {
         expect(result.current.data).toEqual({foo: 'bar'})
     })
 
-    it('onClose closes modal and clears data', () => {
+    test('onClose closes modal and clears data', () => {
         const {result} = renderHook(() => useBonusState())
         act(() => {
             result.current.onOpen({foo: 'bar'})
@@ -89,7 +89,7 @@ describe('useBonusState', () => {
         expect(result.current.data).toEqual({})
     })
 
-    it('onClose calls onAddToCartModalOpen if needed', () => {
+    test('onClose calls onAddToCartModalOpen if needed', () => {
         const {result} = renderHook(() => useBonusState())
         const data = {
             openAddToCartModalIfNeeded: true,
@@ -110,23 +110,26 @@ describe('useBonusState', () => {
         })
     })
 
-    it('closes modal on location change', () => {
-        let location = {pathname: '/foo'}
-        useLocation.mockImplementation(() => location)
+    test('closes modal on location change', () => {
+        // Initial location
+        useLocation.mockReturnValue({pathname: '/foo'})
         const {result, rerender} = renderHook(() => useBonusState())
+
         act(() => {
             result.current.onOpen({foo: 'bar'})
         })
         expect(result.current.isOpen).toBe(true)
-        // Simulate location change
-        location = {pathname: '/bar'}
+
+        // Change location
+        useLocation.mockReturnValue({pathname: '/bar'})
         rerender()
+
         expect(result.current.isOpen).toBe(false)
     })
 })
 
 describe('BonusProductModalProvider', () => {
-    it('provides context to children', () => {
+    test('provides context to children', () => {
         const basket = {bonusDiscountLineItems: [{id: 'b1'}]}
         const TestChild = () => {
             const ctx = useBonusProductModalContext()
diff --git a/packages/template-retail-react-app/app/mocks/mock-data.js b/packages/template-retail-react-app/app/mocks/mock-data.js
index 0539350d5a..b00bae5e87 100644
--- a/packages/template-retail-react-app/app/mocks/mock-data.js
+++ b/packages/template-retail-react-app/app/mocks/mock-data.js
@@ -5392,7 +5392,8 @@ export const mockCustomerBaskets = {
             shippingTotal: null,
             shippingTotalTax: null,
             taxation: 'gross',
-            taxTotal: null
+            taxTotal: null,
+            bonusDiscountLineItems: []
         }
     ],
     total: 1
diff --git a/packages/template-retail-react-app/app/pages/product-detail/index.test.js b/packages/template-retail-react-app/app/pages/product-detail/index.test.js
index 6d035240cc..f3a4bfc2b3 100644
--- a/packages/template-retail-react-app/app/pages/product-detail/index.test.js
+++ b/packages/template-retail-react-app/app/pages/product-detail/index.test.js
@@ -55,8 +55,6 @@ jest.mock('@salesforce/retail-react-app/app/constants', () => {
     }
 })
 
-const mockBasket = {bonusDiscountLineItems: []}
-
 const MockedComponent = () => {
     return (
         <Switch>
@@ -108,7 +106,7 @@ test('should render product details page', async () => {
         })
     )
 
-    renderWithProviders(<MockedComponent />, {wrapperProps: {basket: mockBasket}})
+    renderWithProviders(<MockedComponent />)
 
     expect(await screen.findByTestId('product-details-page')).toBeInTheDocument()
     await waitFor(() => {
@@ -131,7 +129,7 @@ test('should add to wishlist', async () => {
         })
     )
 
-    renderWithProviders(<MockedComponent />, {wrapperProps: {basket: mockBasket}})
+    renderWithProviders(<MockedComponent />)
     expect(await screen.findByTestId('product-details-page')).toBeInTheDocument()
     // wait for data to fully loaded before taking any action
     await waitFor(() => {
@@ -158,7 +156,7 @@ test('should not add to wishlist if item is already in wishlist', async () => {
         })
     )
 
-    renderWithProviders(<MockedComponent />, {wrapperProps: {basket: mockBasket}})
+    renderWithProviders(<MockedComponent />)
     // wait for data to fully loaded before taking any action
     await waitFor(() => {
         expect(screen.getByRole('link', {name: /mens/i})).toBeInTheDocument()
@@ -184,7 +182,7 @@ describe('product set', () => {
     })
 
     test('render multi-product layout', async () => {
-        renderWithProviders(<MockedComponent />, {wrapperProps: {basket: mockBasket}})
+        renderWithProviders(<MockedComponent />)
 
         await waitFor(() => {
             expect(screen.getByRole('link', {name: /mens/i})).toBeInTheDocument()
@@ -203,9 +201,9 @@ describe('product set', () => {
         window.history.pushState({}, 'ProductDetail', urlPathAfterSelectingAllVariants)
 
         // Initial basket is necessary to add items to it
-        const initialBasket = {basketId: 'valid_id'}
+        const initialBasket = {basketId: 'valid_id', bonusDiscountLineItems: []}
         renderWithProviders(<MockedComponent />, {
-            wrapperProps: {basket: {...mockBasket, ...initialBasket}}
+            wrapperProps: {basket: initialBasket}
         })
 
         await waitFor(
@@ -240,7 +238,7 @@ describe('product set', () => {
     })
 
     test('add the set to cart with error messages', async () => {
-        renderWithProviders(<MockedComponent />, {wrapperProps: {basket: mockBasket}})
+        renderWithProviders(<MockedComponent />)
 
         await waitFor(
             () => {
@@ -262,7 +260,7 @@ describe('product set', () => {
     })
 
     test("child products' images are lazy loaded", async () => {
-        renderWithProviders(<MockedComponent />, {wrapperProps: {basket: mockBasket}})
+        renderWithProviders(<MockedComponent />)
         await waitFor(() => {
             expect(screen.getByRole('link', {name: /mens/i})).toBeInTheDocument()
         })
@@ -376,9 +374,9 @@ describe('product bundles', () => {
         window.history.pushState({}, 'ProductDetail', urlPathAfterSelectingAllVariants)
 
         // Initial basket is necessary to add items to it
-        const initialBasket = {basketId: 'valid_id'}
+        const initialBasket = {basketId: 'valid_id', bonusDiscountLineItems: []}
         renderWithProviders(<MockedComponent />, {
-            wrapperProps: {basket: {...mockBasket, ...initialBasket}}
+            wrapperProps: {basket: initialBasket}
         })
 
         await waitFor(() => {

From f8fd65e5c261affd6960acfa3a93b633ffe61306 Mon Sep 17 00:00:00 2001
From: madhuri-uppu <madhuri.uppu@salesforce.com>
Date: Wed, 11 Jun 2025 16:10:34 -0700
Subject: [PATCH 22/44] use current basket query

---
 .../app/components/_app/index.jsx             |  2 +-
 .../app/hooks/use-bonus-product-modal.js      | 15 +++-----
 .../app/hooks/use-bonus-product-modal.test.js | 35 ++-----------------
 .../app/utils/test-utils.js                   |  2 +-
 4 files changed, 9 insertions(+), 45 deletions(-)

diff --git a/packages/template-retail-react-app/app/components/_app/index.jsx b/packages/template-retail-react-app/app/components/_app/index.jsx
index adf086bf87..957155e7b3 100644
--- a/packages/template-retail-react-app/app/components/_app/index.jsx
+++ b/packages/template-retail-react-app/app/components/_app/index.jsx
@@ -414,7 +414,7 @@ const App = (props) => {
                             </Box>
                             {!isOnline && <OfflineBanner />}
                             <AddToCartModalProvider>
-                                <BonusProductModalProvider basket={basket}>
+                                <BonusProductModalProvider>
                                     <SkipNavContent
                                         style={{
                                             display: 'flex',
diff --git a/packages/template-retail-react-app/app/hooks/use-bonus-product-modal.js b/packages/template-retail-react-app/app/hooks/use-bonus-product-modal.js
index 559a195f1f..f3e93a86de 100644
--- a/packages/template-retail-react-app/app/hooks/use-bonus-product-modal.js
+++ b/packages/template-retail-react-app/app/hooks/use-bonus-product-modal.js
@@ -8,6 +8,7 @@ import React, {useContext, useState, useEffect} from 'react'
 import {useLocation} from 'react-router-dom'
 import {useAddToCartModalContext} from '@salesforce/retail-react-app/app/hooks/use-add-to-cart-modal'
 import PropTypes from 'prop-types'
+import {useCurrentBasket} from '@salesforce/retail-react-app/app/hooks/use-current-basket'
 import {
     Modal,
     ModalCloseButton,
@@ -23,7 +24,8 @@ export const BonusProductModalContext = React.createContext()
 
 export const useBonusProductModalContext = () => useContext(BonusProductModalContext)
 
-export const BonusProductModalProvider = ({children, basket}) => {
+export const BonusProductModalProvider = ({children}) => {
+    const {data: basket} = useCurrentBasket()
     const bonusProductState = useBonusState(basket)
 
     return (
@@ -34,8 +36,7 @@ export const BonusProductModalProvider = ({children, basket}) => {
     )
 }
 BonusProductModalProvider.propTypes = {
-    children: PropTypes.node.isRequired,
-    basket: PropTypes.object
+    children: PropTypes.node.isRequired
 }
 
 export const BonusProductModal = () => {
@@ -101,19 +102,11 @@ export const useBonusState = (basket) => {
         })
     }
 
-    const clearBonusProducts = () => {
-        setState((prev) => ({
-            ...prev,
-            bonusProducts: []
-        }))
-    }
-
     return {
         isOpen: state.isOpen,
         data: state.data,
         bonusProducts: state.bonusProducts,
         addBonusProducts,
-        clearBonusProducts,
         onClose: () => {
             setState((prev) => ({
                 ...prev,
diff --git a/packages/template-retail-react-app/app/hooks/use-bonus-product-modal.test.js b/packages/template-retail-react-app/app/hooks/use-bonus-product-modal.test.js
index d242b7af53..d8a4008003 100644
--- a/packages/template-retail-react-app/app/hooks/use-bonus-product-modal.test.js
+++ b/packages/template-retail-react-app/app/hooks/use-bonus-product-modal.test.js
@@ -5,14 +5,14 @@
  * For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/BSD-3-Clause
  */
 import React from 'react'
-import {renderHook, act, render} from '@testing-library/react'
+import {renderHook, act} from '@testing-library/react'
 import {ChakraProvider} from '@chakra-ui/react'
 import {useLocation} from 'react-router-dom'
+import {renderWithProviders} from '@salesforce/retail-react-app/app/utils/test-utils'
 import {
     useBonusState,
     BonusProductModalProvider,
-    useBonusProductModalContext,
-    BonusProductModal
+    useBonusProductModalContext
 } from '@salesforce/retail-react-app/app/hooks/use-bonus-product-modal'
 
 // Mock react-router-dom's useLocation
@@ -57,17 +57,6 @@ describe('useBonusState', () => {
         expect(result.current.bonusProducts).toEqual([{id: 'b3'}])
     })
 
-    test('clearBonusProducts empties bonusProducts', () => {
-        const {result} = renderHook(() => useBonusState())
-        act(() => {
-            result.current.addBonusProducts([{id: 'b4'}])
-        })
-        act(() => {
-            result.current.clearBonusProducts()
-        })
-        expect(result.current.bonusProducts).toEqual([])
-    })
-
     test('onOpen sets modal open and stores data', () => {
         const {result} = renderHook(() => useBonusState())
         act(() => {
@@ -127,21 +116,3 @@ describe('useBonusState', () => {
         expect(result.current.isOpen).toBe(false)
     })
 })
-
-describe('BonusProductModalProvider', () => {
-    test('provides context to children', () => {
-        const basket = {bonusDiscountLineItems: [{id: 'b1'}]}
-        const TestChild = () => {
-            const ctx = useBonusProductModalContext()
-            return <div data-testid="ctx">{JSON.stringify(ctx.bonusProducts)}</div>
-        }
-        const {getByTestId} = render(
-            <ChakraProvider>
-                <BonusProductModalProvider basket={basket}>
-                    <TestChild />
-                </BonusProductModalProvider>
-            </ChakraProvider>
-        )
-        expect(getByTestId('ctx').textContent).toContain('b1')
-    })
-})
diff --git a/packages/template-retail-react-app/app/utils/test-utils.js b/packages/template-retail-react-app/app/utils/test-utils.js
index 78dbda747d..130ba7278f 100644
--- a/packages/template-retail-react-app/app/utils/test-utils.js
+++ b/packages/template-retail-react-app/app/utils/test-utils.js
@@ -140,7 +140,7 @@ export const TestProviders = ({
                             <Router>
                                 <ChakraProvider theme={theme}>
                                     <AddToCartModalProvider>
-                                        <BonusProductModalProvider basket={basket}>
+                                        <BonusProductModalProvider>
                                             {children}
                                         </BonusProductModalProvider>
                                     </AddToCartModalProvider>

From e441ee96916eb2084cdd6ecd27fa7bfef07f8fb2 Mon Sep 17 00:00:00 2001
From: madhuri-uppu <madhuri.uppu@salesforce.com>
Date: Wed, 11 Jun 2025 16:20:32 -0700
Subject: [PATCH 23/44] nit

---
 packages/template-retail-react-app/app/mocks/mock-data.js  | 3 +--
 packages/template-retail-react-app/app/utils/test-utils.js | 6 ++----
 2 files changed, 3 insertions(+), 6 deletions(-)

diff --git a/packages/template-retail-react-app/app/mocks/mock-data.js b/packages/template-retail-react-app/app/mocks/mock-data.js
index b00bae5e87..0539350d5a 100644
--- a/packages/template-retail-react-app/app/mocks/mock-data.js
+++ b/packages/template-retail-react-app/app/mocks/mock-data.js
@@ -5392,8 +5392,7 @@ export const mockCustomerBaskets = {
             shippingTotal: null,
             shippingTotalTax: null,
             taxation: 'gross',
-            taxTotal: null,
-            bonusDiscountLineItems: []
+            taxTotal: null
         }
     ],
     total: 1
diff --git a/packages/template-retail-react-app/app/utils/test-utils.js b/packages/template-retail-react-app/app/utils/test-utils.js
index 130ba7278f..febcb7f4dc 100644
--- a/packages/template-retail-react-app/app/utils/test-utils.js
+++ b/packages/template-retail-react-app/app/utils/test-utils.js
@@ -100,8 +100,7 @@ export const TestProviders = ({
     appConfig = mockConfig.app,
     siteAlias = DEFAULT_SITE,
     isGuest = false,
-    bypassAuth = true,
-    basket = {bonusDiscountLineItems: []}
+    bypassAuth = true
 }) => {
     const mounted = useRef()
     // We use this to track mounted state.
@@ -164,8 +163,7 @@ TestProviders.propTypes = {
     appConfig: PropTypes.object,
     siteAlias: PropTypes.string,
     bypassAuth: PropTypes.bool,
-    isGuest: PropTypes.bool,
-    basket: PropTypes.object
+    isGuest: PropTypes.bool
 }
 
 /**

From 4848f142609502196e46659e05f39bad489486ad Mon Sep 17 00:00:00 2001
From: madhuri-uppu <madhuri.uppu@salesforce.com>
Date: Wed, 11 Jun 2025 17:30:02 -0700
Subject: [PATCH 24/44] removed unnecessary code

---
 .../app/components/product-view/index.test.js | 72 ++++---------------
 .../app/pages/product-detail/index.test.js    | 12 ++--
 2 files changed, 19 insertions(+), 65 deletions(-)

diff --git a/packages/template-retail-react-app/app/components/product-view/index.test.js b/packages/template-retail-react-app/app/components/product-view/index.test.js
index 1e68f26a33..b4d1df55ed 100644
--- a/packages/template-retail-react-app/app/components/product-view/index.test.js
+++ b/packages/template-retail-react-app/app/components/product-view/index.test.js
@@ -46,13 +46,9 @@ afterEach(() => {
     sessionStorage.clear()
 })
 
-const mockBasket = {bonusDiscountLineItems: []}
-
 test('ProductView Component renders properly', async () => {
     const addToCart = jest.fn()
-    renderWithProviders(<MockComponent product={mockProductDetail} addToCart={addToCart} />, {
-        wrapperProps: {basket: mockBasket}
-    })
+    renderWithProviders(<MockComponent product={mockProductDetail} addToCart={addToCart} />)
     expect(screen.getAllByText(/Black Single Pleat Athletic Fit Wool Suit/i)).toHaveLength(2)
     expect(screen.getAllByText(/299\.99/)).toHaveLength(4)
     expect(screen.getAllByText(/Add to cart/i)).toHaveLength(2)
@@ -62,9 +58,7 @@ test('ProductView Component renders properly', async () => {
 
 test('ProductView Component renders with addToCart event handler', async () => {
     const addToCart = jest.fn()
-    await renderWithProviders(<MockComponent product={mockProductDetail} addToCart={addToCart} />, {
-        wrapperProps: {basket: mockBasket}
-    })
+    await renderWithProviders(<MockComponent product={mockProductDetail} addToCart={addToCart} />)
 
     const addToCartButton = screen.getAllByText(/add to cart/i)[0]
     fireEvent.click(addToCartButton)
@@ -78,10 +72,7 @@ test('ProductView Component renders with addToWishList event handler', async ()
     const addToWishlist = jest.fn()
 
     await renderWithProviders(
-        <MockComponent product={mockProductDetail} addToWishlist={addToWishlist} />,
-        {
-            wrapperProps: {basket: mockBasket}
-        }
+        <MockComponent product={mockProductDetail} addToWishlist={addToWishlist} />
     )
 
     await waitFor(() => {
@@ -100,10 +91,7 @@ test('ProductView Component renders with updateWishlist event handler', async ()
     const updateWishlist = jest.fn()
 
     await renderWithProviders(
-        <MockComponent product={mockProductDetail} updateWishlist={updateWishlist} />,
-        {
-            wrapperProps: {basket: mockBasket}
-        }
+        <MockComponent product={mockProductDetail} updateWishlist={updateWishlist} />
     )
 
     await waitFor(() => {
@@ -121,9 +109,7 @@ test('ProductView Component renders with updateWishlist event handler', async ()
 test('Product View can update quantity', async () => {
     const user = userEvent.setup()
     const addToCart = jest.fn()
-    await renderWithProviders(<MockComponent product={mockProductDetail} addToCart={addToCart} />, {
-        wrapperProps: {basket: mockBasket}
-    })
+    await renderWithProviders(<MockComponent product={mockProductDetail} addToCart={addToCart} />)
 
     let quantityBox
     await waitFor(() => {
@@ -146,9 +132,7 @@ test('Product View handles invalid quantity inputs', async () => {
     const user = userEvent.setup()
 
     // Any invalid input should be reset to minOrderQuantity
-    await renderWithProviders(<MockComponent product={mockProductDetail} />, {
-        wrapperProps: {basket: mockBasket}
-    })
+    await renderWithProviders(<MockComponent product={mockProductDetail} />)
 
     const quantityInput = screen.getByRole('spinbutton', {name: /quantity/i})
     const minQuantity = mockProductDetail.minOrderQuantity.toString()
@@ -172,9 +156,7 @@ test('Product View handles invalid quantity inputs', async () => {
 describe('ProductView Component', () => {
     test('increases quantity when increment button is clicked', async () => {
         const user = userEvent.setup()
-        renderWithProviders(<ProductView product={mockProductDetail} />, {
-            wrapperProps: {basket: mockBasket}
-        })
+        renderWithProviders(<ProductView product={mockProductDetail} />)
 
         const quantityInput = await screen.findByRole('spinbutton')
         const incrementButton = screen.getByTestId('quantity-increment')
@@ -197,10 +179,7 @@ describe('ProductView Component', () => {
 test('renders a product set properly - parent item', () => {
     const parent = mockProductSet
     renderWithProviders(
-        <MockComponent product={parent} addToCart={() => {}} addToWishlist={() => {}} />,
-        {
-            wrapperProps: {basket: mockBasket}
-        }
+        <MockComponent product={parent} addToCart={() => {}} addToWishlist={() => {}} />
     )
 
     // NOTE: there can be duplicates of the same element, due to mobile and desktop views
@@ -225,10 +204,7 @@ test('renders a product set properly - parent item', () => {
 test('renders a product set properly - child item', () => {
     const child = mockProductSet.setProducts[0]
     renderWithProviders(
-        <MockComponent product={child} addToCart={() => {}} addToWishlist={() => {}} />,
-        {
-            wrapperProps: {basket: mockBasket}
-        }
+        <MockComponent product={child} addToCart={() => {}} addToWishlist={() => {}} />
     )
 
     // NOTE: there can be duplicates of the same element, due to mobile and desktop views
@@ -263,10 +239,7 @@ test('validateOrderability callback is called when adding a set to cart', async
             validateOrderability={validateOrderability}
             addToCart={() => {}}
             addToWishlist={() => {}}
-        />,
-        {
-            wrapperProps: {basket: mockBasket}
-        }
+        />
     )
 
     const button = screen.getByRole('button', {name: /add set to cart/i})
@@ -289,10 +262,7 @@ test('onVariantSelected callback is called after successfully selected a variant
             onVariantSelected={onVariantSelected}
             addToCart={() => {}}
             addToWishlist={() => {}}
-        />,
-        {
-            wrapperProps: {basket: mockBasket}
-        }
+        />
     )
 
     const size = screen.getByRole('radio', {name: /xl/i})
@@ -310,10 +280,7 @@ describe('add to cart button loading tests', () => {
                 product={mockProductDetail}
                 addToCart={() => {}}
                 isBasketLoading={true}
-            />,
-            {
-                wrapperProps: {basket: mockBasket}
-            }
+            />
         )
         expect(screen.getByRole('button', {name: /add to cart/i})).toBeDisabled()
     })
@@ -324,10 +291,7 @@ describe('add to cart button loading tests', () => {
                 product={mockProductDetail}
                 addToCart={() => {}}
                 isBasketLoading={false}
-            />,
-            {
-                wrapperProps: {basket: mockBasket}
-            }
+            />
         )
         expect(screen.getByRole('button', {name: /add to cart/i})).toBeEnabled()
     })
@@ -336,10 +300,7 @@ describe('add to cart button loading tests', () => {
 test('renders a product bundle properly - parent item', () => {
     const parent = mockProductBundle
     renderWithProviders(
-        <MockComponent product={parent} addToCart={() => {}} addToWishlist={() => {}} />,
-        {
-            wrapperProps: {basket: mockBasket}
-        }
+        <MockComponent product={parent} addToCart={() => {}} addToWishlist={() => {}} />
     )
 
     // NOTE: there can be duplicates of the same element, due to mobile and desktop views
@@ -369,10 +330,7 @@ test('renders a product bundle properly - child item', () => {
             addToWishlist={() => {}}
             isProductPartOfBundle={true}
             setChildProductOrderability={() => {}}
-        />,
-        {
-            wrapperProps: {basket: mockBasket}
-        }
+        />
     )
 
     const addToCartButton = screen.queryByRole('button', {name: /add to cart/i})
diff --git a/packages/template-retail-react-app/app/pages/product-detail/index.test.js b/packages/template-retail-react-app/app/pages/product-detail/index.test.js
index f3a4bfc2b3..2699837c24 100644
--- a/packages/template-retail-react-app/app/pages/product-detail/index.test.js
+++ b/packages/template-retail-react-app/app/pages/product-detail/index.test.js
@@ -201,10 +201,8 @@ describe('product set', () => {
         window.history.pushState({}, 'ProductDetail', urlPathAfterSelectingAllVariants)
 
         // Initial basket is necessary to add items to it
-        const initialBasket = {basketId: 'valid_id', bonusDiscountLineItems: []}
-        renderWithProviders(<MockedComponent />, {
-            wrapperProps: {basket: initialBasket}
-        })
+        const initialBasket = {basketId: 'valid_id'}
+        renderWithProviders(<MockedComponent />, {wrapperProps: {initialBasket}})
 
         await waitFor(
             () => {
@@ -374,10 +372,8 @@ describe('product bundles', () => {
         window.history.pushState({}, 'ProductDetail', urlPathAfterSelectingAllVariants)
 
         // Initial basket is necessary to add items to it
-        const initialBasket = {basketId: 'valid_id', bonusDiscountLineItems: []}
-        renderWithProviders(<MockedComponent />, {
-            wrapperProps: {basket: initialBasket}
-        })
+        const initialBasket = {basketId: 'valid_id'}
+        renderWithProviders(<MockedComponent />, {wrapperProps: {initialBasket}})
 
         await waitFor(() => {
             expect(screen.getAllByText("Women's clothing test bundle")[0]).toBeInTheDocument()

From 3e7d1f94c342dce788d918b97109012e3058c8be Mon Sep 17 00:00:00 2001
From: daniel-diaz <daniel.diaz@salesforce.com>
Date: Thu, 12 Jun 2025 11:50:10 -0400
Subject: [PATCH 25/44] Switched to test from it

---
 .../partials/BonusProductQuantity.test.jsx             |  6 +++---
 .../partials/ProductQuantityPicker.test.jsx            | 10 +++++-----
 2 files changed, 8 insertions(+), 8 deletions(-)

diff --git a/packages/template-retail-react-app/app/components/product-item/partials/BonusProductQuantity.test.jsx b/packages/template-retail-react-app/app/components/product-item/partials/BonusProductQuantity.test.jsx
index f55751cedd..afe1fc1fbf 100644
--- a/packages/template-retail-react-app/app/components/product-item/partials/BonusProductQuantity.test.jsx
+++ b/packages/template-retail-react-app/app/components/product-item/partials/BonusProductQuantity.test.jsx
@@ -24,18 +24,18 @@ const renderWithIntl = (component) => {
 }
 
 describe('BonusProductQuantity', () => {
-    it('renders quantity for bonus product', () => {
+    test('renders quantity for bonus product', () => {
         renderWithIntl(<BonusProductQuantity product={mockProduct} />)
         expect(screen.getByText('Quantity: 2')).toBeInTheDocument()
     })
 
-    it('has correct aria label', () => {
+    test('has correct aria label', () => {
         renderWithIntl(<BonusProductQuantity product={mockProduct} />)
         const element = screen.getByText('Quantity: 2')
         expect(element).toHaveAttribute('aria-label', 'Quantity 2')
     })
 
-    it('handles undefined quantity gracefully', () => {
+    test('handles undefined quantity gracefully', () => {
         const productWithoutQuantity = {
             id: 'test-id',
             name: 'Test Product'
diff --git a/packages/template-retail-react-app/app/components/product-item/partials/ProductQuantityPicker.test.jsx b/packages/template-retail-react-app/app/components/product-item/partials/ProductQuantityPicker.test.jsx
index a944169f45..9fd3eadc34 100644
--- a/packages/template-retail-react-app/app/components/product-item/partials/ProductQuantityPicker.test.jsx
+++ b/packages/template-retail-react-app/app/components/product-item/partials/ProductQuantityPicker.test.jsx
@@ -50,7 +50,7 @@ describe('ProductQuantityPicker', () => {
         jest.clearAllMocks()
     })
 
-    it('renders quantity label and picker', () => {
+    test('renders quantity label and picker', () => {
         renderWithIntl(
             <ProductQuantityPicker
                 product={mockProduct}
@@ -64,7 +64,7 @@ describe('ProductQuantityPicker', () => {
         expect(screen.getByRole('spinbutton')).toBeInTheDocument()
     })
 
-    it('handles quantity change', async () => {
+    test('handles quantity change', async () => {
         mockOnItemQuantityChange.mockResolvedValue(true)
         renderWithIntl(
             <ProductQuantityPicker
@@ -83,7 +83,7 @@ describe('ProductQuantityPicker', () => {
         })
     })
 
-    it('has correct aria label', () => {
+    test('has correct aria label', () => {
         renderWithIntl(
             <ProductQuantityPicker
                 product={mockProduct}
@@ -100,7 +100,7 @@ describe('ProductQuantityPicker', () => {
         )
     })
 
-    it('handles empty input', () => {
+    test('handles empty input', () => {
         renderWithIntl(
             <ProductQuantityPicker
                 product={mockProduct}
@@ -115,7 +115,7 @@ describe('ProductQuantityPicker', () => {
         expect(mockSetQuantity).toHaveBeenCalledWith('')
     })
 
-    it('handles invalid input', () => {
+    test('handles invalid input', () => {
         renderWithIntl(
             <ProductQuantityPicker
                 product={mockProduct}

From 9f6cfe54dd45d002603dba110b8fd74baadb79fe Mon Sep 17 00:00:00 2001
From: madhuri-uppu <madhuri.uppu@salesforce.com>
Date: Thu, 12 Jun 2025 09:42:27 -0700
Subject: [PATCH 26/44] fixed infinite re-render issue

---
 .../app/hooks/use-bonus-product-modal.js      | 19 +++++++++++++------
 1 file changed, 13 insertions(+), 6 deletions(-)

diff --git a/packages/template-retail-react-app/app/hooks/use-bonus-product-modal.js b/packages/template-retail-react-app/app/hooks/use-bonus-product-modal.js
index f3e93a86de..8db36534f7 100644
--- a/packages/template-retail-react-app/app/hooks/use-bonus-product-modal.js
+++ b/packages/template-retail-react-app/app/hooks/use-bonus-product-modal.js
@@ -84,13 +84,20 @@ export const useBonusState = (basket) => {
         }
     }, [pathname])
 
-    // Update bonusProducts when basket changes
+    // Update bonusProducts when basket bonusDiscountLineItems changes
     useEffect(() => {
-        setState((prev) => ({
-            ...prev,
-            bonusProducts: basket?.bonusDiscountLineItems || []
-        }))
-    }, [basket])
+        const currentBonusItems = basket?.bonusDiscountLineItems || []
+        setState((prev) => {
+            // Only update if the bonus items have actually changed
+            if (JSON.stringify(prev.bonusProducts) !== JSON.stringify(currentBonusItems)) {
+                return {
+                    ...prev,
+                    bonusProducts: currentBonusItems
+                }
+            }
+            return prev
+        })
+    }, [basket?.bonusDiscountLineItems])
 
     const addBonusProducts = (newBonusItems) => {
         setState((prev) => {

From 4f8a0f5303c3a9dc8e4acb349ca336cdedab4b2d Mon Sep 17 00:00:00 2001
From: daniel-diaz <daniel.diaz@salesforce.com>
Date: Thu, 12 Jun 2025 14:34:00 -0400
Subject: [PATCH 27/44] Merged Develop in to Feature

---
 packages/commerce-sdk-react/CHANGELOG.md      |   2 +
 .../commerce-sdk-react/src/hooks/types.ts     |  15 +
 .../commerce-sdk-react/src/hooks/useConfig.ts |   2 +-
 packages/commerce-sdk-react/src/provider.tsx  | 108 ++--
 packages/commerce-sdk-react/src/utils.test.ts | 193 +++++++
 packages/commerce-sdk-react/src/utils.ts      |  38 ++
 .../template-retail-react-app/CHANGELOG.md    |   1 -
 .../app/components/_app-config/index.jsx      |  28 +-
 .../app/components/_app/index.jsx             |   2 +-
 .../item-variant/item-attributes.jsx          |  10 -
 .../item-variant/item-attributes.test.js      |  36 --
 .../app/components/locale-text/index.jsx      |   2 +-
 .../app/components/product-view/index.test.js |  23 +
 .../components/store-locator-modal/index.jsx  | 102 ----
 .../store-locator-modal/index.test.jsx        | 212 --------
 .../store-locator-content.jsx                 | 213 --------
 .../store-locator-content.test.jsx            | 399 --------------
 .../store-locator-input.jsx                   | 230 --------
 .../store-locator-input.test.jsx              |  75 ---
 .../store-locator-modal/stores-list.jsx       | 131 -----
 .../store-locator-modal/stores-list.test.jsx  | 199 -------
 .../app/components/store-locator/diagram.png  | Bin 0 -> 471079 bytes
 .../app/components/store-locator/form.jsx     | 157 ++++++
 .../components/store-locator/form.test.jsx    | 150 ++++++
 .../app/components/store-locator/heading.jsx  |  19 +
 .../components/store-locator/heading.test.jsx |  19 +
 .../app/components/store-locator/index.js     |   9 +
 .../components/store-locator/list-item.jsx    |  73 +++
 .../store-locator/list-item.test.jsx          |  58 ++
 .../app/components/store-locator/list.jsx     |  83 +++
 .../components/store-locator/list.test.jsx    | 141 +++++
 .../app/components/store-locator/main.jsx     |  21 +
 .../components/store-locator/main.test.jsx    |  33 ++
 .../app/components/store-locator/modal.jsx    |  56 ++
 .../components/store-locator/modal.test.jsx   |  67 +++
 .../app/constants.js                          |  33 +-
 .../app/contexts/index.js                     |   4 +
 .../app/contexts/store-locator-provider.jsx   |  41 ++
 .../contexts/store-locator-provider.test.jsx  |  91 ++++
 .../app/hooks/use-geo-location.js             |  56 ++
 .../app/hooks/use-geo-location.test.js        | 162 ++++++
 .../app/hooks/use-store-locator.js            |  85 +++
 .../app/hooks/use-store-locator.test.jsx      | 190 +++++++
 .../app/pages/account/orders.test.js          | 145 ++++-
 .../app/pages/store-locator/index.jsx         |  56 +-
 .../app/pages/store-locator/index.test.jsx    | 264 +--------
 .../static/translations/compiled/de-DE.json   | 486 ++++++++++++++++-
 .../static/translations/compiled/en-GB.json   | 140 -----
 .../static/translations/compiled/en-US.json   | 140 -----
 .../static/translations/compiled/en-XA.json   | 300 -----------
 .../static/translations/compiled/es-MX.json   | 490 ++++++++++++++++-
 .../static/translations/compiled/fr-FR.json   | 492 ++++++++++++++++-
 .../static/translations/compiled/it-IT.json   | 498 ++++++++++++++++-
 .../static/translations/compiled/ja-JP.json   | 486 ++++++++++++++++-
 .../static/translations/compiled/ko-KR.json   | 496 ++++++++++++++++-
 .../static/translations/compiled/pt-BR.json   | 492 ++++++++++++++++-
 .../static/translations/compiled/zh-CN.json   | 508 +++++++++++++++++-
 .../static/translations/compiled/zh-TW.json   | 494 ++++++++++++++++-
 .../app/utils/test-utils.js                   |  37 +-
 .../translations/de-DE.json                   | 188 ++++++-
 .../translations/en-GB.json                   |  60 ---
 .../translations/en-US.json                   |  60 ---
 .../translations/es-MX.json                   | 188 ++++++-
 .../translations/fr-FR.json                   | 188 ++++++-
 .../translations/it-IT.json                   | 190 ++++++-
 .../translations/ja-JP.json                   | 190 ++++++-
 .../translations/ko-KR.json                   | 188 ++++++-
 .../translations/pt-BR.json                   | 188 ++++++-
 .../translations/zh-CN.json                   | 188 ++++++-
 .../translations/zh-TW.json                   | 188 ++++++-
 70 files changed, 7987 insertions(+), 2922 deletions(-)
 delete mode 100644 packages/template-retail-react-app/app/components/store-locator-modal/index.jsx
 delete mode 100644 packages/template-retail-react-app/app/components/store-locator-modal/index.test.jsx
 delete mode 100644 packages/template-retail-react-app/app/components/store-locator-modal/store-locator-content.jsx
 delete mode 100644 packages/template-retail-react-app/app/components/store-locator-modal/store-locator-content.test.jsx
 delete mode 100644 packages/template-retail-react-app/app/components/store-locator-modal/store-locator-input.jsx
 delete mode 100644 packages/template-retail-react-app/app/components/store-locator-modal/store-locator-input.test.jsx
 delete mode 100644 packages/template-retail-react-app/app/components/store-locator-modal/stores-list.jsx
 delete mode 100644 packages/template-retail-react-app/app/components/store-locator-modal/stores-list.test.jsx
 create mode 100644 packages/template-retail-react-app/app/components/store-locator/diagram.png
 create mode 100644 packages/template-retail-react-app/app/components/store-locator/form.jsx
 create mode 100644 packages/template-retail-react-app/app/components/store-locator/form.test.jsx
 create mode 100644 packages/template-retail-react-app/app/components/store-locator/heading.jsx
 create mode 100644 packages/template-retail-react-app/app/components/store-locator/heading.test.jsx
 create mode 100644 packages/template-retail-react-app/app/components/store-locator/index.js
 create mode 100644 packages/template-retail-react-app/app/components/store-locator/list-item.jsx
 create mode 100644 packages/template-retail-react-app/app/components/store-locator/list-item.test.jsx
 create mode 100644 packages/template-retail-react-app/app/components/store-locator/list.jsx
 create mode 100644 packages/template-retail-react-app/app/components/store-locator/list.test.jsx
 create mode 100644 packages/template-retail-react-app/app/components/store-locator/main.jsx
 create mode 100644 packages/template-retail-react-app/app/components/store-locator/main.test.jsx
 create mode 100644 packages/template-retail-react-app/app/components/store-locator/modal.jsx
 create mode 100644 packages/template-retail-react-app/app/components/store-locator/modal.test.jsx
 create mode 100644 packages/template-retail-react-app/app/contexts/store-locator-provider.jsx
 create mode 100644 packages/template-retail-react-app/app/contexts/store-locator-provider.test.jsx
 create mode 100644 packages/template-retail-react-app/app/hooks/use-geo-location.js
 create mode 100644 packages/template-retail-react-app/app/hooks/use-geo-location.test.js
 create mode 100644 packages/template-retail-react-app/app/hooks/use-store-locator.js
 create mode 100644 packages/template-retail-react-app/app/hooks/use-store-locator.test.jsx

diff --git a/packages/commerce-sdk-react/CHANGELOG.md b/packages/commerce-sdk-react/CHANGELOG.md
index 09a39ae3f7..94d04c4727 100644
--- a/packages/commerce-sdk-react/CHANGELOG.md
+++ b/packages/commerce-sdk-react/CHANGELOG.md
@@ -1,6 +1,8 @@
 ## v3.4.0-dev.0 (May 23, 2025)
 - Now compatible with either React 17 and 18 [#2506](https://github.com/SalesforceCommerceCloud/pwa-kit/pull/2506)
 
+- Refactor commerce-sdk-react to allow injecting ApiClients [#2519](https://github.com/SalesforceCommerceCloud/pwa-kit/pull/2519)
+
 ## v3.3.0 (May 22, 2025)
 
 - Fix inconsistency between dwsid and access token for guest login when hybrid authentication is enabled [#2397](https://github.com/SalesforceCommerceCloud/pwa-kit/pull/2397)
diff --git a/packages/commerce-sdk-react/src/hooks/types.ts b/packages/commerce-sdk-react/src/hooks/types.ts
index 5b2eb07793..4f39677424 100644
--- a/packages/commerce-sdk-react/src/hooks/types.ts
+++ b/packages/commerce-sdk-react/src/hooks/types.ts
@@ -20,6 +20,7 @@ import {
     ShopperStores
 } from 'commerce-sdk-isomorphic'
 import {helpers} from 'commerce-sdk-isomorphic'
+import {CommerceApiProviderProps} from '../provider'
 
 // --- GENERAL UTILITIES --- //
 
@@ -226,3 +227,17 @@ export type TMutationVariables = {
     parameters?: {[key: string]: string | number | boolean | string[] | number[]}
     headers?: {[key: string]: string}
 } | void
+
+export type SDKClientTransformer<T> = (
+    params: T,
+    methodName: string,
+    options: any
+) => any | Promise<any>
+
+export type ErrorCallback<TParams> = (methodName: string, error: any, params: TParams) => void
+
+export interface SDKClientTransformConfig<TParams = Record<string, any>> {
+    props: Omit<CommerceApiProviderProps, 'children'>
+    transformer?: SDKClientTransformer<TParams>
+    onError?: ErrorCallback<TParams>
+}
diff --git a/packages/commerce-sdk-react/src/hooks/useConfig.ts b/packages/commerce-sdk-react/src/hooks/useConfig.ts
index 622f39be86..2fa32fe699 100644
--- a/packages/commerce-sdk-react/src/hooks/useConfig.ts
+++ b/packages/commerce-sdk-react/src/hooks/useConfig.ts
@@ -11,7 +11,7 @@ import {ConfigContext, CommerceApiProviderProps} from '../provider'
 /**
  * @Internal
  */
-const useConfig = (): Omit<CommerceApiProviderProps, 'children'> => {
+const useConfig = (): Omit<CommerceApiProviderProps, 'children' | 'apiClients'> => {
     return React.useContext(ConfigContext)
 }
 
diff --git a/packages/commerce-sdk-react/src/provider.tsx b/packages/commerce-sdk-react/src/provider.tsx
index db578ddfc0..36b0864ba2 100644
--- a/packages/commerce-sdk-react/src/provider.tsx
+++ b/packages/commerce-sdk-react/src/provider.tsx
@@ -5,6 +5,15 @@
  * For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/BSD-3-Clause
  */
 import React, {ReactElement, useEffect, useMemo} from 'react'
+import Auth from './auth'
+import {ApiClientConfigParams, ApiClients, SDKClientTransformer} from './hooks/types'
+import {Logger} from './types'
+import {
+    DWSID_COOKIE_NAME,
+    MOBIFY_PATH,
+    SERVER_AFFINITY_HEADER_KEY,
+    SLAS_PRIVATE_PROXY_PATH
+} from './constant'
 import {
     ShopperBaskets,
     ShopperContexts,
@@ -20,15 +29,8 @@ import {
     ShopperBasketsTypes,
     ShopperStores
 } from 'commerce-sdk-isomorphic'
-import Auth from './auth'
-import {ApiClientConfigParams, ApiClients} from './hooks/types'
-import {Logger} from './types'
-import {
-    DWSID_COOKIE_NAME,
-    MOBIFY_PATH,
-    SERVER_AFFINITY_HEADER_KEY,
-    SLAS_PRIVATE_PROXY_PATH
-} from './constant'
+import {transformSDKClient} from './utils'
+
 export interface CommerceApiProviderProps extends ApiClientConfigParams {
     children: React.ReactNode
     proxy: string
@@ -46,6 +48,7 @@ export interface CommerceApiProviderProps extends ApiClientConfigParams {
     passwordlessLoginCallbackURI?: string
     refreshTokenRegisteredCookieTTL?: number
     refreshTokenGuestCookieTTL?: number
+    apiClients?: ApiClients
 }
 
 /**
@@ -56,7 +59,9 @@ export const CommerceApiContext = React.createContext({} as ApiClients)
 /**
  * @internal
  */
-export const ConfigContext = React.createContext({} as Omit<CommerceApiProviderProps, 'children'>)
+export const ConfigContext = React.createContext(
+    {} as Omit<CommerceApiProviderProps, 'children' | 'apiClients'>
+)
 
 /**
  * @internal
@@ -126,7 +131,8 @@ const CommerceApiProvider = (props: CommerceApiProviderProps): ReactElement => {
         defaultDnt,
         passwordlessLoginCallbackURI,
         refreshTokenRegisteredCookieTTL,
-        refreshTokenGuestCookieTTL
+        refreshTokenGuestCookieTTL,
+        apiClients
     } = props
 
     // Set the logger based on provided configuration, or default to the console object if no logger is provided
@@ -167,7 +173,8 @@ const CommerceApiProvider = (props: CommerceApiProviderProps): ReactElement => {
         defaultDnt,
         passwordlessLoginCallbackURI,
         refreshTokenRegisteredCookieTTL,
-        refreshTokenGuestCookieTTL
+        refreshTokenGuestCookieTTL,
+        apiClients
     ])
 
     const dwsid = auth.get(DWSID_COOKIE_NAME)
@@ -176,28 +183,62 @@ const CommerceApiProvider = (props: CommerceApiProviderProps): ReactElement => {
         serverAffinityHeader[SERVER_AFFINITY_HEADER_KEY] = dwsid
     }
 
-    const config = {
-        proxy,
-        headers: {
-            ...headers,
-            ...serverAffinityHeader
-        },
-        parameters: {
-            clientId,
-            organizationId,
-            shortCode,
-            siteId,
-            locale,
-            currency
-        },
-        throwOnBadResponse: true,
-        fetchOptions
+    const _defaultTransformer: SDKClientTransformer<Record<string, any>> = (_, _$, options) => {
+        return {
+            ...options,
+            headers: {
+                ...options.headers,
+                ...serverAffinityHeader
+            },
+            throwOnBadResponse: true,
+            fetchOptions: {
+                ...options.fetchOptions,
+                ...fetchOptions
+            }
+        }
     }
 
-    const baseUrl = config.proxy.split(MOBIFY_PATH)[0]
-    const privateClientEndpoint = `${baseUrl}${SLAS_PRIVATE_PROXY_PATH}`
+    const updatedClients: ApiClients = useMemo(() => {
+        if (apiClients) {
+            const clients: Record<string, any> = {}
+
+            // transformSDKClient is simply a utility function that wraps the SDK Client instance
+            // in a Proxy that allows us to transform the method arguments and modify headers, parameters, and other options.
+            // We don't really need to pass in the children prop to the transformer function, so we'll just pass in the rest of the props.
+            // eslint-disable-next-line @typescript-eslint/no-unused-vars
+            const {children, ...restProps} = props
+
+            Object.entries(apiClients ?? {}).forEach(([key, apiClient]) => {
+                clients[key] = transformSDKClient(apiClient, {
+                    props: restProps,
+                    transformer: _defaultTransformer
+                })
+            })
+
+            return clients as ApiClients
+        }
+
+        const config = {
+            proxy,
+            headers: {
+                ...headers,
+                ...serverAffinityHeader
+            },
+            parameters: {
+                clientId,
+                organizationId,
+                shortCode,
+                siteId,
+                locale,
+                currency
+            },
+            throwOnBadResponse: true,
+            fetchOptions
+        }
+
+        const baseUrl = config.proxy.split(MOBIFY_PATH)[0]
+        const privateClientEndpoint = `${baseUrl}${SLAS_PRIVATE_PROXY_PATH}`
 
-    const apiClients = useMemo(() => {
         return {
             shopperBaskets: new ShopperBaskets(config),
             shopperContexts: new ShopperContexts(config),
@@ -224,7 +265,8 @@ const CommerceApiProvider = (props: CommerceApiProviderProps): ReactElement => {
         fetchOptions,
         locale,
         currency,
-        headers?.['correlation-id']
+        headers?.['correlation-id'],
+        apiClients
     ])
 
     // Initialize the session
@@ -251,7 +293,7 @@ const CommerceApiProvider = (props: CommerceApiProviderProps): ReactElement => {
                 refreshTokenGuestCookieTTL
             }}
         >
-            <CommerceApiContext.Provider value={apiClients}>
+            <CommerceApiContext.Provider value={updatedClients}>
                 <AuthContext.Provider value={auth}>{children}</AuthContext.Provider>
             </CommerceApiContext.Provider>
         </ConfigContext.Provider>
diff --git a/packages/commerce-sdk-react/src/utils.test.ts b/packages/commerce-sdk-react/src/utils.test.ts
index a7dbf9b806..a2db4a652f 100644
--- a/packages/commerce-sdk-react/src/utils.test.ts
+++ b/packages/commerce-sdk-react/src/utils.test.ts
@@ -5,6 +5,8 @@
  * For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/BSD-3-Clause
  */
 import * as utils from './utils'
+import {DEFAULT_TEST_CONFIG} from './test-utils'
+import {SDKClientTransformConfig} from './hooks/types'
 
 describe('Utils', () => {
     test.each([
@@ -31,4 +33,195 @@ describe('Utils', () => {
             c_param3: true
         })
     })
+
+    describe('transformSDKClient', () => {
+        let mockClient: any
+        let mockConfig: SDKClientTransformConfig
+
+        beforeEach(() => {
+            mockClient = {
+                getBasket: jest.fn().mockResolvedValue({basketId: 'test-basket'}),
+                createBasket: jest.fn().mockResolvedValue({basketId: 'new-basket'}),
+                nonFunctionProperty: 'some value'
+            }
+
+            mockConfig = {
+                props: {
+                    ...DEFAULT_TEST_CONFIG
+                },
+                transformer: jest.fn((params, methodName, options) => options),
+                onError: jest.fn()
+            }
+        })
+
+        afterEach(() => {
+            jest.clearAllMocks()
+        })
+
+        test('should return a proxy that preserves non-function properties', () => {
+            const proxiedClient = utils.transformSDKClient(mockClient, mockConfig)
+
+            expect(proxiedClient.nonFunctionProperty).toBe('some value')
+        })
+
+        test('should wrap function methods with proxy behavior', () => {
+            const proxiedClient = utils.transformSDKClient(mockClient, mockConfig)
+
+            expect(typeof proxiedClient.getBasket).toBe('function')
+            expect(typeof proxiedClient.createBasket).toBe('function')
+        })
+
+        test('should call original method with provided options', async () => {
+            const proxiedClient = utils.transformSDKClient(mockClient, mockConfig)
+            const options = {parameters: {basketId: 'test-123'}}
+
+            await proxiedClient.getBasket(options)
+
+            expect(mockClient.getBasket).toHaveBeenCalledWith(options)
+        })
+
+        test('should call original method with empty object if no options provided', async () => {
+            const proxiedClient = utils.transformSDKClient(mockClient, mockConfig)
+
+            await proxiedClient.getBasket()
+
+            expect(mockClient.getBasket).toHaveBeenCalledWith({})
+        })
+
+        test('should apply transformer to options before calling original method', async () => {
+            const transformedOptions = {
+                parameters: {basketId: 'transformed-123'},
+                headers: {'X-Custom': 'transformed'}
+            }
+            ;(mockConfig.transformer as jest.Mock).mockResolvedValue(transformedOptions)
+
+            const proxiedClient = utils.transformSDKClient(mockClient, mockConfig)
+            const originalOptions = {parameters: {basketId: 'original-123'}}
+
+            await proxiedClient.getBasket(originalOptions)
+
+            expect(mockConfig.transformer).toHaveBeenCalledWith(
+                mockConfig.props,
+                'getBasket',
+                originalOptions
+            )
+            expect(mockClient.getBasket).toHaveBeenCalledWith(transformedOptions)
+        })
+
+        test('should handle async transformer', async () => {
+            const transformedOptions = {parameters: {basketId: 'async-transformed'}}
+            ;(mockConfig.transformer as jest.Mock).mockResolvedValue(transformedOptions)
+
+            const proxiedClient = utils.transformSDKClient(mockClient, mockConfig)
+
+            await proxiedClient.getBasket({})
+
+            expect(mockClient.getBasket).toHaveBeenCalledWith(transformedOptions)
+        })
+
+        test('should handle sync transformer', async () => {
+            const transformedOptions = {parameters: {basketId: 'sync-transformed'}}
+            ;(mockConfig.transformer as jest.Mock).mockReturnValue(transformedOptions)
+
+            const proxiedClient = utils.transformSDKClient(mockClient, mockConfig)
+
+            await proxiedClient.getBasket({})
+
+            expect(mockClient.getBasket).toHaveBeenCalledWith(transformedOptions)
+        })
+
+        test('should call onError callback when method throws error', async () => {
+            const error = new Error('API Error')
+            mockClient.getBasket.mockRejectedValue(error)
+
+            const proxiedClient = utils.transformSDKClient(mockClient, mockConfig)
+            const options = {parameters: {basketId: 'test'}}
+
+            await expect(proxiedClient.getBasket(options)).rejects.toThrow('API Error')
+
+            expect(mockConfig.onError).toHaveBeenCalledWith('getBasket', error, options)
+        })
+
+        test('should rethrow error after calling onError callback', async () => {
+            const error = new Error('API Error')
+            mockClient.getBasket.mockRejectedValue(error)
+
+            const proxiedClient = utils.transformSDKClient(mockClient, mockConfig)
+
+            await expect(proxiedClient.getBasket({})).rejects.toThrow('API Error')
+        })
+
+        test('should work without optional callbacks', async () => {
+            const configWithoutCallbacks = {
+                props: {
+                    ...DEFAULT_TEST_CONFIG
+                }
+            }
+
+            const proxiedClient = utils.transformSDKClient(mockClient, configWithoutCallbacks)
+
+            await expect(proxiedClient.getBasket({})).resolves.toEqual({basketId: 'test-basket'})
+        })
+
+        test('should work without transformer', async () => {
+            const configWithoutTransformer = {
+                props: {
+                    ...DEFAULT_TEST_CONFIG
+                },
+                onError: jest.fn()
+            }
+
+            const proxiedClient = utils.transformSDKClient(mockClient, configWithoutTransformer)
+            const options = {parameters: {basketId: 'test'}}
+
+            await proxiedClient.getBasket(options)
+
+            expect(mockClient.getBasket).toHaveBeenCalledWith(options)
+        })
+
+        test('should handle multiple method calls independently', async () => {
+            const proxiedClient = utils.transformSDKClient(mockClient, mockConfig)
+
+            await proxiedClient.getBasket({parameters: {basketId: 'basket-1'}})
+            await proxiedClient.createBasket({parameters: {currency: 'USD'}})
+
+            expect(mockClient.getBasket).toHaveBeenCalledWith({parameters: {basketId: 'basket-1'}})
+            expect(mockClient.createBasket).toHaveBeenCalledWith({parameters: {currency: 'USD'}})
+        })
+
+        test('should preserve this context in original method calls', async () => {
+            const contextClient = {
+                getData: function () {
+                    return Promise.resolve('test-data')
+                }
+            }
+
+            const proxiedClient = utils.transformSDKClient(contextClient, mockConfig)
+
+            const result = await proxiedClient.getData()
+
+            expect(result).toBe('test-data')
+        })
+
+        test('should pass props correctly to transformer', () => {
+            const propsWithCustom = {
+                ...DEFAULT_TEST_CONFIG,
+                customProp: 'custom-value'
+            }
+
+            const configWithCustomProps = {
+                props: propsWithCustom,
+                transformer: jest.fn((params) => {
+                    expect(params).toHaveProperty('customProp', 'custom-value')
+                    return {}
+                })
+            }
+
+            const proxiedClient = utils.transformSDKClient(mockClient, configWithCustomProps)
+
+            proxiedClient.getBasket({})
+
+            expect(configWithCustomProps.transformer).toHaveBeenCalled()
+        })
+    })
 })
diff --git a/packages/commerce-sdk-react/src/utils.ts b/packages/commerce-sdk-react/src/utils.ts
index 70c8ba097b..309428d079 100644
--- a/packages/commerce-sdk-react/src/utils.ts
+++ b/packages/commerce-sdk-react/src/utils.ts
@@ -8,6 +8,7 @@
 import Cookies, {CookieAttributes} from 'js-cookie'
 import {IFRAME_HOST_ALLOW_LIST} from './constant'
 import {helpers} from 'commerce-sdk-isomorphic'
+import {SDKClientTransformConfig} from './hooks/types'
 
 /** Utility to determine if you are on the browser (client) or not. */
 export const onClient = (): boolean => typeof window !== 'undefined'
@@ -161,3 +162,40 @@ export const extractCustomParameters = (
     }
     return Object.fromEntries(Object.entries(parameters).filter(([key]) => key.startsWith('c_')))
 }
+
+/**
+ * Creates a proxy around SDK Client instance to transform method arguments and modify headers, parameters, and other options.
+ * You can pass in a transformer function to modify the parameters.
+ * @param client - The SDK Client instance to transform.
+ * @param config - The configuration object for the transformation.
+ * @returns The transformed SDK Client instance.
+ */
+export const transformSDKClient = <T extends Record<string, (...args: any[]) => Promise<any>>>(
+    client: T,
+    config: SDKClientTransformConfig
+): T => {
+    const {props, transformer, onError} = config
+
+    return new Proxy(client, {
+        get(target, methodName: string) {
+            const originalMethod = target[methodName]
+
+            if (typeof originalMethod !== 'function') {
+                return originalMethod
+            }
+
+            return async function (options: any = {}) {
+                try {
+                    if (transformer) {
+                        options = await Promise.resolve(transformer(props, methodName, options))
+                    }
+
+                    return await originalMethod.call(target, options)
+                } catch (error) {
+                    onError?.(methodName, error, options)
+                    throw error
+                }
+            }
+        }
+    })
+}
diff --git a/packages/template-retail-react-app/CHANGELOG.md b/packages/template-retail-react-app/CHANGELOG.md
index e95f90eacf..d030e718c8 100644
--- a/packages/template-retail-react-app/CHANGELOG.md
+++ b/packages/template-retail-react-app/CHANGELOG.md
@@ -2,7 +2,6 @@
 
 - Improved the layout of product tiles in product scroll and product list [#2446](https://github.com/SalesforceCommerceCloud/pwa-kit/pull/2446)
 - Updated 6 new languagues [#2495](https://github.com/SalesforceCommerceCloud/pwa-kit/pull/2495)
-- Show Bonus Product Label on OrderSummary component [#2524](https://github.com/SalesforceCommerceCloud/pwa-kit/pull/2524)
 
 ## v6.1.0 (May 22, 2025)
 
diff --git a/packages/template-retail-react-app/app/components/_app-config/index.jsx b/packages/template-retail-react-app/app/components/_app-config/index.jsx
index e28be6db6a..242c95a60e 100644
--- a/packages/template-retail-react-app/app/components/_app-config/index.jsx
+++ b/packages/template-retail-react-app/app/components/_app-config/index.jsx
@@ -21,7 +21,7 @@ import {ChakraProvider} from '@salesforce/retail-react-app/app/components/shared
 import 'focus-visible/dist/focus-visible'
 
 import theme from '@salesforce/retail-react-app/app/theme'
-import {MultiSiteProvider} from '@salesforce/retail-react-app/app/contexts'
+import {MultiSiteProvider, StoreLocatorProvider} from '@salesforce/retail-react-app/app/contexts'
 import {useAppOrigin} from '@salesforce/retail-react-app/app/hooks/use-app-origin'
 import {
     resolveSiteFromUrl,
@@ -35,7 +35,17 @@ import {CommerceApiProvider} from '@salesforce/commerce-sdk-react'
 import {withReactQuery} from '@salesforce/pwa-kit-react-sdk/ssr/universal/components/with-react-query'
 import {useCorrelationId} from '@salesforce/pwa-kit-react-sdk/ssr/universal/hooks'
 import {ReactQueryDevtools} from '@tanstack/react-query-devtools'
-import {DEFAULT_DNT_STATE} from '@salesforce/retail-react-app/app/constants'
+import {
+    DEFAULT_DNT_STATE,
+    STORE_LOCATOR_RADIUS,
+    STORE_LOCATOR_RADIUS_UNIT,
+    STORE_LOCATOR_DEFAULT_COUNTRY,
+    STORE_LOCATOR_DEFAULT_COUNTRY_CODE,
+    STORE_LOCATOR_DEFAULT_POSTAL_CODE,
+    STORE_LOCATOR_DEFAULT_PAGE_SIZE,
+    STORE_LOCATOR_SUPPORTED_COUNTRIES
+} from '@salesforce/retail-react-app/app/constants'
+
 /**
  * Use the AppConfig component to inject extra arguments into the getProps
  * methods for all Route Components in the app – typically you'd want to do this
@@ -56,6 +66,16 @@ const AppConfig = ({children, locals = {}}) => {
 
     const passwordlessCallback = locals.appConfig.login?.passwordless?.callbackURI
 
+    const storeLocatorConfig = {
+        radius: STORE_LOCATOR_RADIUS,
+        radiusUnit: STORE_LOCATOR_RADIUS_UNIT,
+        defaultCountry: STORE_LOCATOR_DEFAULT_COUNTRY,
+        defaultCountryCode: STORE_LOCATOR_DEFAULT_COUNTRY_CODE,
+        defaultPostalCode: STORE_LOCATOR_DEFAULT_POSTAL_CODE,
+        defaultPageSize: STORE_LOCATOR_DEFAULT_PAGE_SIZE,
+        supportedCountries: STORE_LOCATOR_SUPPORTED_COUNTRIES
+    }
+
     return (
         <CommerceApiProvider
             shortCode={commerceApiConfig.parameters.shortCode}
@@ -75,7 +95,9 @@ const AppConfig = ({children, locals = {}}) => {
             logger={createLogger({packageName: 'commerce-sdk-react'})}
         >
             <MultiSiteProvider site={locals.site} locale={locals.locale} buildUrl={locals.buildUrl}>
-                <ChakraProvider theme={theme}>{children}</ChakraProvider>
+                <StoreLocatorProvider config={storeLocatorConfig}>
+                    <ChakraProvider theme={theme}>{children}</ChakraProvider>
+                </StoreLocatorProvider>
             </MultiSiteProvider>
             <ReactQueryDevtools />
         </CommerceApiProvider>
diff --git a/packages/template-retail-react-app/app/components/_app/index.jsx b/packages/template-retail-react-app/app/components/_app/index.jsx
index 957155e7b3..4c76ed09c9 100644
--- a/packages/template-retail-react-app/app/components/_app/index.jsx
+++ b/packages/template-retail-react-app/app/components/_app/index.jsx
@@ -47,7 +47,7 @@ import {DrawerMenu} from '@salesforce/retail-react-app/app/components/drawer-men
 import {ListMenu, ListMenuContent} from '@salesforce/retail-react-app/app/components/list-menu'
 import {HideOnDesktop, HideOnMobile} from '@salesforce/retail-react-app/app/components/responsive'
 import AboveHeader from '@salesforce/retail-react-app/app/components/_app/partials/above-header'
-import StoreLocatorModal from '@salesforce/retail-react-app/app/components/store-locator-modal'
+import {StoreLocatorModal} from '@salesforce/retail-react-app/app/components/store-locator'
 // Hooks
 import {AuthModal, useAuthModal} from '@salesforce/retail-react-app/app/hooks/use-auth-modal'
 import {
diff --git a/packages/template-retail-react-app/app/components/item-variant/item-attributes.jsx b/packages/template-retail-react-app/app/components/item-variant/item-attributes.jsx
index 535953060d..15ee4ec9c6 100644
--- a/packages/template-retail-react-app/app/components/item-variant/item-attributes.jsx
+++ b/packages/template-retail-react-app/app/components/item-variant/item-attributes.jsx
@@ -27,7 +27,6 @@ const ItemAttributes = ({includeQuantity, currency, ...props}) => {
     const promotionIds = variant.priceAdjustments?.map((adj) => adj.promotionId) ?? []
     const intl = useIntl()
 
-    const isBonusProduct = variant?.bonusProductLineItem
     // Fetch all the promotions given by price adjustments. We display this info in
     // the promotion info popover when applicable.
     const {data: res} = usePromotions(
@@ -92,15 +91,6 @@ const ItemAttributes = ({includeQuantity, currency, ...props}) => {
 
     return (
         <Stack spacing={1.5} flex={1} {...props}>
-            {isBonusProduct && (
-                <Text lineHeight={1} color="black.600" fontSize="sm">
-                    <FormattedMessage
-                        defaultMessage="Bonus Product"
-                        id="item_attributes.label.is_bonus_product"
-                    />
-                </Text>
-            )}
-
             {variationValues &&
                 Object.keys(variationValues).map((key) => (
                     <Text
diff --git a/packages/template-retail-react-app/app/components/item-variant/item-attributes.test.js b/packages/template-retail-react-app/app/components/item-variant/item-attributes.test.js
index 472f0c4b7b..ec751b1d30 100644
--- a/packages/template-retail-react-app/app/components/item-variant/item-attributes.test.js
+++ b/packages/template-retail-react-app/app/components/item-variant/item-attributes.test.js
@@ -73,39 +73,3 @@ test('component renders product bundles without variant data', async () => {
         })
     })
 })
-
-test('renders Bonus Product when isBonusProduct is true', async () => {
-    const mockVariantWithBonusProduct = {
-        ...mockBundledProductItemsVariant,
-        bonusProductLineItem: true // Simulate the bonus product flag
-    }
-
-    renderWithProviders(<MockedComponent variant={mockVariantWithBonusProduct} />)
-
-    await waitFor(() => {
-        expect(screen.getByText(/Bonus Product/i)).toBeInTheDocument()
-    })
-})
-
-test('does not render Bonus Product when isBonusProduct is false', async () => {
-    const mockVariantWithoutBonusProduct = {
-        ...mockBundledProductItemsVariant,
-        bonusProductLineItem: false // Simulate the absence of the bonus product flag
-    }
-
-    renderWithProviders(<MockedComponent variant={mockVariantWithoutBonusProduct} />)
-
-    await waitFor(() => {
-        expect(screen.queryByText(/Bonus Product/i)).not.toBeInTheDocument()
-    })
-})
-
-test('does not render Bonus Product when bonusProductLineItem is undefined', async () => {
-    const mockVariantWithoutBonusProduct = {...mockBundledProductItemsVariant}
-    delete mockVariantWithoutBonusProduct.bonusProductLineItem
-
-    renderWithProviders(<MockedComponent variant={mockVariantWithoutBonusProduct} />)
-    await waitFor(() => {
-        expect(screen.queryByText(/Bonus Product/i)).not.toBeInTheDocument()
-    })
-})
diff --git a/packages/template-retail-react-app/app/components/locale-text/index.jsx b/packages/template-retail-react-app/app/components/locale-text/index.jsx
index cc5789d127..cc447264f4 100644
--- a/packages/template-retail-react-app/app/components/locale-text/index.jsx
+++ b/packages/template-retail-react-app/app/components/locale-text/index.jsx
@@ -40,7 +40,7 @@ LocaleText.propTypes = {
 export default LocaleText
 
 /**
- *  Translations for names of the commonly-used locales.
+ *  Translations for names of the commonly used locales.
  *  `locale` parameter format for OCAPI and Commerce API: <language code>-<country code>
  *  https://documentation.b2c.commercecloud.salesforce.com/DOC1/topic/com.demandware.dochelp/OCAPI/current/usage/Localization.html
  */
diff --git a/packages/template-retail-react-app/app/components/product-view/index.test.js b/packages/template-retail-react-app/app/components/product-view/index.test.js
index b4d1df55ed..ab5e712760 100644
--- a/packages/template-retail-react-app/app/components/product-view/index.test.js
+++ b/packages/template-retail-react-app/app/components/product-view/index.test.js
@@ -15,6 +15,7 @@ import ProductView from '@salesforce/retail-react-app/app/components/product-vie
 import {renderWithProviders} from '@salesforce/retail-react-app/app/utils/test-utils'
 import userEvent from '@testing-library/user-event'
 import {useCurrentCustomer} from '@salesforce/retail-react-app/app/hooks/use-current-customer'
+import frMessages from '@salesforce/retail-react-app/app/static/translations/compiled/fr-FR.json'
 
 const MockComponent = (props) => {
     const {data: customer} = useCurrentCustomer()
@@ -346,3 +347,25 @@ test('renders a product bundle properly - child item', () => {
     expect(addToWishlistButton).toBeNull()
     expect(quantityPicker).toBeNull()
 })
+
+test('renders "Add to Cart" and "Add to Wishlist" buttons in French', async () => {
+    const addToCart = jest.fn()
+    const addToWishlist = jest.fn()
+    renderWithProviders(
+        <MockComponent
+            product={mockProductDetail}
+            addToCart={addToCart}
+            addToWishlist={addToWishlist}
+        />,
+        {
+            wrapperProps: {locale: {id: 'fr-FR'}, messages: frMessages}
+        }
+    )
+
+    const titles = await screen.findAllByText(/Black Single Pleat Athletic Fit Wool Suit/i)
+    expect(titles.length).toBeGreaterThan(0)
+    expect(screen.getByRole('button', {name: /ajouter au panier/i})).toBeInTheDocument()
+    expect(
+        screen.getByRole('button', {name: /ajouter à la liste de souhaits/i})
+    ).toBeInTheDocument()
+})
diff --git a/packages/template-retail-react-app/app/components/store-locator-modal/index.jsx b/packages/template-retail-react-app/app/components/store-locator-modal/index.jsx
deleted file mode 100644
index 8bb5920cbb..0000000000
--- a/packages/template-retail-react-app/app/components/store-locator-modal/index.jsx
+++ /dev/null
@@ -1,102 +0,0 @@
-/*
- * Copyright (c) 2021, salesforce.com, inc.
- * All rights reserved.
- * SPDX-License-Identifier: BSD-3-Clause
- * For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/BSD-3-Clause
- */
-
-import React, {useState, createContext} from 'react'
-import PropTypes from 'prop-types'
-
-// Components
-import {
-    Modal,
-    ModalBody,
-    ModalCloseButton,
-    ModalContent,
-    useBreakpointValue
-} from '@salesforce/retail-react-app/app/components/shared/ui'
-import StoreLocatorContent from '@salesforce/retail-react-app/app/components/store-locator-modal/store-locator-content'
-
-// Others
-import {
-    DEFAULT_STORE_LOCATOR_COUNTRY,
-    DEFAULT_STORE_LOCATOR_POSTAL_CODE,
-    STORE_LOCATOR_NUM_STORES_PER_LOAD
-} from '@salesforce/retail-react-app/app/constants'
-
-export const StoreLocatorContext = createContext()
-export const useStoreLocator = () => {
-    const [userHasSetManualGeolocation, setUserHasSetManualGeolocation] = useState(false)
-    const [automaticGeolocationHasFailed, setAutomaticGeolocationHasFailed] = useState(false)
-    const [userWantsToShareLocation, setUserWantsToShareLocation] = useState(false)
-
-    const [searchStoresParams, setSearchStoresParams] = useState({
-        countryCode: DEFAULT_STORE_LOCATOR_COUNTRY.countryCode,
-        postalCode: DEFAULT_STORE_LOCATOR_POSTAL_CODE,
-        limit: STORE_LOCATOR_NUM_STORES_PER_LOAD
-    })
-
-    return {
-        userHasSetManualGeolocation,
-        setUserHasSetManualGeolocation,
-        automaticGeolocationHasFailed,
-        setAutomaticGeolocationHasFailed,
-        userWantsToShareLocation,
-        setUserWantsToShareLocation,
-        searchStoresParams,
-        setSearchStoresParams
-    }
-}
-
-const StoreLocatorModal = ({isOpen, onClose}) => {
-    const storeLocator = useStoreLocator()
-    const isDesktopView = useBreakpointValue({base: false, lg: true})
-
-    return (
-        <StoreLocatorContext.Provider value={storeLocator}>
-            {isDesktopView ? (
-                <Modal size="4xl" isOpen={isOpen} onClose={onClose}>
-                    <ModalContent
-                        position="absolute"
-                        top="0"
-                        right="0"
-                        width="33.33%"
-                        height="100vh"
-                        marginTop="0px"
-                        overflowY="auto"
-                        borderLeft="1px solid"
-                        borderColor="gray.200"
-                    >
-                        <ModalCloseButton onClick={onClose} />
-                        <ModalBody pb={8} bg="white" paddingBottom={6} paddingTop={6}>
-                            <StoreLocatorContent />
-                        </ModalBody>
-                    </ModalContent>
-                </Modal>
-            ) : (
-                <Modal size="4xl" isOpen={isOpen} onClose={onClose}>
-                    <ModalContent
-                        position="absolute"
-                        top="0"
-                        right="0"
-                        height="100vh"
-                        marginTop="0px"
-                    >
-                        <ModalCloseButton onClick={onClose} />
-                        <ModalBody pb={8} bg="white" paddingBottom={6} marginTop={6}>
-                            <StoreLocatorContent />
-                        </ModalBody>
-                    </ModalContent>
-                </Modal>
-            )}
-        </StoreLocatorContext.Provider>
-    )
-}
-
-StoreLocatorModal.propTypes = {
-    isOpen: PropTypes.bool,
-    onClose: PropTypes.func
-}
-
-export default StoreLocatorModal
diff --git a/packages/template-retail-react-app/app/components/store-locator-modal/index.test.jsx b/packages/template-retail-react-app/app/components/store-locator-modal/index.test.jsx
deleted file mode 100644
index 2fadf4cb89..0000000000
--- a/packages/template-retail-react-app/app/components/store-locator-modal/index.test.jsx
+++ /dev/null
@@ -1,212 +0,0 @@
-/*
- * Copyright (c) 2021, salesforce.com, inc.
- * All rights reserved.
- * SPDX-License-Identifier: BSD-3-Clause
- * For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/BSD-3-Clause
- */
-
-import React from 'react'
-import StoreLocatorModal from '@salesforce/retail-react-app/app/components/store-locator-modal/index'
-import {renderWithProviders} from '@salesforce/retail-react-app/app/utils/test-utils'
-import {rest} from 'msw'
-
-const mockStoresData = [
-    {
-        address1: '162 University Ave',
-        city: 'Palo Alto',
-        countryCode: 'US',
-        distance: 0.0,
-        distanceUnit: 'km',
-        id: '00041',
-        latitude: 37.189396,
-        longitude: -121.705327,
-        name: 'Palo Alto Store',
-        posEnabled: false,
-        postalCode: '94301',
-        stateCode: 'CA',
-        storeHours: 'THIS IS ENGLISH STORE HOURS',
-        storeLocatorEnabled: true,
-        c_countryCodeValue: 'US'
-    },
-    {
-        address1: 'Holstenstraße 1',
-        city: 'Kiel',
-        countryCode: 'DE',
-        distance: 8847.61,
-        distanceUnit: 'km',
-        id: '00031',
-        inventoryId: 'inventory_m_store_store23',
-        latitude: 54.3233,
-        longitude: 10.1394,
-        name: 'Kiel Electronics Store',
-        phone: '+49 431 123456',
-        posEnabled: false,
-        postalCode: '24103',
-        storeHours:
-            'Monday 9 AM–7 PM\nTuesday 9 AM–7 PM\nWednesday 9 AM–7 PM\nThursday 9 AM–8 PM\nFriday 9 AM–7 PM\nSaturday 9 AM–6 PM\nSunday Closed',
-        storeLocatorEnabled: true
-    },
-    {
-        address1: 'Heiligengeiststraße 2',
-        city: 'Oldenburg',
-        countryCode: 'DE',
-        distance: 8873.75,
-        distanceUnit: 'km',
-        id: '00036',
-        inventoryId: 'inventory_m_store_store28',
-        latitude: 53.1445,
-        longitude: 8.2146,
-        name: 'Oldenburg Tech Depot',
-        phone: '+49 441 876543',
-        posEnabled: false,
-        postalCode: '26121',
-        storeHours:
-            'Monday 10 AM–7 PM\nTuesday 10 AM–7 PM\nWednesday 10 AM–7 PM\nThursday 10 AM–8 PM\nFriday 10 AM–7 PM\nSaturday 10 AM–6 PM\nSunday Closed',
-        storeLocatorEnabled: true
-    },
-    {
-        address1: 'Obernstraße 2',
-        city: 'Bremen',
-        countryCode: 'DE',
-        distance: 8904.18,
-        distanceUnit: 'km',
-        id: '00011',
-        inventoryId: 'inventory_m_store_store2',
-        latitude: 53.0765,
-        longitude: 8.8085,
-        name: 'Bremen Tech Store',
-        phone: '+49 421 234567',
-        posEnabled: false,
-        postalCode: '28195',
-        storeHours:
-            'Monday 10 AM–7 PM\nTuesday 10 AM–7 PM\nWednesday 10 AM–7 PM\nThursday 10 AM–8 PM\nFriday 10 AM–7 PM\nSaturday 10 AM–6 PM\nSunday Closed',
-        storeLocatorEnabled: true
-    },
-    {
-        address1: 'Sögestraße 40',
-        city: 'Bremen',
-        countryCode: 'DE',
-        distance: 8904.19,
-        distanceUnit: 'km',
-        id: '00026',
-        inventoryId: 'inventory_m_store_store18',
-        latitude: 53.0758,
-        longitude: 8.8072,
-        name: 'Bremen Tech World',
-        phone: '+49 421 567890',
-        posEnabled: false,
-        postalCode: '28195',
-        storeHours:
-            'Monday 9 AM–8 PM\nTuesday 9 AM–8 PM\nWednesday 9 AM–8 PM\nThursday 9 AM–9 PM\nFriday 9 AM–8 PM\nSaturday 9 AM–7 PM\nSunday Closed',
-        storeLocatorEnabled: true
-    },
-    {
-        address1: 'Jungfernstieg 12',
-        city: 'Hamburg',
-        countryCode: 'DE',
-        distance: 8910.05,
-        distanceUnit: 'km',
-        id: '00005',
-        inventoryId: 'inventory_m_store_store5',
-        latitude: 53.553405,
-        longitude: 9.992196,
-        name: 'Hamburg Electronics Outlet',
-        phone: '+49 40 444444444',
-        posEnabled: false,
-        postalCode: '20354',
-        storeHours:
-            'Monday 10 AM–8 PM\nTuesday 10 AM–8 PM\nWednesday 10 AM–8 PM\nThursday 10 AM–9 PM\nFriday 10 AM–8 PM\nSaturday 10 AM–7 PM\nSunday Closed',
-        storeLocatorEnabled: true
-    },
-    {
-        address1: 'Große Straße 40',
-        city: 'Osnabrück',
-        countryCode: 'DE',
-        distance: 8942.1,
-        distanceUnit: 'km',
-        id: '00037',
-        inventoryId: 'inventory_m_store_store29',
-        latitude: 52.2799,
-        longitude: 8.0472,
-        name: 'Osnabrück Tech Mart',
-        phone: '+49 541 654321',
-        posEnabled: false,
-        postalCode: '49074',
-        storeHours:
-            'Monday 10 AM–7 PM\nTuesday 10 AM–7 PM\nWednesday 10 AM–7 PM\nThursday 10 AM–8 PM\nFriday 10 AM–7 PM\nSaturday 10 AM–6 PM\nSunday Closed',
-        storeLocatorEnabled: true
-    },
-    {
-        address1: 'Kröpeliner Straße 48',
-        city: 'Rostock',
-        countryCode: 'DE',
-        distance: 8945.47,
-        distanceUnit: 'km',
-        id: '00032',
-        inventoryId: 'inventory_m_store_store24',
-        latitude: 54.0899,
-        longitude: 12.1349,
-        name: 'Rostock Tech Store',
-        phone: '+49 381 234567',
-        posEnabled: false,
-        postalCode: '18055',
-        storeHours:
-            'Monday 10 AM–7 PM\nTuesday 10 AM–7 PM\nWednesday 10 AM–7 PM\nThursday 10 AM–8 PM\nFriday 10 AM–7 PM\nSaturday 10 AM–6 PM\nSunday Closed',
-        storeLocatorEnabled: true
-    },
-    {
-        address1: 'Kennedyplatz 7',
-        city: 'Essen',
-        countryCode: 'DE',
-        distance: 8969.09,
-        distanceUnit: 'km',
-        id: '00013',
-        inventoryId: 'inventory_m_store_store4',
-        latitude: 51.4566,
-        longitude: 7.0125,
-        name: 'Essen Electronics Depot',
-        phone: '+49 201 456789',
-        posEnabled: false,
-        postalCode: '45127',
-        storeHours:
-            'Monday 10 AM–7 PM\nTuesday 10 AM–7 PM\nWednesday 10 AM–7 PM\nThursday 10 AM–8 PM\nFriday 10 AM–7 PM\nSaturday 10 AM–6 PM\nSunday Closed',
-        storeLocatorEnabled: true
-    },
-    {
-        address1: 'Kettwiger Straße 17',
-        city: 'Essen',
-        countryCode: 'DE',
-        distance: 8969.13,
-        distanceUnit: 'km',
-        id: '00030',
-        inventoryId: 'inventory_m_store_store22',
-        latitude: 51.4556,
-        longitude: 7.0116,
-        name: 'Essen Tech Hub',
-        phone: '+49 201 654321',
-        posEnabled: false,
-        postalCode: '45127',
-        storeHours:
-            'Monday 10 AM–7 PM\nTuesday 10 AM–7 PM\nWednesday 10 AM–7 PM\nThursday 10 AM–8 PM\nFriday 10 AM–7 PM\nSaturday 10 AM–6 PM\nSunday Closed',
-        storeLocatorEnabled: true
-    }
-]
-const mockStores = {
-    limit: 10,
-    data: mockStoresData,
-    offset: 0,
-    total: 30
-}
-
-describe('StoreLocatorModal', () => {
-    test('renders without crashing', () => {
-        global.server.use(
-            rest.get('*/shopper-stores/v1/organizations/*', (req, res, ctx) => {
-                return res(ctx.delay(0), ctx.status(200), ctx.json(mockStores))
-            })
-        )
-        expect(() => {
-            renderWithProviders(<StoreLocatorModal />)
-        }).not.toThrow()
-    })
-})
diff --git a/packages/template-retail-react-app/app/components/store-locator-modal/store-locator-content.jsx b/packages/template-retail-react-app/app/components/store-locator-modal/store-locator-content.jsx
deleted file mode 100644
index 10bf5b80f2..0000000000
--- a/packages/template-retail-react-app/app/components/store-locator-modal/store-locator-content.jsx
+++ /dev/null
@@ -1,213 +0,0 @@
-/*
- * Copyright (c) 2021, salesforce.com, inc.
- * All rights reserved.
- * SPDX-License-Identifier: BSD-3-Clause
- * For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/BSD-3-Clause
- */
-
-import React, {useState, useContext} from 'react'
-import {useIntl} from 'react-intl'
-
-// Components
-import {
-    Heading,
-    Accordion,
-    AccordionItem,
-    Box,
-    Button
-} from '@salesforce/retail-react-app/app/components/shared/ui'
-import StoresList from '@salesforce/retail-react-app/app/components/store-locator-modal/stores-list'
-import StoreLocatorInput from '@salesforce/retail-react-app/app/components/store-locator-modal/store-locator-input'
-
-// Others
-import {
-    SUPPORTED_STORE_LOCATOR_COUNTRIES,
-    DEFAULT_STORE_LOCATOR_COUNTRY,
-    STORE_LOCATOR_DISTANCE,
-    STORE_LOCATOR_NUM_STORES_PER_LOAD,
-    STORE_LOCATOR_DISTANCE_UNIT
-} from '@salesforce/retail-react-app/app/constants'
-
-//This is an API limit and is therefore not configurable
-const NUM_STORES_PER_REQUEST_API_MAX = 200
-
-// Hooks
-import {useSearchStores} from '@salesforce/commerce-sdk-react'
-import {useForm} from 'react-hook-form'
-
-import {StoreLocatorContext} from '@salesforce/retail-react-app/app/components/store-locator-modal/index'
-
-const StoreLocatorContent = () => {
-    const {
-        searchStoresParams,
-        setSearchStoresParams,
-        userHasSetManualGeolocation,
-        setUserHasSetManualGeolocation
-    } = useContext(StoreLocatorContext)
-    const {countryCode, postalCode, latitude, longitude, limit} = searchStoresParams
-    const intl = useIntl()
-    const form = useForm({
-        mode: 'onChange',
-        reValidateMode: 'onChange',
-        defaultValues: {
-            countryCode: userHasSetManualGeolocation ? countryCode : '',
-            postalCode: userHasSetManualGeolocation ? postalCode : ''
-        }
-    })
-
-    const [numStoresToShow, setNumStoresToShow] = useState(limit)
-    // Either the countryCode & postalCode or latitude & longitude are defined, never both
-    const {
-        data: searchStoresData,
-        isLoading,
-        refetch,
-        isFetching
-    } = useSearchStores({
-        parameters: {
-            countryCode: countryCode,
-            postalCode: postalCode,
-            latitude: latitude,
-            longitude: longitude,
-            locale: intl.locale,
-            maxDistance: STORE_LOCATOR_DISTANCE,
-            limit: NUM_STORES_PER_REQUEST_API_MAX,
-            distanceUnit: STORE_LOCATOR_DISTANCE_UNIT
-        }
-    })
-
-    const storesInfo =
-        isLoading || isFetching
-            ? undefined
-            : searchStoresData?.data?.slice(0, numStoresToShow) || []
-    const numStores = searchStoresData?.total || 0
-
-    const submitForm = async (formData) => {
-        const {postalCode, countryCode} = formData
-        if (postalCode !== '') {
-            if (countryCode !== '') {
-                setSearchStoresParams({
-                    postalCode: postalCode,
-                    countryCode: countryCode,
-                    limit: STORE_LOCATOR_NUM_STORES_PER_LOAD
-                })
-                setUserHasSetManualGeolocation(true)
-            } else {
-                if (SUPPORTED_STORE_LOCATOR_COUNTRIES.length === 0) {
-                    setSearchStoresParams({
-                        postalCode: postalCode,
-                        countryCode: DEFAULT_STORE_LOCATOR_COUNTRY.countryCode,
-                        limit: STORE_LOCATOR_NUM_STORES_PER_LOAD
-                    })
-                    setUserHasSetManualGeolocation(true)
-                }
-            }
-        }
-        // Reset the number of stores in the UI
-        setNumStoresToShow(STORE_LOCATOR_NUM_STORES_PER_LOAD)
-
-        // Ensures API call is made regardless of caching to provide UX feedback on click
-        refetch()
-    }
-
-    const displayStoreLocatorStatusMessage = () => {
-        if (storesInfo === undefined)
-            return intl.formatMessage({
-                id: 'store_locator.description.loading_locations',
-                defaultMessage: 'Loading locations...'
-            })
-        if (storesInfo.length === 0)
-            return intl.formatMessage({
-                id: 'store_locator.description.no_locations',
-                defaultMessage: 'Sorry, there are no locations in this area'
-            })
-        if (searchStoresParams.postalCode !== undefined)
-            return `${intl.formatMessage(
-                {
-                    id: 'store_locator.description.viewing_near_postal_code',
-                    defaultMessage:
-                        'Viewing stores within {distance}{distanceUnit} of {postalCode} in '
-                },
-                {
-                    distance: STORE_LOCATOR_DISTANCE,
-                    distanceUnit: STORE_LOCATOR_DISTANCE_UNIT,
-                    postalCode: searchStoresParams.postalCode
-                }
-            )}
-                ${
-                    SUPPORTED_STORE_LOCATOR_COUNTRIES.length !== 0
-                        ? intl.formatMessage(
-                              SUPPORTED_STORE_LOCATOR_COUNTRIES.find(
-                                  (o) => o.countryCode === searchStoresParams.countryCode
-                              ).countryName
-                          )
-                        : intl.formatMessage(DEFAULT_STORE_LOCATOR_COUNTRY.countryName)
-                }`
-        else
-            return intl.formatMessage({
-                id: 'store_locator.description.viewing_near_your_location',
-                defaultMessage: 'Viewing stores near your location'
-            })
-    }
-
-    return (
-        <>
-            <Heading fontSize="2xl" style={{marginBottom: '25px'}}>
-                {intl.formatMessage({
-                    id: 'store_locator.title',
-                    defaultMessage: 'Find a Store'
-                })}
-            </Heading>
-            <StoreLocatorInput form={form} submitForm={submitForm}></StoreLocatorInput>
-            <Accordion allowMultiple flex={[1, 1, 1, 5]}>
-                {/* Details */}
-                <AccordionItem>
-                    <Box
-                        flex="1"
-                        fontWeight="semibold"
-                        fontSize="md"
-                        style={{
-                            display: 'flex',
-                            justifyContent: 'center',
-                            alignItems: 'center',
-                            margin: '20px'
-                        }}
-                    >
-                        {displayStoreLocatorStatusMessage()}
-                    </Box>
-                </AccordionItem>
-                <StoresList storesInfo={storesInfo} />
-            </Accordion>
-            {!isFetching &&
-            numStoresToShow < numStores &&
-            numStoresToShow < NUM_STORES_PER_REQUEST_API_MAX ? (
-                <Box paddingTop="10px" marginTop="10px">
-                    <Button
-                        key="load-more-button"
-                        onClick={() => {
-                            setNumStoresToShow(
-                                numStoresToShow + STORE_LOCATOR_NUM_STORES_PER_LOAD <=
-                                    NUM_STORES_PER_REQUEST_API_MAX
-                                    ? numStoresToShow + STORE_LOCATOR_NUM_STORES_PER_LOAD
-                                    : numStoresToShow
-                            )
-                        }}
-                        width="100%"
-                        variant="outline"
-                        marginBottom={4}
-                    >
-                        {intl.formatMessage({
-                            id: 'store_locator.pagination.load_more',
-                            defaultMessage: 'Load More'
-                        })}
-                    </Button>
-                </Box>
-            ) : (
-                ''
-            )}
-        </>
-    )
-}
-
-StoreLocatorContent.propTypes = {}
-
-export default StoreLocatorContent
diff --git a/packages/template-retail-react-app/app/components/store-locator-modal/store-locator-content.test.jsx b/packages/template-retail-react-app/app/components/store-locator-modal/store-locator-content.test.jsx
deleted file mode 100644
index 38e8c8458c..0000000000
--- a/packages/template-retail-react-app/app/components/store-locator-modal/store-locator-content.test.jsx
+++ /dev/null
@@ -1,399 +0,0 @@
-/*
- * Copyright (c) 2021, salesforce.com, inc.
- * All rights reserved.
- * SPDX-License-Identifier: BSD-3-Clause
- * For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/BSD-3-Clause
- */
-
-import React, {useEffect} from 'react'
-import StoreLocatorContent from '@salesforce/retail-react-app/app/components/store-locator-modal/store-locator-content'
-import {renderWithProviders} from '@salesforce/retail-react-app/app/utils/test-utils'
-import {waitFor, screen} from '@testing-library/react'
-import PropTypes from 'prop-types'
-import {STORE_LOCATOR_NUM_STORES_PER_LOAD} from '@salesforce/retail-react-app/app/constants'
-import {rest} from 'msw'
-import {StoreLocatorContext} from '@salesforce/retail-react-app/app/components/store-locator-modal/index'
-import {useStoreLocator} from '@salesforce/retail-react-app/app/components/store-locator-modal/index'
-const mockStoresData = [
-    {
-        address1: '162 University Ave',
-        city: 'Palo Alto',
-        countryCode: 'US',
-        distance: 0.0,
-        distanceUnit: 'km',
-        id: '00041',
-        latitude: 37.189396,
-        longitude: -121.705327,
-        name: 'Palo Alto Store',
-        posEnabled: false,
-        postalCode: '94301',
-        stateCode: 'CA',
-        storeHours: 'THIS IS ENGLISH STORE HOURS',
-        storeLocatorEnabled: true,
-        c_countryCodeValue: 'US'
-    },
-    {
-        address1: 'Holstenstraße 1',
-        city: 'Kiel',
-        countryCode: 'DE',
-        distance: 8847.61,
-        distanceUnit: 'km',
-        id: '00031',
-        inventoryId: 'inventory_m_store_store23',
-        latitude: 54.3233,
-        longitude: 10.1394,
-        name: 'Kiel Electronics Store',
-        phone: '+49 431 123456',
-        posEnabled: false,
-        postalCode: '24103',
-        storeHours:
-            'Monday 9 AM–7 PM\nTuesday 9 AM–7 PM\nWednesday 9 AM–7 PM\nThursday 9 AM–8 PM\nFriday 9 AM–7 PM\nSaturday 9 AM–6 PM\nSunday Closed',
-        storeLocatorEnabled: true
-    },
-    {
-        address1: 'Heiligengeiststraße 2',
-        city: 'Oldenburg',
-        countryCode: 'DE',
-        distance: 8873.75,
-        distanceUnit: 'km',
-        id: '00036',
-        inventoryId: 'inventory_m_store_store28',
-        latitude: 53.1445,
-        longitude: 8.2146,
-        name: 'Oldenburg Tech Depot',
-        phone: '+49 441 876543',
-        posEnabled: false,
-        postalCode: '26121',
-        storeHours:
-            'Monday 10 AM–7 PM\nTuesday 10 AM–7 PM\nWednesday 10 AM–7 PM\nThursday 10 AM–8 PM\nFriday 10 AM–7 PM\nSaturday 10 AM–6 PM\nSunday Closed',
-        storeLocatorEnabled: true
-    },
-    {
-        address1: 'Obernstraße 2',
-        city: 'Bremen',
-        countryCode: 'DE',
-        distance: 8904.18,
-        distanceUnit: 'km',
-        id: '00011',
-        inventoryId: 'inventory_m_store_store2',
-        latitude: 53.0765,
-        longitude: 8.8085,
-        name: 'Bremen Tech Store',
-        phone: '+49 421 234567',
-        posEnabled: false,
-        postalCode: '28195',
-        storeHours:
-            'Monday 10 AM–7 PM\nTuesday 10 AM–7 PM\nWednesday 10 AM–7 PM\nThursday 10 AM–8 PM\nFriday 10 AM–7 PM\nSaturday 10 AM–6 PM\nSunday Closed',
-        storeLocatorEnabled: true
-    },
-    {
-        address1: 'Sögestraße 40',
-        city: 'Bremen',
-        countryCode: 'DE',
-        distance: 8904.19,
-        distanceUnit: 'km',
-        id: '00026',
-        inventoryId: 'inventory_m_store_store18',
-        latitude: 53.0758,
-        longitude: 8.8072,
-        name: 'Bremen Tech World',
-        phone: '+49 421 567890',
-        posEnabled: false,
-        postalCode: '28195',
-        storeHours:
-            'Monday 9 AM–8 PM\nTuesday 9 AM–8 PM\nWednesday 9 AM–8 PM\nThursday 9 AM–9 PM\nFriday 9 AM–8 PM\nSaturday 9 AM–7 PM\nSunday Closed',
-        storeLocatorEnabled: true
-    },
-    {
-        address1: 'Jungfernstieg 12',
-        city: 'Hamburg',
-        countryCode: 'DE',
-        distance: 8910.05,
-        distanceUnit: 'km',
-        id: '00005',
-        inventoryId: 'inventory_m_store_store5',
-        latitude: 53.553405,
-        longitude: 9.992196,
-        name: 'Hamburg Electronics Outlet',
-        phone: '+49 40 444444444',
-        posEnabled: false,
-        postalCode: '20354',
-        storeHours:
-            'Monday 10 AM–8 PM\nTuesday 10 AM–8 PM\nWednesday 10 AM–8 PM\nThursday 10 AM–9 PM\nFriday 10 AM–8 PM\nSaturday 10 AM–7 PM\nSunday Closed',
-        storeLocatorEnabled: true
-    },
-    {
-        address1: 'Große Straße 40',
-        city: 'Osnabrück',
-        countryCode: 'DE',
-        distance: 8942.1,
-        distanceUnit: 'km',
-        id: '00037',
-        inventoryId: 'inventory_m_store_store29',
-        latitude: 52.2799,
-        longitude: 8.0472,
-        name: 'Osnabrück Tech Mart',
-        phone: '+49 541 654321',
-        posEnabled: false,
-        postalCode: '49074',
-        storeHours:
-            'Monday 10 AM–7 PM\nTuesday 10 AM–7 PM\nWednesday 10 AM–7 PM\nThursday 10 AM–8 PM\nFriday 10 AM–7 PM\nSaturday 10 AM–6 PM\nSunday Closed',
-        storeLocatorEnabled: true
-    },
-    {
-        address1: 'Kröpeliner Straße 48',
-        city: 'Rostock',
-        countryCode: 'DE',
-        distance: 8945.47,
-        distanceUnit: 'km',
-        id: '00032',
-        inventoryId: 'inventory_m_store_store24',
-        latitude: 54.0899,
-        longitude: 12.1349,
-        name: 'Rostock Tech Store',
-        phone: '+49 381 234567',
-        posEnabled: false,
-        postalCode: '18055',
-        storeHours:
-            'Monday 10 AM–7 PM\nTuesday 10 AM–7 PM\nWednesday 10 AM–7 PM\nThursday 10 AM–8 PM\nFriday 10 AM–7 PM\nSaturday 10 AM–6 PM\nSunday Closed',
-        storeLocatorEnabled: true
-    },
-    {
-        address1: 'Kennedyplatz 7',
-        city: 'Essen',
-        countryCode: 'DE',
-        distance: 8969.09,
-        distanceUnit: 'km',
-        id: '00013',
-        inventoryId: 'inventory_m_store_store4',
-        latitude: 51.4566,
-        longitude: 7.0125,
-        name: 'Essen Electronics Depot',
-        phone: '+49 201 456789',
-        posEnabled: false,
-        postalCode: '45127',
-        storeHours:
-            'Monday 10 AM–7 PM\nTuesday 10 AM–7 PM\nWednesday 10 AM–7 PM\nThursday 10 AM–8 PM\nFriday 10 AM–7 PM\nSaturday 10 AM–6 PM\nSunday Closed',
-        storeLocatorEnabled: true
-    },
-    {
-        address1: 'Kettwiger Straße 17',
-        city: 'Essen',
-        countryCode: 'DE',
-        distance: 8969.13,
-        distanceUnit: 'km',
-        id: '00030',
-        inventoryId: 'inventory_m_store_store22',
-        latitude: 51.4556,
-        longitude: 7.0116,
-        name: 'Essen Tech Hub',
-        phone: '+49 201 654321',
-        posEnabled: false,
-        postalCode: '45127',
-        storeHours:
-            'Monday 10 AM–7 PM\nTuesday 10 AM–7 PM\nWednesday 10 AM–7 PM\nThursday 10 AM–8 PM\nFriday 10 AM–7 PM\nSaturday 10 AM–6 PM\nSunday Closed',
-        storeLocatorEnabled: true
-    }
-]
-const mockStoresTotalIsHigherThanLimit = {
-    limit: 10,
-    data: mockStoresData,
-    offset: 0,
-    total: 30
-}
-
-const mockStoresTotalIsEqualToLimit = {
-    limit: 10,
-    data: mockStoresData,
-    offset: 0,
-    total: 10
-}
-
-const mockNoStores = {
-    limit: 0,
-    total: 0
-}
-
-const WrapperComponent = ({searchStoresParams, userHasSetManualGeolocation}) => {
-    const storeLocator = useStoreLocator()
-    useEffect(() => {
-        storeLocator.setSearchStoresParams(searchStoresParams)
-        storeLocator.setUserHasSetManualGeolocation(userHasSetManualGeolocation)
-    }, [])
-    return (
-        <StoreLocatorContext.Provider value={storeLocator}>
-            <StoreLocatorContent />
-        </StoreLocatorContext.Provider>
-    )
-}
-WrapperComponent.propTypes = {
-    storesInfo: PropTypes.array,
-    userHasSetManualGeolocation: PropTypes.bool,
-    searchStoresParams: PropTypes.object
-}
-
-describe('StoreLocatorContent', () => {
-    test('renders without crashing', () => {
-        global.server.use(
-            rest.get('*/shopper-stores/v1/organizations/*', (req, res, ctx) => {
-                return res(
-                    ctx.delay(0),
-                    ctx.status(200),
-                    ctx.json(mockStoresTotalIsHigherThanLimit)
-                )
-            })
-        )
-        expect(() => {
-            renderWithProviders(
-                <WrapperComponent
-                    searchStoresParams={{
-                        postalCode: '10178',
-                        countryCode: 'DE',
-                        limit: STORE_LOCATOR_NUM_STORES_PER_LOAD
-                    }}
-                    userHasSetManualGeolocation={true}
-                />
-            )
-        }).not.toThrow()
-    })
-
-    test('Expected information exists', async () => {
-        global.server.use(
-            rest.get('*/shopper-stores/v1/organizations/*', (req, res, ctx) => {
-                return res(
-                    ctx.delay(0),
-                    ctx.status(200),
-                    ctx.json(mockStoresTotalIsHigherThanLimit)
-                )
-            })
-        )
-        renderWithProviders(
-            <WrapperComponent
-                searchStoresParams={{
-                    postalCode: '10178',
-                    countryCode: 'DE',
-                    limit: STORE_LOCATOR_NUM_STORES_PER_LOAD
-                }}
-                userHasSetManualGeolocation={true}
-            />
-        )
-
-        await waitFor(async () => {
-            const findButton = screen.getByRole('button', {name: /Find/i})
-            const useMyLocationButton = screen.getByRole('button', {name: /Use My Location/i})
-            const descriptionFindAStore = screen.getByText(/Find a Store/i)
-            const viewing = screen.getByText(/Viewing stores within 100km of 10178 in Germany/i)
-
-            expect(findButton).toBeInTheDocument()
-            expect(useMyLocationButton).toBeInTheDocument()
-            expect(descriptionFindAStore).toBeInTheDocument()
-            expect(viewing).toBeInTheDocument()
-        })
-    })
-
-    test('No stores text exists', async () => {
-        global.server.use(
-            rest.get('*/shopper-stores/v1/organizations/*', (req, res, ctx) => {
-                return res(ctx.delay(0), ctx.status(200), ctx.json(mockNoStores))
-            })
-        )
-        renderWithProviders(
-            <WrapperComponent
-                searchStoresParams={{
-                    postalCode: '10178',
-                    countryCode: 'DE',
-                    limit: STORE_LOCATOR_NUM_STORES_PER_LOAD
-                }}
-                userHasSetManualGeolocation={true}
-            />
-        )
-
-        await waitFor(async () => {
-            const noLocations = screen.getByText(/Sorry, there are no locations in this area/i)
-
-            expect(noLocations).toBeInTheDocument()
-        })
-    })
-
-    test('Near your location text exists', async () => {
-        global.server.use(
-            rest.get('*/shopper-stores/v1/organizations/*', (req, res, ctx) => {
-                return res(
-                    ctx.delay(0),
-                    ctx.status(200),
-                    ctx.json(mockStoresTotalIsHigherThanLimit)
-                )
-            })
-        )
-
-        renderWithProviders(
-            <WrapperComponent
-                searchStoresParams={{
-                    latitude: 100,
-                    longitude: 100,
-                    limit: STORE_LOCATOR_NUM_STORES_PER_LOAD
-                }}
-                userHasSetManualGeolocation={true}
-            />
-        )
-
-        await waitFor(async () => {
-            const nearYourLocation = screen.getByText(/Viewing stores near your location/i)
-
-            expect(nearYourLocation).toBeInTheDocument()
-        })
-    })
-
-    test('Load More button exists when total stores is higher than display limit', async () => {
-        global.server.use(
-            rest.get('*/shopper-stores/v1/organizations/*', (req, res, ctx) => {
-                return res(
-                    ctx.delay(0),
-                    ctx.status(200),
-                    ctx.json(mockStoresTotalIsHigherThanLimit)
-                )
-            })
-        )
-
-        renderWithProviders(
-            <WrapperComponent
-                searchStoresParams={{
-                    postalCode: '10178',
-                    countryCode: 'DE',
-                    limit: STORE_LOCATOR_NUM_STORES_PER_LOAD
-                }}
-                userHasSetManualGeolocation={true}
-            />
-        )
-        await waitFor(async () => {
-            const findButton = screen.getByRole('button', {name: /Find/i})
-            const aStore = screen.getByText(/162 University Ave/i)
-            const loadMore = screen.getByText(/Load More/i)
-            expect(findButton).toBeInTheDocument()
-            expect(aStore).toBeInTheDocument()
-            expect(loadMore).toBeInTheDocument()
-        })
-    })
-
-    test('Load More button doesnt exist when total stores is equal to display limit', async () => {
-        global.server.use(
-            rest.get('*/shopper-stores/v1/organizations/*', (req, res, ctx) => {
-                return res(ctx.delay(0), ctx.status(200), ctx.json(mockStoresTotalIsEqualToLimit))
-            })
-        )
-        renderWithProviders(
-            <WrapperComponent
-                searchStoresParams={{
-                    postalCode: '10178',
-                    countryCode: 'DE',
-                    limit: STORE_LOCATOR_NUM_STORES_PER_LOAD
-                }}
-                userHasSetManualGeolocation={true}
-            />
-        )
-        await waitFor(() => {
-            const loadMore = screen.queryByText(/Load More/i)
-            expect(loadMore).not.toBeInTheDocument()
-        })
-    })
-})
diff --git a/packages/template-retail-react-app/app/components/store-locator-modal/store-locator-input.jsx b/packages/template-retail-react-app/app/components/store-locator-modal/store-locator-input.jsx
deleted file mode 100644
index c7c4bc6321..0000000000
--- a/packages/template-retail-react-app/app/components/store-locator-modal/store-locator-input.jsx
+++ /dev/null
@@ -1,230 +0,0 @@
-/*
- * Copyright (c) 2021, salesforce.com, inc.
- * All rights reserved.
- * SPDX-License-Identifier: BSD-3-Clause
- * For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/BSD-3-Clause
- */
-
-import React, {useEffect, useContext} from 'react'
-import {useIntl} from 'react-intl'
-import PropTypes from 'prop-types'
-
-// Components
-import {
-    Button,
-    InputGroup,
-    Select,
-    Box,
-    Input,
-    FormControl,
-    FormErrorMessage
-} from '@salesforce/retail-react-app/app/components/shared/ui'
-import {AlertIcon} from '@salesforce/retail-react-app/app/components/icons'
-import {Controller} from 'react-hook-form'
-
-// Others
-import {
-    SUPPORTED_STORE_LOCATOR_COUNTRIES,
-    STORE_LOCATOR_NUM_STORES_PER_LOAD
-} from '@salesforce/retail-react-app/app/constants'
-import {StoreLocatorContext} from '@salesforce/retail-react-app/app/components/store-locator-modal/index'
-
-const useGeolocation = () => {
-    const {
-        setSearchStoresParams,
-        setAutomaticGeolocationHasFailed,
-        setUserHasSetManualGeolocation,
-        userHasSetManualGeolocation
-    } = useContext(StoreLocatorContext)
-
-    const getGeolocationError = () => {
-        setAutomaticGeolocationHasFailed(true)
-    }
-    const getGeolocationSuccess = (position) => {
-        setAutomaticGeolocationHasFailed(false)
-        setSearchStoresParams({
-            latitude: position.coords.latitude,
-            longitude: position.coords.longitude,
-            limit: STORE_LOCATOR_NUM_STORES_PER_LOAD
-        })
-    }
-
-    const getUserGeolocation = () => {
-        if (navigator?.geolocation) {
-            navigator.geolocation.getCurrentPosition(getGeolocationSuccess, getGeolocationError)
-            setUserHasSetManualGeolocation(false)
-        } else {
-            console.log('Geolocation not supported')
-        }
-    }
-
-    useEffect(() => {
-        if (!userHasSetManualGeolocation) getUserGeolocation()
-    }, [])
-
-    return getUserGeolocation
-}
-
-const StoreLocatorInput = ({form, submitForm}) => {
-    const {
-        searchStoresParams,
-        userHasSetManualGeolocation,
-        automaticGeolocationHasFailed,
-        setUserWantsToShareLocation,
-        userWantsToShareLocation
-    } = useContext(StoreLocatorContext)
-
-    const getUserGeolocation = useGeolocation()
-    const {control} = form
-    const intl = useIntl()
-    return (
-        <form id="store-locator-form" onSubmit={form.handleSubmit(submitForm)}>
-            <InputGroup>
-                {SUPPORTED_STORE_LOCATOR_COUNTRIES.length > 0 && (
-                    <Controller
-                        name="countryCode"
-                        control={control}
-                        defaultValue={
-                            userHasSetManualGeolocation ? searchStoresParams?.countryCode : ''
-                        }
-                        rules={{
-                            required: intl.formatMessage({
-                                id: 'store_locator.error.please_select_a_country',
-                                defaultMessage: 'Please select a country.'
-                            })
-                        }}
-                        render={({field}) => {
-                            return SUPPORTED_STORE_LOCATOR_COUNTRIES.length !== 0 ? (
-                                <FormControl isInvalid={form.formState.errors.countryCode}>
-                                    <Select
-                                        {...field}
-                                        marginBottom="10px"
-                                        placeholder={intl.formatMessage({
-                                            id: 'store_locator.action.select_a_country',
-                                            defaultMessage: 'Select a country'
-                                        })}
-                                        borderColor="gray.500"
-                                    >
-                                        {SUPPORTED_STORE_LOCATOR_COUNTRIES.map(
-                                            ({countryCode, countryName}) => {
-                                                return (
-                                                    <option value={countryCode} key={countryCode}>
-                                                        {intl.formatMessage(countryName)}
-                                                    </option>
-                                                )
-                                            }
-                                        )}
-                                    </Select>
-                                    {form.formState.errors.countryCode && (
-                                        <FormErrorMessage
-                                            sx={{marginBottom: '10px'}}
-                                            color="red.600"
-                                        >
-                                            <AlertIcon aria-hidden="true" mr={2} />
-                                            {form.formState.errors.countryCode.message}
-                                        </FormErrorMessage>
-                                    )}
-                                </FormControl>
-                            ) : (
-                                <></>
-                            )
-                        }}
-                    ></Controller>
-                )}
-            </InputGroup>
-            <InputGroup>
-                <Controller
-                    name="postalCode"
-                    control={control}
-                    rules={{
-                        required: intl.formatMessage({
-                            id: 'store_locator.error.please_enter_a_postal_code',
-                            defaultMessage: 'Please enter a postal code.'
-                        })
-                    }}
-                    defaultValue={userHasSetManualGeolocation ? searchStoresParams?.postalCode : ''}
-                    render={({field}) => {
-                        return (
-                            <FormControl isInvalid={form.formState.errors.postalCode}>
-                                <Input
-                                    {...field}
-                                    placeholder={intl.formatMessage({
-                                        id: 'store_locator.field.placeholder.enter_postal_code',
-                                        defaultMessage: 'Enter postal code'
-                                    })}
-                                />
-                                {form.formState.errors.postalCode && (
-                                    <FormErrorMessage sx={{top: '-20px'}} color="red.600">
-                                        <AlertIcon aria-hidden="true" mr={2} />
-                                        {form.formState.errors.postalCode.message}
-                                    </FormErrorMessage>
-                                )}
-                            </FormControl>
-                        )
-                    }}
-                ></Controller>
-                <Button
-                    key="find-button"
-                    type="submit"
-                    onClick={() => {
-                        setUserWantsToShareLocation(false)
-                    }}
-                    width="15%"
-                    marginLeft={2}
-                    variant="solid"
-                >
-                    {intl.formatMessage({
-                        id: 'store_locator.action.find',
-                        defaultMessage: 'Find'
-                    })}
-                </Button>
-            </InputGroup>
-            <Box
-                style={{display: 'flex', justifyContent: 'center', alignItems: 'center'}}
-                margin="10px"
-            >
-                {intl.formatMessage({
-                    id: 'store_locator.description.or',
-                    defaultMessage: 'Or'
-                })}
-            </Box>
-            <Button
-                key="use-my-location-button"
-                onClick={() => {
-                    setUserWantsToShareLocation(true)
-                    getUserGeolocation()
-                }}
-                width="100%"
-                variant="solid"
-                fontWeight="bold"
-                marginBottom={4}
-            >
-                {intl.formatMessage({
-                    id: 'store_locator.action.use_my_location',
-                    defaultMessage: 'Use My Location'
-                })}
-            </Button>
-            <FormControl isInvalid={automaticGeolocationHasFailed && userWantsToShareLocation}>
-                <FormErrorMessage
-                    color="red.600"
-                    alignItems="center"
-                    justifyContent="center"
-                    marginBottom={4}
-                >
-                    <AlertIcon aria-hidden="true" mr={2} />
-                    {intl.formatMessage({
-                        id: 'store_locator.error.agree_to_share_your_location',
-                        defaultMessage: 'Please agree to share your location'
-                    })}
-                </FormErrorMessage>
-            </FormControl>
-        </form>
-    )
-}
-
-StoreLocatorInput.propTypes = {
-    form: PropTypes.object,
-    submitForm: PropTypes.func
-}
-
-export default StoreLocatorInput
diff --git a/packages/template-retail-react-app/app/components/store-locator-modal/store-locator-input.test.jsx b/packages/template-retail-react-app/app/components/store-locator-modal/store-locator-input.test.jsx
deleted file mode 100644
index 03d1c6880b..0000000000
--- a/packages/template-retail-react-app/app/components/store-locator-modal/store-locator-input.test.jsx
+++ /dev/null
@@ -1,75 +0,0 @@
-/*
- * Copyright (c) 2021, salesforce.com, inc.
- * All rights reserved.
- * SPDX-License-Identifier: BSD-3-Clause
- * For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/BSD-3-Clause
- */
-
-import React, {useEffect} from 'react'
-import StoreLocatorInput from '@salesforce/retail-react-app/app/components/store-locator-modal/store-locator-input'
-import {renderWithProviders} from '@salesforce/retail-react-app/app/utils/test-utils'
-import {waitFor, screen} from '@testing-library/react'
-import {useForm} from 'react-hook-form'
-import PropTypes from 'prop-types'
-import {StoreLocatorContext} from '@salesforce/retail-react-app/app/components/store-locator-modal/index'
-import {useStoreLocator} from '@salesforce/retail-react-app/app/components/store-locator-modal/index'
-import {STORE_LOCATOR_NUM_STORES_PER_LOAD} from '@salesforce/retail-react-app/app/constants'
-
-const WrapperComponent = ({userHasSetManualGeolocation}) => {
-    const form = useForm({
-        mode: 'onChange',
-        reValidateMode: 'onChange',
-        defaultValues: {
-            countryCode: 'DE',
-            postalCode: '10178'
-        }
-    })
-    const storeLocator = useStoreLocator()
-    useEffect(() => {
-        storeLocator.setUserHasSetManualGeolocation(userHasSetManualGeolocation)
-        storeLocator.setSearchStoresParams({
-            postalCode: '10178',
-            countryCode: 'DE',
-            limit: STORE_LOCATOR_NUM_STORES_PER_LOAD
-        })
-    }, [])
-
-    return (
-        <StoreLocatorContext.Provider value={storeLocator}>
-            <StoreLocatorInput form={form} submitForm={jest.fn()} />
-        </StoreLocatorContext.Provider>
-    )
-}
-WrapperComponent.propTypes = {
-    storesInfo: PropTypes.array,
-    userHasSetManualGeolocation: PropTypes.bool,
-    getUserGeolocation: PropTypes.func
-}
-
-describe('StoreLocatorInput', () => {
-    afterEach(() => {
-        jest.clearAllMocks()
-        jest.resetModules()
-    })
-    test('Renders without crashing', () => {
-        expect(() => {
-            renderWithProviders(
-                <WrapperComponent userHasSetManualGeolocation={true}></WrapperComponent>
-            )
-        }).not.toThrow()
-    })
-
-    test('Expected information exists', async () => {
-        renderWithProviders(
-            <WrapperComponent userHasSetManualGeolocation={true}></WrapperComponent>
-        )
-
-        await waitFor(async () => {
-            const findButton = screen.getByRole('button', {name: /Find/i})
-            const useMyLocationButton = screen.getByRole('button', {name: /Use My Location/i})
-
-            expect(findButton).toBeInTheDocument()
-            expect(useMyLocationButton).toBeInTheDocument()
-        })
-    })
-})
diff --git a/packages/template-retail-react-app/app/components/store-locator-modal/stores-list.jsx b/packages/template-retail-react-app/app/components/store-locator-modal/stores-list.jsx
deleted file mode 100644
index a3fbd0a289..0000000000
--- a/packages/template-retail-react-app/app/components/store-locator-modal/stores-list.jsx
+++ /dev/null
@@ -1,131 +0,0 @@
-/*
- * Copyright (c) 2021, salesforce.com, inc.
- * All rights reserved.
- * SPDX-License-Identifier: BSD-3-Clause
- * For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/BSD-3-Clause
- */
-
-import React, {useEffect, useState} from 'react'
-import {useIntl} from 'react-intl'
-import PropTypes from 'prop-types'
-
-// Components
-import {
-    AccordionItem,
-    AccordionButton,
-    AccordionIcon,
-    AccordionPanel,
-    Box,
-    HStack,
-    Radio,
-    RadioGroup
-} from '@salesforce/retail-react-app/app/components/shared/ui'
-
-// Hooks
-import useMultiSite from '@salesforce/retail-react-app/app/hooks/use-multi-site'
-
-const StoresList = ({storesInfo}) => {
-    const intl = useIntl()
-    const {site} = useMultiSite()
-    const storeInfoKey = `store_${site.id}`
-    const [selectedStore, setSelectedStore] = useState('')
-
-    useEffect(() => {
-        setSelectedStore(JSON.parse(window.localStorage.getItem(storeInfoKey))?.id || '')
-    }, [storeInfoKey])
-
-    const handleChange = (storeId) => {
-        setSelectedStore(storeId)
-        const store = storesInfo.find((store) => store.id === storeId)
-        window.localStorage.setItem(
-            storeInfoKey,
-            JSON.stringify({
-                id: storeId,
-                name: store.name || null,
-                inventoryId: store.inventoryId || null
-            })
-        )
-    }
-
-    return (
-        <RadioGroup onChange={handleChange} value={selectedStore}>
-            {storesInfo?.map((store, index) => {
-                return (
-                    <AccordionItem key={index}>
-                        <HStack align="flex-start" mt="16px" mb="16px">
-                            <Radio
-                                value={store.id}
-                                mt="1px"
-                                aria-describedby={`store-info-${store.id}`}
-                            ></Radio>
-                            <Box id={`store-info-${store.id}`}>
-                                {store.name && <Box fontSize="lg">{store.name}</Box>}
-                                <Box fontSize="md" color="gray.600">
-                                    {store.address1}
-                                </Box>
-                                <Box fontSize="md" color="gray.600">
-                                    {store.city}, {store.stateCode ? store.stateCode : ''}{' '}
-                                    {store.postalCode}
-                                </Box>
-                                {store.distance !== undefined && (
-                                    <>
-                                        <br />
-                                        <Box fontSize="md" color="gray.600">
-                                            {store.distance} {store.distanceUnit}{' '}
-                                            {intl.formatMessage({
-                                                id: 'store_locator.description.away',
-                                                defaultMessage: 'away'
-                                            })}
-                                        </Box>
-                                    </>
-                                )}
-                                {store.phone && (
-                                    <>
-                                        <br />
-                                        <Box fontSize="md" color="gray.600">
-                                            {intl.formatMessage({
-                                                id: 'store_locator.description.phone',
-                                                defaultMessage: 'Phone:'
-                                            })}{' '}
-                                            {store.phone}
-                                        </Box>
-                                    </>
-                                )}
-                                {store.storeHours && (
-                                    <>
-                                        {' '}
-                                        <AccordionButton
-                                            color="blue.700"
-                                            sx={{marginTop: '10px', paddingBottom: '0px'}}
-                                        >
-                                            <Box fontSize="lg">
-                                                {intl.formatMessage({
-                                                    id: 'store_locator.action.viewMore',
-                                                    defaultMessage: 'View More'
-                                                })}
-                                            </Box>
-                                            <AccordionIcon />
-                                        </AccordionButton>
-                                        <AccordionPanel mb={6} mt={4}>
-                                            <div
-                                                dangerouslySetInnerHTML={{
-                                                    __html: store?.storeHours
-                                                }}
-                                            />
-                                        </AccordionPanel>{' '}
-                                    </>
-                                )}
-                            </Box>
-                        </HStack>
-                    </AccordionItem>
-                )
-            })}
-        </RadioGroup>
-    )
-}
-
-StoresList.propTypes = {
-    storesInfo: PropTypes.array
-}
-
-export default StoresList
diff --git a/packages/template-retail-react-app/app/components/store-locator-modal/stores-list.test.jsx b/packages/template-retail-react-app/app/components/store-locator-modal/stores-list.test.jsx
deleted file mode 100644
index a326ef38c0..0000000000
--- a/packages/template-retail-react-app/app/components/store-locator-modal/stores-list.test.jsx
+++ /dev/null
@@ -1,199 +0,0 @@
-/*
- * Copyright (c) 2021, salesforce.com, inc.
- * All rights reserved.
- * SPDX-License-Identifier: BSD-3-Clause
- * For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/BSD-3-Clause
- */
-
-import React from 'react'
-import StoresList from '@salesforce/retail-react-app/app/components/store-locator-modal/stores-list'
-import {renderWithProviders} from '@salesforce/retail-react-app/app/utils/test-utils'
-import {waitFor, screen, fireEvent} from '@testing-library/react'
-import userEvent from '@testing-library/user-event'
-import {Accordion} from '@salesforce/retail-react-app/app/components/shared/ui'
-import mockConfig from '@salesforce/retail-react-app/config/mocks/default'
-
-const mockSearchStoresData = [
-    {
-        address1: 'Kirchgasse 12',
-        city: 'Wiesbaden',
-        countryCode: 'DE',
-        distance: 0.74,
-        distanceUnit: 'km',
-        id: '00019',
-        inventoryId: 'inventory_m_store_store11',
-        latitude: 50.0826,
-        longitude: 8.24,
-        name: 'Wiesbaden Tech Depot',
-        phone: '+49 611 876543',
-        posEnabled: false,
-        postalCode: '65185',
-        storeHours: 'Monday 9 AM to 7 PM',
-        storeLocatorEnabled: true
-    },
-    {
-        address1: 'Schaumainkai 63',
-        city: 'Frankfurt am Main',
-        countryCode: 'DE',
-        distance: 30.78,
-        distanceUnit: 'km',
-        id: '00002',
-        inventoryId: 'inventory_m_store_store4',
-        latitude: 50.097416,
-        longitude: 8.669059,
-        name: 'Frankfurt Electronics Store',
-        phone: '+49 69 111111111',
-        posEnabled: false,
-        postalCode: '60596',
-        storeHours:
-            'Monday 10 AM–6 PM\nTuesday 10 AM–6 PM\nWednesday 10 AM–6 PM\nThursday 10 AM–9 PM\nFriday 10 AM–6 PM\nSaturday 10 AM–6 PM\nSunday 10 AM–6 PM',
-        storeLocatorEnabled: true
-    },
-    {
-        address1: 'Löhrstraße 87',
-        city: 'Koblenz',
-        countryCode: 'DE',
-        distance: 55.25,
-        distanceUnit: 'km',
-        id: '00035',
-        inventoryId: 'inventory_m_store_store27',
-        latitude: 50.3533,
-        longitude: 7.5946,
-        name: 'Koblenz Electronics Store',
-        phone: '+49 261 123456',
-        posEnabled: false,
-        postalCode: '56068',
-        storeHours:
-            'Monday 9 AM–7 PM\nTuesday 9 AM–7 PM\nWednesday 9 AM–7 PM\nThursday 9 AM–8 PM\nFriday 9 AM–7 PM\nSaturday 9 AM–6 PM\nSunday Closed',
-        storeLocatorEnabled: true
-    },
-    {
-        address1: 'Hauptstraße 47',
-        city: 'Heidelberg',
-        countryCode: 'DE',
-        distance: 81.1,
-        distanceUnit: 'km',
-        id: '00021',
-        latitude: 49.4077,
-        longitude: 8.6908,
-        name: 'Store with no inventoryId',
-        phone: '+49 6221 123456',
-        posEnabled: false,
-        postalCode: '69117',
-        storeHours:
-            'Monday 10 AM–7 PM\nTuesday 10 AM–7 PM\nWednesday 10 AM–7 PM\nThursday 10 AM–8 PM\nFriday 10 AM–7 PM\nSaturday 10 AM–6 PM\nSunday Closed',
-        storeLocatorEnabled: true
-    }
-]
-
-describe('StoresList', () => {
-    test('renders without crashing', () => {
-        expect(() => {
-            renderWithProviders(
-                <Accordion>
-                    <StoresList storesInfo={mockSearchStoresData} />
-                </Accordion>
-            )
-        }).not.toThrow()
-    })
-
-    test('Expected information exists', async () => {
-        renderWithProviders(
-            <Accordion>
-                <StoresList storesInfo={mockSearchStoresData} />
-            </Accordion>
-        )
-
-        expect(screen.queryAllByRole('radio')).toHaveLength(mockSearchStoresData.length)
-
-        await waitFor(async () => {
-            mockSearchStoresData.forEach((store) => {
-                const storeName = screen.getByText(store.name)
-                const storeAddress = screen.getByText(store.address1)
-                const storeCityAndPostalCode = screen.getByText(
-                    `${store.city}, ${store.postalCode}`
-                )
-                const storeDistance = screen.getByText(
-                    `${store.distance} ${store.distanceUnit} away`
-                )
-                const storePhoneNumber = screen.getByText(`Phone: ${store.phone}`)
-
-                expect(storeName).toBeInTheDocument()
-                expect(storeAddress).toBeInTheDocument()
-                expect(storeCityAndPostalCode).toBeInTheDocument()
-                expect(storeDistance).toBeInTheDocument()
-                expect(storePhoneNumber).toBeInTheDocument()
-            })
-        })
-    })
-
-    test('Clicking View More opens store hours', async () => {
-        renderWithProviders(
-            <Accordion>
-                <StoresList storesInfo={mockSearchStoresData} />
-            </Accordion>
-        )
-
-        await waitFor(async () => {
-            const viewMoreButtons = screen.getAllByRole('button', {name: /View More/i})
-
-            // Click on the first button
-            await userEvent.click(viewMoreButtons[0])
-
-            const aStoreOpenHours = screen.getByText(/Monday\s*9\s*AM\s*to\s*7\s*PM/i)
-            expect(aStoreOpenHours).toBeInTheDocument()
-        })
-    })
-
-    test('Is sorted by distance away', async () => {
-        renderWithProviders(
-            <Accordion>
-                <StoresList storesInfo={mockSearchStoresData} />
-            </Accordion>
-        )
-        await waitFor(async () => {
-            const numbers = [
-                screen.getByText(/\s*0\.74\s*km\s*away\s*/),
-                screen.getByText(/\s*30\.78\s*km\s*away\s*/),
-                screen.getByText(/\s*55\.25\s*km\s*away\s*/),
-                screen.getByText(/\s*81\.1\s*km\s*away\s*/)
-            ]
-
-            // Check that the numbers are in the document
-            numbers.forEach((number) => {
-                expect(number).toBeInTheDocument()
-            })
-
-            // Check that the numbers are in the correct order
-            const numberTexts = numbers.map((number) => number.textContent)
-            expect(numberTexts).toEqual([
-                '0.74 km away',
-                '30.78 km away',
-                '55.25 km away',
-                '81.1 km away'
-            ])
-            // Check that the numbers are in the correct visual order
-            const positions = numbers.map((number) => number.getBoundingClientRect().top)
-            expect(positions).toEqual([...positions].sort((a, b) => a - b))
-        })
-    })
-
-    test('Can select store', async () => {
-        renderWithProviders(
-            <Accordion>
-                <StoresList storesInfo={mockSearchStoresData} />
-            </Accordion>
-        )
-
-        await waitFor(async () => {
-            const {id, name, inventoryId} = mockSearchStoresData[1]
-            const radioButton = screen.getByDisplayValue(id)
-            fireEvent.click(radioButton)
-
-            const expectedStoreInfo = {id, name, inventoryId}
-            expect(localStorage.getItem(`store_${mockConfig.app.defaultSite}`)).toEqual(
-                JSON.stringify(expectedStoreInfo)
-            )
-        })
-    })
-})
diff --git a/packages/template-retail-react-app/app/components/store-locator/diagram.png b/packages/template-retail-react-app/app/components/store-locator/diagram.png
new file mode 100644
index 0000000000000000000000000000000000000000..5cc09de3305498d31d9de370223fac604913f0e3
GIT binary patch
literal 471079
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%0AyF?nW#Eq+($N&
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

literal 0
HcmV?d00001

diff --git a/packages/template-retail-react-app/app/components/store-locator/form.jsx b/packages/template-retail-react-app/app/components/store-locator/form.jsx
new file mode 100644
index 0000000000..c4c602fafb
--- /dev/null
+++ b/packages/template-retail-react-app/app/components/store-locator/form.jsx
@@ -0,0 +1,157 @@
+/*
+ * Copyright (c) 2024, salesforce.com, inc.
+ * All rights reserved.
+ * SPDX-License-Identifier: BSD-3-Clause
+ * For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/BSD-3-Clause
+ */
+
+import React, {useEffect} from 'react'
+import {
+    Box,
+    Button,
+    InputGroup,
+    Select,
+    FormControl,
+    FormErrorMessage,
+    Input
+} from '@chakra-ui/react'
+import {useForm, Controller} from 'react-hook-form'
+import {useStoreLocator} from '@salesforce/retail-react-app/app/hooks/use-store-locator'
+import {useGeolocation} from '@salesforce/retail-react-app/app/hooks/use-geo-location'
+
+export const StoreLocatorForm = () => {
+    const {config, formValues, setFormValues, setDeviceCoordinates} = useStoreLocator()
+    const {coordinates, error, refresh} = useGeolocation()
+    const form = useForm({
+        mode: 'onChange',
+        reValidateMode: 'onChange',
+        defaultValues: {
+            countryCode: formValues.countryCode,
+            postalCode: formValues.postalCode
+        }
+    })
+    const {control} = form
+    useEffect(() => {
+        if (coordinates.latitude && coordinates.longitude) {
+            setDeviceCoordinates(coordinates)
+        }
+    }, [coordinates])
+
+    const showCountrySelector = config.supportedCountries.length > 0
+
+    const submitForm = (formValues) => {
+        setFormValues(formValues)
+    }
+
+    const clearForm = () => {
+        form.reset()
+        setFormValues({
+            countryCode: '',
+            postalCode: ''
+        })
+    }
+
+    return (
+        <form
+            id="store-locator-form"
+            onSubmit={(e) => {
+                e.preventDefault()
+                void form.handleSubmit(submitForm)(e)
+            }}
+        >
+            <InputGroup>
+                {showCountrySelector && (
+                    <Controller
+                        name="countryCode"
+                        control={control}
+                        rules={{
+                            required: 'Please select a country.'
+                        }}
+                        render={({field}) => {
+                            return (
+                                <FormControl isInvalid={!!form.formState.errors.countryCode}>
+                                    <Select
+                                        {...field}
+                                        marginBottom="10px"
+                                        placeholder={'Select a country'}
+                                        borderColor="gray.500"
+                                    >
+                                        {config.supportedCountries.map(
+                                            ({countryCode, countryName}) => {
+                                                return (
+                                                    <option value={countryCode} key={countryCode}>
+                                                        {countryName}
+                                                    </option>
+                                                )
+                                            }
+                                        )}
+                                    </Select>
+                                    {form.formState.errors.countryCode && (
+                                        <FormErrorMessage
+                                            sx={{marginBottom: '10px'}}
+                                            color="red.600"
+                                        >
+                                            {form.formState.errors.countryCode.message}
+                                        </FormErrorMessage>
+                                    )}
+                                </FormControl>
+                            )
+                        }}
+                    />
+                )}
+            </InputGroup>
+            <InputGroup>
+                <Controller
+                    name="postalCode"
+                    control={control}
+                    rules={{
+                        required: 'Please enter a postal code.'
+                    }}
+                    render={({field}) => {
+                        return (
+                            <FormControl isInvalid={!!form.formState.errors.postalCode}>
+                                <Input {...field} placeholder={'Enter postal code'} />
+                                {form.formState.errors.postalCode && (
+                                    <FormErrorMessage sx={{top: '-20px'}} color="red.600">
+                                        {form.formState.errors.postalCode.message}
+                                    </FormErrorMessage>
+                                )}
+                            </FormControl>
+                        )
+                    }}
+                />
+                <Button key="find-button" type="submit" width="15%" marginLeft={2} variant="solid">
+                    Find
+                </Button>
+            </InputGroup>
+            <Box
+                style={{display: 'flex', justifyContent: 'center', alignItems: 'center'}}
+                margin="10px"
+            >
+                Or
+            </Box>
+            <Button
+                onClick={() => {
+                    clearForm()
+                    refresh()
+                }}
+                width="100%"
+                variant="solid"
+                fontWeight="bold"
+                marginBottom={4}
+            >
+                Use My Location
+            </Button>
+            <FormControl isInvalid={!!error}>
+                <FormErrorMessage
+                    color="red.600"
+                    alignItems="center"
+                    justifyContent="center"
+                    marginBottom={4}
+                >
+                    Please agree to share your location
+                </FormErrorMessage>
+            </FormControl>
+        </form>
+    )
+}
diff --git a/packages/template-retail-react-app/app/components/store-locator/form.test.jsx b/packages/template-retail-react-app/app/components/store-locator/form.test.jsx
new file mode 100644
index 0000000000..9382508945
--- /dev/null
+++ b/packages/template-retail-react-app/app/components/store-locator/form.test.jsx
@@ -0,0 +1,150 @@
+/*
+ * Copyright (c) 2024, salesforce.com, inc.
+ * All rights reserved.
+ * SPDX-License-Identifier: BSD-3-Clause
+ * For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/BSD-3-Clause
+ */
+
+import React from 'react'
+import {render, screen} from '@testing-library/react'
+import userEvent from '@testing-library/user-event'
+import {StoreLocatorForm} from '@salesforce/retail-react-app/app/components/store-locator/form'
+import {useStoreLocator} from '@salesforce/retail-react-app/app/hooks/use-store-locator'
+import {useGeolocation} from '@salesforce/retail-react-app/app/hooks/use-geo-location'
+
+jest.mock('@salesforce/retail-react-app/app/hooks/use-store-locator', () => ({
+    useStoreLocator: jest.fn()
+}))
+
+jest.mock('@salesforce/retail-react-app/app/hooks/use-geo-location', () => ({
+    useGeolocation: jest.fn()
+}))
+
+describe('StoreLocatorForm', () => {
+    const mockConfig = {
+        supportedCountries: [
+            {countryCode: 'US', countryName: 'United States'},
+            {countryCode: 'CA', countryName: 'Canada'}
+        ]
+    }
+
+    const mockSetFormValues = jest.fn()
+    const mockSetDeviceCoordinates = jest.fn()
+    let user
+
+    beforeEach(() => {
+        jest.clearAllMocks()
+        user = userEvent.setup()
+
+        useStoreLocator.mockImplementation(() => ({
+            config: mockConfig,
+            formValues: {countryCode: '', postalCode: ''},
+            setFormValues: mockSetFormValues,
+            setDeviceCoordinates: mockSetDeviceCoordinates
+        }))
+
+        useGeolocation.mockImplementation(() => ({
+            coordinates: {latitude: null, longitude: null},
+            error: null,
+            refresh: jest.fn()
+        }))
+    })
+
+    it('renders postal code input field', () => {
+        render(<StoreLocatorForm />)
+        const postalCodeInput = screen.queryByPlaceholderText('Enter postal code')
+        expect(postalCodeInput).not.toBeNull()
+    })
+
+    it('renders country selector when supportedCountries exist', () => {
+        render(<StoreLocatorForm />)
+        const countrySelect = screen.queryByText('Select a country')
+        expect(countrySelect).not.toBeNull()
+    })
+
+    it('renders "Use My Location" button', () => {
+        render(<StoreLocatorForm />)
+        const locationButton = screen.queryByText('Use My Location')
+        expect(locationButton).not.toBeNull()
+    })
+
+    it('submits form with entered values', async () => {
+        render(<StoreLocatorForm />)
+
+        const countrySelect = screen.getByRole('combobox')
+        const postalCodeInput = screen.getByPlaceholderText('Enter postal code')
+
+        await user.selectOptions(countrySelect, 'US')
+        await user.type(postalCodeInput, '12345')
+
+        const findButton = screen.getByText('Find')
+        await user.click(findButton)
+
+        expect(mockSetFormValues).toHaveBeenCalledWith({
+            countryCode: 'US',
+            postalCode: '12345'
+        })
+    })
+
+    it('shows validation error for empty postal code', async () => {
+        render(<StoreLocatorForm />)
+
+        const findButton = screen.getByText('Find')
+        await user.click(findButton)
+
+        const errorMessage = screen.queryByText('Please enter a postal code.')
+        expect(errorMessage).not.toBeNull()
+    })
+
+    it('clears form when "Use My Location" is clicked', async () => {
+        const mockRefresh = jest.fn()
+        useGeolocation.mockImplementation(() => ({
+            coordinates: {latitude: null, longitude: null},
+            error: null,
+            refresh: mockRefresh
+        }))
+
+        render(<StoreLocatorForm />)
+
+        const countrySelect = screen.getByRole('combobox')
+        const postalCodeInput = screen.getByPlaceholderText('Enter postal code')
+
+        await user.selectOptions(countrySelect, 'US')
+        await user.type(postalCodeInput, '12345')
+
+        const locationButton = screen.getByText('Use My Location')
+        await user.click(locationButton)
+
+        expect(mockSetFormValues).toHaveBeenCalledWith({
+            countryCode: '',
+            postalCode: ''
+        })
+        expect(mockRefresh).toHaveBeenCalled()
+    })
+
+    it('updates device coordinates when geolocation is successful', () => {
+        const mockCoordinates = {latitude: 37.7749, longitude: -122.4194}
+        useGeolocation.mockImplementation(() => ({
+            coordinates: mockCoordinates,
+            error: null,
+            refresh: jest.fn()
+        }))
+
+        render(<StoreLocatorForm />)
+
+        expect(mockSetDeviceCoordinates).toHaveBeenCalledWith(mockCoordinates)
+    })
+
+    it('shows geolocation error message when permission is denied', () => {
+        useGeolocation.mockImplementation(() => ({
+            coordinates: {latitude: null, longitude: null},
+            error: new Error('Geolocation permission denied'),
+            refresh: jest.fn()
+        }))
+
+        render(<StoreLocatorForm />)
+
+        const errorMessage = screen.queryByText('Please agree to share your location')
+        expect(errorMessage).not.toBeNull()
+    })
+})
diff --git a/packages/template-retail-react-app/app/components/store-locator/heading.jsx b/packages/template-retail-react-app/app/components/store-locator/heading.jsx
new file mode 100644
index 0000000000..19e5184a1a
--- /dev/null
+++ b/packages/template-retail-react-app/app/components/store-locator/heading.jsx
@@ -0,0 +1,19 @@
+/*
+ * Copyright (c) 2024, salesforce.com, inc.
+ * All rights reserved.
+ * SPDX-License-Identifier: BSD-3-Clause
+ * For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/BSD-3-Clause
+ */
+
+import React from 'react'
+import {Heading} from '@chakra-ui/react'
+
+export const StoreLocatorHeading = () => {
+    return (
+        <>
+            <Heading fontSize="2xl" marginBottom={6}>
+                Find a Store
+            </Heading>
+        </>
+    )
+}
diff --git a/packages/template-retail-react-app/app/components/store-locator/heading.test.jsx b/packages/template-retail-react-app/app/components/store-locator/heading.test.jsx
new file mode 100644
index 0000000000..15e769bda3
--- /dev/null
+++ b/packages/template-retail-react-app/app/components/store-locator/heading.test.jsx
@@ -0,0 +1,19 @@
+/*
+ * Copyright (c) 2024, salesforce.com, inc.
+ * All rights reserved.
+ * SPDX-License-Identifier: BSD-3-Clause
+ * For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/BSD-3-Clause
+ */
+
+import React from 'react'
+import {render, screen} from '@testing-library/react'
+import {StoreLocatorHeading} from '@salesforce/retail-react-app/app/components/store-locator/heading'
+
+describe('StoreLocatorHeading', () => {
+    test('renders heading with correct text', () => {
+        render(<StoreLocatorHeading />)
+
+        const heading = screen.getByText('Find a Store')
+        expect(heading).toBeTruthy()
+    })
+})
diff --git a/packages/template-retail-react-app/app/components/store-locator/index.js b/packages/template-retail-react-app/app/components/store-locator/index.js
new file mode 100644
index 0000000000..9ff04d62ff
--- /dev/null
+++ b/packages/template-retail-react-app/app/components/store-locator/index.js
@@ -0,0 +1,9 @@
+/*
+ * Copyright (c) 2024, salesforce.com, inc.
+ * All rights reserved.
+ * SPDX-License-Identifier: BSD-3-Clause
+ * For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/BSD-3-Clause
+ */
+
+export {StoreLocator} from './main'
+export {StoreLocatorModal} from './modal'
diff --git a/packages/template-retail-react-app/app/components/store-locator/list-item.jsx b/packages/template-retail-react-app/app/components/store-locator/list-item.jsx
new file mode 100644
index 0000000000..489650447e
--- /dev/null
+++ b/packages/template-retail-react-app/app/components/store-locator/list-item.jsx
@@ -0,0 +1,73 @@
+/*
+ * Copyright (c) 2024, salesforce.com, inc.
+ * All rights reserved.
+ * SPDX-License-Identifier: BSD-3-Clause
+ * For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/BSD-3-Clause
+ */
+
+import React from 'react'
+import PropTypes from 'prop-types'
+import {AccordionItem, AccordionButton, AccordionIcon, AccordionPanel, Box} from '@chakra-ui/react'
+
+export const StoreLocatorListItem = ({store}) => {
+    return (
+        <AccordionItem>
+            <Box margin="10px">
+                {store.name && <Box fontSize="lg">{store.name}</Box>}
+                <Box fontSize="md" color="gray.600">
+                    {store.address1}
+                </Box>
+                <Box fontSize="md" color="gray.600">
+                    {store.city}, {store.stateCode ? store.stateCode : ''} {store.postalCode}
+                </Box>
+                {store.distance !== undefined && (
+                    <>
+                        <br />
+                        <Box fontSize="md" color="gray.600">
+                            {store.distance} {store.distanceUnit}
+                            {' away'}
+                        </Box>
+                    </>
+                )}
+                {store.phone && (
+                    <>
+                        <br />
+                        <Box fontSize="md" color="gray.600">
+                            {'Phone: '}
+                            {store.phone}
+                        </Box>
+                    </>
+                )}
+                {store.storeHours && (
+                    <>
+                        <AccordionButton color="blue.700" style={{marginTop: '10px'}}>
+                            <Box fontSize="lg">View More</Box>
+                            <AccordionIcon />
+                        </AccordionButton>
+                        <AccordionPanel mb={6} mt={4}>
+                            <div
+                                dangerouslySetInnerHTML={{
+                                    __html: store.storeHours
+                                }}
+                            />
+                        </AccordionPanel>
+                    </>
+                )}
+            </Box>
+        </AccordionItem>
+    )
+}
+
+StoreLocatorListItem.propTypes = {
+    store: PropTypes.shape({
+        name: PropTypes.string,
+        address1: PropTypes.string.isRequired,
+        city: PropTypes.string.isRequired,
+        stateCode: PropTypes.string,
+        postalCode: PropTypes.string.isRequired,
+        distance: PropTypes.number,
+        distanceUnit: PropTypes.string,
+        phone: PropTypes.string,
+        storeHours: PropTypes.string
+    }).isRequired
+}
diff --git a/packages/template-retail-react-app/app/components/store-locator/list-item.test.jsx b/packages/template-retail-react-app/app/components/store-locator/list-item.test.jsx
new file mode 100644
index 0000000000..95c2a71744
--- /dev/null
+++ b/packages/template-retail-react-app/app/components/store-locator/list-item.test.jsx
@@ -0,0 +1,58 @@
+/*
+ * Copyright (c) 2024, Salesforce, Inc.
+ * All rights reserved.
+ * SPDX-License-Identifier: BSD-3-Clause
+ * For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/BSD-3-Clause
+ */
+import React from 'react'
+import {screen} from '@testing-library/react'
+import {Accordion} from '@chakra-ui/react'
+import {renderWithProviders} from '@salesforce/retail-react-app/app/utils/test-utils'
+import {StoreLocatorListItem} from '@salesforce/retail-react-app/app/components/store-locator/list-item'
+
+describe('StoreLocatorListItem', () => {
+    const mockStore = {
+        name: 'Test Store',
+        address1: '123 Test St',
+        city: 'San Francisco',
+        stateCode: 'CA',
+        postalCode: '94105',
+        phone: '555-1234',
+        distance: 0.5,
+        distanceUnit: 'mi',
+        storeHours: '<p>Mon-Fri: 9AM-9PM</p>'
+    }
+
+    const renderWithAccordion = (component) => {
+        return renderWithProviders(<Accordion>{component}</Accordion>)
+    }
+
+    it('renders store information correctly', () => {
+        renderWithAccordion(<StoreLocatorListItem store={mockStore} />)
+
+        expect(screen.getByText('Test Store')).toBeTruthy()
+        expect(screen.getByText('123 Test St')).toBeTruthy()
+        expect(screen.getByText(/San Francisco, CA 94105/)).toBeTruthy()
+        expect(screen.getByText('0.5 mi away')).toBeTruthy()
+        expect(screen.getByText('Phone: 555-1234')).toBeTruthy()
+        expect(screen.getByText('View More')).toBeTruthy()
+    })
+
+    it('handles missing optional fields', () => {
+        const storeWithMissingFields = {
+            name: 'Basic Store',
+            address1: '789 Basic St',
+            city: 'Simple City',
+            postalCode: '12345'
+        }
+
+        renderWithAccordion(<StoreLocatorListItem store={storeWithMissingFields} />)
+
+        expect(screen.getByText('Basic Store')).toBeTruthy()
+        expect(screen.getByText('789 Basic St')).toBeTruthy()
+        expect(screen.getByText(/Simple City/)).toBeTruthy()
+        expect(screen.queryByText(/away/)).toBeNull()
+        expect(screen.queryByText(/Phone:/)).toBeNull()
+        expect(screen.queryByText('View More')).toBeNull()
+    })
+})
diff --git a/packages/template-retail-react-app/app/components/store-locator/list.jsx b/packages/template-retail-react-app/app/components/store-locator/list.jsx
new file mode 100644
index 0000000000..432f3a665f
--- /dev/null
+++ b/packages/template-retail-react-app/app/components/store-locator/list.jsx
@@ -0,0 +1,83 @@
+/*
+ * Copyright (c) 2024, salesforce.com, inc.
+ * All rights reserved.
+ * SPDX-License-Identifier: BSD-3-Clause
+ * For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/BSD-3-Clause
+ */
+
+import React, {useEffect, useState} from 'react'
+import {Accordion, AccordionItem, Box, Button} from '@chakra-ui/react'
+import {StoreLocatorListItem} from '@salesforce/retail-react-app/app/components/store-locator/list-item'
+import {useStoreLocator} from '@salesforce/retail-react-app/app/hooks/use-store-locator'
+
+export const StoreLocatorList = () => {
+    const {data, isLoading, config, formValues, mode} = useStoreLocator()
+    const [page, setPage] = useState(1)
+    useEffect(() => {
+        setPage(1)
+    }, [data])
+
+    const displayStoreLocatorStatusMessage = () => {
+        if (isLoading) return 'Loading locations...'
+        if (data?.total === 0) return 'Sorry, there are no locations in this area'
+
+        if (mode === 'input') {
+            const countryName =
+                config.supportedCountries.length !== 0
+                    ? config.supportedCountries.find(
+                          (o) => o.countryCode === formValues.countryCode
+                      )?.countryName || config.defaultCountry
+                    : config.defaultCountry
+
+            return `Viewing stores within ${String(config.radius)}${String(
+                config.radiusUnit
+            )} of ${String(data?.data[0].postalCode)} in ${String(countryName)}`
+        }
+
+        return 'Viewing stores near your location'
+    }
+
+    const showNumberOfStores = page * config.defaultPageSize
+    const showLoadMoreButton = data?.total > showNumberOfStores
+    const storesToShow = data?.data?.slice(0, showNumberOfStores) || []
+
+    return (
+        <>
+            <Accordion allowMultiple flex={[1, 1, 1, 5]}>
+                <AccordionItem>
+                    <Box
+                        flex="1"
+                        fontWeight="semibold"
+                        fontSize="md"
+                        style={{
+                            display: 'flex',
+                            justifyContent: 'center',
+                            alignItems: 'center',
+                            margin: '20px'
+                        }}
+                    >
+                        {displayStoreLocatorStatusMessage()}
+                    </Box>
+                </AccordionItem>
+                {storesToShow?.map((store, index) => (
+                    <StoreLocatorListItem key={index} store={store} />
+                ))}
+            </Accordion>
+            {showLoadMoreButton && (
+                <Box paddingTop={3} marginTop={3}>
+                    <Button
+                        id="load-more-button"
+                        onClick={() => {
+                            setPage(page + 1)
+                        }}
+                        width="100%"
+                        variant="outline"
+                        marginBottom={4}
+                    >
+                        Load More
+                    </Button>
+                </Box>
+            )}
+        </>
+    )
+}
diff --git a/packages/template-retail-react-app/app/components/store-locator/list.test.jsx b/packages/template-retail-react-app/app/components/store-locator/list.test.jsx
new file mode 100644
index 0000000000..b4fb00ea0f
--- /dev/null
+++ b/packages/template-retail-react-app/app/components/store-locator/list.test.jsx
@@ -0,0 +1,141 @@
+/*
+ * Copyright (c) 2024, salesforce.com, inc.
+ * All rights reserved.
+ * SPDX-License-Identifier: BSD-3-Clause
+ * For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/BSD-3-Clause
+ */
+import React from 'react'
+import {render, screen, fireEvent} from '@testing-library/react'
+import {StoreLocatorList} from '@salesforce/retail-react-app/app/components/store-locator/list'
+import {useStoreLocator} from '@salesforce/retail-react-app/app/hooks/use-store-locator'
+
+// Mock the useStoreLocator hook
+jest.mock('@salesforce/retail-react-app/app/hooks/use-store-locator')
+
+// Mock store data
+const mockStores = {
+    total: 3,
+    data: [
+        {
+            name: 'Store 1',
+            address1: '123 Main St',
+            city: 'Boston',
+            stateCode: 'MA',
+            postalCode: '02108',
+            phone: '555-0123'
+        },
+        {
+            name: 'Store 2',
+            address1: '456 Oak St',
+            city: 'Boston',
+            stateCode: 'MA',
+            postalCode: '02109',
+            phone: '555-0124'
+        },
+        {
+            name: 'Store 3',
+            address1: '789 Pine St',
+            city: 'Boston',
+            stateCode: 'MA',
+            postalCode: '02110',
+            phone: '555-0125'
+        }
+    ]
+}
+
+const defaultConfig = {
+    radius: 10,
+    radiusUnit: 'mi',
+    defaultPageSize: 2,
+    defaultCountry: 'United States',
+    supportedCountries: [{countryCode: 'US', countryName: 'United States'}]
+}
+
+describe('StoreLocatorList', () => {
+    beforeEach(() => {
+        jest.clearAllMocks()
+    })
+
+    test('renders loading state', () => {
+        useStoreLocator.mockReturnValue({
+            isLoading: true,
+            data: null,
+            config: defaultConfig,
+            formValues: {},
+            mode: 'input'
+        })
+
+        render(<StoreLocatorList />)
+        expect(screen.getByText('Loading locations...')).toBeTruthy()
+    })
+
+    test('renders no locations message', () => {
+        useStoreLocator.mockReturnValue({
+            isLoading: false,
+            data: {total: 0, data: []},
+            config: defaultConfig,
+            formValues: {},
+            mode: 'input'
+        })
+
+        render(<StoreLocatorList />)
+        expect(screen.getByText('Sorry, there are no locations in this area')).toBeTruthy()
+    })
+
+    test('renders stores with pagination', () => {
+        useStoreLocator.mockReturnValue({
+            isLoading: false,
+            data: mockStores,
+            config: defaultConfig,
+            formValues: {countryCode: 'US'},
+            mode: 'input'
+        })
+
+        render(<StoreLocatorList />)
+
+        // Initially shows only first 2 stores (defaultPageSize)
+        expect(screen.getByText('Store 1')).toBeTruthy()
+        expect(screen.getByText('Store 2')).toBeTruthy()
+        expect(screen.queryByText('Store 3')).toBeNull()
+
+        // Load more button should be visible
+        const loadMoreButton = screen.getByText('Load More')
+        expect(loadMoreButton).toBeTruthy()
+
+        // Click load more
+        fireEvent.click(loadMoreButton)
+
+        // Should now show all 3 stores
+        expect(screen.getByText('Store 1')).toBeTruthy()
+        expect(screen.getByText('Store 2')).toBeTruthy()
+        expect(screen.getByText('Store 3')).toBeTruthy()
+    })
+
+    test('renders correct status message for input mode', () => {
+        useStoreLocator.mockReturnValue({
+            isLoading: false,
+            data: mockStores,
+            config: defaultConfig,
+            formValues: {countryCode: 'US'},
+            mode: 'input'
+        })
+
+        render(<StoreLocatorList />)
+        expect(
+            screen.getByText(/Viewing stores within 10mi of 02108 in United States/)
+        ).toBeTruthy()
+    })
+
+    test('renders correct status message for geolocation mode', () => {
+        useStoreLocator.mockReturnValue({
+            isLoading: false,
+            data: mockStores,
+            config: defaultConfig,
+            formValues: {},
+            mode: 'geolocation'
+        })
+
+        render(<StoreLocatorList />)
+        expect(screen.getByText('Viewing stores near your location')).toBeTruthy()
+    })
+})
diff --git a/packages/template-retail-react-app/app/components/store-locator/main.jsx b/packages/template-retail-react-app/app/components/store-locator/main.jsx
new file mode 100644
index 0000000000..71750db949
--- /dev/null
+++ b/packages/template-retail-react-app/app/components/store-locator/main.jsx
@@ -0,0 +1,21 @@
+/*
+ * Copyright (c) 2024, salesforce.com, inc.
+ * All rights reserved.
+ * SPDX-License-Identifier: BSD-3-Clause
+ * For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/BSD-3-Clause
+ */
+
+import React from 'react'
+import {StoreLocatorList} from '@salesforce/retail-react-app/app/components/store-locator/list'
+import {StoreLocatorForm} from '@salesforce/retail-react-app/app/components/store-locator/form'
+import {StoreLocatorHeading} from '@salesforce/retail-react-app/app/components/store-locator/heading'
+
+export const StoreLocator = () => {
+    return (
+        <>
+            <StoreLocatorHeading />
+            <StoreLocatorForm />
+            <StoreLocatorList />
+        </>
+    )
+}
diff --git a/packages/template-retail-react-app/app/components/store-locator/main.test.jsx b/packages/template-retail-react-app/app/components/store-locator/main.test.jsx
new file mode 100644
index 0000000000..00d2e011ca
--- /dev/null
+++ b/packages/template-retail-react-app/app/components/store-locator/main.test.jsx
@@ -0,0 +1,33 @@
+/*
+ * Copyright (c) 2024, salesforce.com, inc.
+ * All rights reserved.
+ * SPDX-License-Identifier: BSD-3-Clause
+ * For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/BSD-3-Clause
+ */
+
+import React from 'react'
+import {render, screen} from '@testing-library/react'
+import {StoreLocator} from '@salesforce/retail-react-app/app/components/store-locator/main'
+
+jest.mock('./list', () => ({
+    StoreLocatorList: () => <div data-testid="store-locator-list">Store List Mock</div>
+}))
+
+jest.mock('./form', () => ({
+    StoreLocatorForm: () => <div data-testid="store-locator-form">Store Form Mock</div>
+}))
+
+jest.mock('./heading', () => ({
+    StoreLocatorHeading: () => <div data-testid="store-locator-heading">Store Heading Mock</div>
+}))
+
+describe('StoreLocatorContent', () => {
+    it('renders all child components', () => {
+        render(<StoreLocator />)
+
+        // Verify that all child components are rendered
+        expect(screen.queryByTestId('store-locator-heading')).not.toBeNull()
+        expect(screen.queryByTestId('store-locator-form')).not.toBeNull()
+        expect(screen.queryByTestId('store-locator-list')).not.toBeNull()
+    })
+})
diff --git a/packages/template-retail-react-app/app/components/store-locator/modal.jsx b/packages/template-retail-react-app/app/components/store-locator/modal.jsx
new file mode 100644
index 0000000000..eeb90b5d86
--- /dev/null
+++ b/packages/template-retail-react-app/app/components/store-locator/modal.jsx
@@ -0,0 +1,56 @@
+/*
+ * Copyright (c) 2024, salesforce.com, inc.
+ * All rights reserved.
+ * SPDX-License-Identifier: BSD-3-Clause
+ * For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/BSD-3-Clause
+ */
+
+import React from 'react'
+import PropTypes from 'prop-types'
+import {
+    Modal,
+    ModalBody,
+    ModalCloseButton,
+    ModalContent,
+    useBreakpointValue
+} from '@chakra-ui/react'
+import {StoreLocator} from '@salesforce/retail-react-app/app/components/store-locator/main'
+
+export const StoreLocatorModal = ({isOpen, onClose}) => {
+    const isDesktopView = useBreakpointValue({base: false, lg: true})
+
+    return isDesktopView ? (
+        <Modal size="4xl" isOpen={isOpen} onClose={onClose}>
+            <ModalContent
+                position="absolute"
+                top="0"
+                right="0"
+                width="33.33%"
+                height="100vh"
+                marginTop="0px"
+                overflowY="auto"
+                borderLeft="1px solid"
+                borderColor="gray.200"
+            >
+                <ModalCloseButton onClick={onClose} />
+                <ModalBody pb={8} bg="white" paddingBottom={6} paddingTop={6}>
+                    <StoreLocator />
+                </ModalBody>
+            </ModalContent>
+        </Modal>
+    ) : (
+        <Modal size="4xl" isOpen={isOpen} onClose={onClose}>
+            <ModalContent position="absolute" top="0" right="0" height="100vh" marginTop="0px">
+                <ModalCloseButton onClick={onClose} />
+                <ModalBody pb={8} bg="white" paddingBottom={6} marginTop={6}>
+                    <StoreLocator />
+                </ModalBody>
+            </ModalContent>
+        </Modal>
+    )
+}
+
+StoreLocatorModal.propTypes = {
+    isOpen: PropTypes.bool.isRequired,
+    onClose: PropTypes.func.isRequired
+}
diff --git a/packages/template-retail-react-app/app/components/store-locator/modal.test.jsx b/packages/template-retail-react-app/app/components/store-locator/modal.test.jsx
new file mode 100644
index 0000000000..ea33e91dc2
--- /dev/null
+++ b/packages/template-retail-react-app/app/components/store-locator/modal.test.jsx
@@ -0,0 +1,67 @@
+/*
+ * Copyright (c) 2024, Salesforce, Inc.
+ * All rights reserved.
+ * SPDX-License-Identifier: BSD-3-Clause
+ * For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/BSD-3-Clause
+ */
+import React from 'react'
+import {screen} from '@testing-library/react'
+import {renderWithProviders} from '@salesforce/retail-react-app/app/utils/test-utils'
+import {StoreLocatorModal} from '@salesforce/retail-react-app/app/components/store-locator/modal'
+
+const mockUseBreakpointValue = jest.fn()
+jest.mock('@chakra-ui/react', () => {
+    const originalModule = jest.requireActual('@chakra-ui/react')
+    return {
+        ...originalModule,
+        useBreakpointValue: () => mockUseBreakpointValue
+    }
+})
+
+jest.mock('./main', () => ({
+    StoreLocator: () => <div data-testid="store-locator-content">Store Locator Content</div>
+}))
+
+describe('StoreLocatorModal', () => {
+    const mockProps = {
+        isOpen: true,
+        onClose: jest.fn()
+    }
+
+    beforeEach(() => {
+        jest.clearAllMocks()
+        mockUseBreakpointValue.mockReturnValue(true) // Default to desktop view
+    })
+
+    it('renders desktop view correctly', () => {
+        mockUseBreakpointValue.mockReturnValue(true) // Desktop view
+        renderWithProviders(<StoreLocatorModal {...mockProps} />)
+
+        expect(screen.getByText('Store Locator Content')).toBeTruthy()
+        expect(screen.getByTestId('store-locator-content')).toBeTruthy()
+    })
+
+    it('renders mobile view correctly', () => {
+        mockUseBreakpointValue.mockReturnValue(false) // Mobile view
+        renderWithProviders(<StoreLocatorModal {...mockProps} />)
+
+        expect(screen.getByText('Store Locator Content')).toBeTruthy()
+        expect(screen.getByTestId('store-locator-content')).toBeTruthy()
+    })
+
+    it('does not render when closed', () => {
+        renderWithProviders(<StoreLocatorModal isOpen={false} onClose={jest.fn()} />)
+
+        expect(screen.queryByText('Store Locator Content')).toBeNull()
+        expect(screen.queryByTestId('store-locator-content')).toBeNull()
+    })
+
+    it('calls onClose when close button is clicked', () => {
+        const onClose = jest.fn()
+        renderWithProviders(<StoreLocatorModal isOpen={true} onClose={onClose} />)
+
+        const closeButton = screen.getByLabelText('Close')
+        closeButton.click()
+        expect(onClose).toHaveBeenCalled()
+    })
+})
diff --git a/packages/template-retail-react-app/app/constants.js b/packages/template-retail-react-app/app/constants.js
index ad8602e346..7db2216f5f 100644
--- a/packages/template-retail-react-app/app/constants.js
+++ b/packages/template-retail-react-app/app/constants.js
@@ -185,35 +185,24 @@ export const REMOVE_UNAVAILABLE_CART_ITEM_DIALOG_CONFIG = {
     onPrimaryAction: noop
 }
 
-export const SUPPORTED_STORE_LOCATOR_COUNTRIES = [
+export const STORE_LOCATOR_IS_ENABLED = true
+export const STORE_LOCATOR_SUPPORTED_COUNTRIES = [
     {
         countryCode: 'US',
-        countryName: defineMessage({
-            defaultMessage: 'United States',
-            id: 'store_locator.dropdown.united_states'
-        })
+        countryName: 'United States'
     },
     {
         countryCode: 'DE',
-        countryName: defineMessage({
-            defaultMessage: 'Germany',
-            id: 'store_locator.dropdown.germany'
-        })
+        countryName: 'Germany'
     }
 ]
-
-export const DEFAULT_STORE_LOCATOR_COUNTRY = {
-    countryCode: 'DE',
-    countryName: defineMessage({
-        defaultMessage: 'Germany',
-        id: 'store_locator.dropdown.germany'
-    })
-}
-export const DEFAULT_STORE_LOCATOR_POSTAL_CODE = '10178'
-export const STORE_LOCATOR_DISTANCE = 100
-export const STORE_LOCATOR_NUM_STORES_PER_LOAD = 10
-export const STORE_LOCATOR_DISTANCE_UNIT = 'km'
-export const STORE_LOCATOR_IS_ENABLED = true
+export const STORE_LOCATOR_DEFAULT_POSTAL_CODE = '10178'
+export const STORE_LOCATOR_RADIUS = 100
+export const STORE_LOCATOR_RADIUS_UNIT = 'km'
+export const STORE_LOCATOR_DEFAULT_COUNTRY = 'DE'
+export const STORE_LOCATOR_DEFAULT_COUNTRY_CODE = 'DE'
+export const STORE_LOCATOR_DEFAULT_PAGE_SIZE = 10
+export const STORE_LOCATOR_NUM_STORES_PER_REQUEST_API_MAX = 200 // This is an API limit and is therefore not configurable
 
 export const DEFAULT_DNT_STATE = true
 // Constants for shopper context
diff --git a/packages/template-retail-react-app/app/contexts/index.js b/packages/template-retail-react-app/app/contexts/index.js
index 622a78b5e8..d542c27cfb 100644
--- a/packages/template-retail-react-app/app/contexts/index.js
+++ b/packages/template-retail-react-app/app/contexts/index.js
@@ -7,6 +7,10 @@
 
 import React, {useState} from 'react'
 import PropTypes from 'prop-types'
+export {
+    StoreLocatorContext,
+    StoreLocatorProvider
+} from '@salesforce/retail-react-app/app/contexts/store-locator-provider'
 
 /**
  * This is the global state for the multiples sites and locales supported in the App.
diff --git a/packages/template-retail-react-app/app/contexts/store-locator-provider.jsx b/packages/template-retail-react-app/app/contexts/store-locator-provider.jsx
new file mode 100644
index 0000000000..51a8a88331
--- /dev/null
+++ b/packages/template-retail-react-app/app/contexts/store-locator-provider.jsx
@@ -0,0 +1,41 @@
+/*
+ * Copyright (c) 2024, salesforce.com, inc.
+ * All rights reserved.
+ * SPDX-License-Identifier: BSD-3-Clause
+ * For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/BSD-3-Clause
+ */
+
+import React, {useState, createContext} from 'react'
+import PropTypes from 'prop-types'
+
+export const StoreLocatorContext = createContext(null)
+
+export const StoreLocatorProvider = ({config, children}) => {
+    const [state, setState] = useState({
+        mode: 'input',
+        formValues: {
+            countryCode: config.defaultCountryCode,
+            postalCode: config.defaultPostalCode
+        },
+        deviceCoordinates: {
+            latitude: null,
+            longitude: null
+        },
+        config
+    })
+
+    const value = {
+        state,
+        setState
+    }
+
+    return <StoreLocatorContext.Provider value={value}>{children}</StoreLocatorContext.Provider>
+}
+
+StoreLocatorProvider.propTypes = {
+    config: PropTypes.shape({
+        defaultCountryCode: PropTypes.string.isRequired,
+        defaultPostalCode: PropTypes.string.isRequired
+    }).isRequired,
+    children: PropTypes.node
+}
diff --git a/packages/template-retail-react-app/app/contexts/store-locator-provider.test.jsx b/packages/template-retail-react-app/app/contexts/store-locator-provider.test.jsx
new file mode 100644
index 0000000000..43c0eca3af
--- /dev/null
+++ b/packages/template-retail-react-app/app/contexts/store-locator-provider.test.jsx
@@ -0,0 +1,91 @@
+/*
+ * Copyright (c) 2024, Salesforce, Inc.
+ * All rights reserved.
+ * SPDX-License-Identifier: BSD-3-Clause
+ * For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/BSD-3-Clause
+ */
+import React from 'react'
+import {render, act} from '@testing-library/react'
+import {
+    StoreLocatorProvider,
+    StoreLocatorContext
+} from '@salesforce/retail-react-app/app/contexts/store-locator-provider'
+
+describe('StoreLocatorProvider', () => {
+    const mockConfig = {
+        defaultCountryCode: 'US',
+        defaultPostalCode: '10178'
+    }
+
+    it('provides the expected context value', () => {
+        let contextValue
+        const TestComponent = () => {
+            contextValue = React.useContext(StoreLocatorContext)
+            return null
+        }
+
+        render(
+            <StoreLocatorProvider config={mockConfig}>
+                <TestComponent />
+            </StoreLocatorProvider>
+        )
+
+        expect(contextValue).toBeTruthy()
+        expect(contextValue?.state).toEqual({
+            mode: 'input',
+            formValues: {
+                countryCode: mockConfig.defaultCountryCode,
+                postalCode: mockConfig.defaultPostalCode
+            },
+            deviceCoordinates: {
+                latitude: null,
+                longitude: null
+            },
+            config: mockConfig
+        })
+        expect(typeof contextValue?.setState).toBe('function')
+    })
+
+    it('updates state correctly when setState is called', () => {
+        let contextValue
+        const TestComponent = () => {
+            contextValue = React.useContext(StoreLocatorContext)
+            return null
+        }
+
+        render(
+            <StoreLocatorProvider config={mockConfig}>
+                <TestComponent />
+            </StoreLocatorProvider>
+        )
+
+        act(() => {
+            contextValue?.setState((prev) => ({
+                ...prev,
+                mode: 'device',
+                formValues: {
+                    countryCode: 'US',
+                    postalCode: '94105'
+                }
+            }))
+        })
+
+        expect(contextValue?.state.mode).toBe('device')
+        expect(contextValue?.state.formValues).toEqual({
+            countryCode: 'US',
+            postalCode: '94105'
+        })
+    })
+
+    it('renders children correctly', () => {
+        const TestChild = () => <div data-testid="test-child">Test Child</div>
+
+        const {getByText} = render(
+            <StoreLocatorProvider config={mockConfig}>
+                <TestChild />
+            </StoreLocatorProvider>
+        )
+
+        expect(getByText('Test Child')).toBeTruthy()
+    })
+})
diff --git a/packages/template-retail-react-app/app/hooks/use-geo-location.js b/packages/template-retail-react-app/app/hooks/use-geo-location.js
new file mode 100644
index 0000000000..5e6bab8e16
--- /dev/null
+++ b/packages/template-retail-react-app/app/hooks/use-geo-location.js
@@ -0,0 +1,56 @@
+/*
+ * Copyright (c) 2024, salesforce.com, inc.
+ * All rights reserved.
+ * SPDX-License-Identifier: BSD-3-Clause
+ * For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/BSD-3-Clause
+ */
+
+import {useEffect, useState} from 'react'
+
+export function useGeolocation(options = {}) {
+    const [loading, setLoading] = useState(true)
+    const [error, setError] = useState(null)
+    const [coordinates, setCoordinates] = useState({
+        latitude: null,
+        longitude: null
+    })
+
+    const getLocation = () => {
+        setLoading(true)
+        setError(null)
+
+        try {
+            if (!navigator.geolocation) {
+                throw new Error('Geolocation is not supported by this browser.')
+            }
+            navigator.geolocation.getCurrentPosition(
+                (position) => {
+                    setCoordinates({
+                        latitude: position.coords.latitude,
+                        longitude: position.coords.longitude
+                    })
+                    setLoading(false)
+                },
+                (err) => {
+                    setError(err)
+                    setLoading(false)
+                },
+                options
+            )
+        } catch (err) {
+            setError(err)
+            setLoading(false)
+        }
+    }
+
+    useEffect(() => {
+        getLocation()
+    }, [])
+
+    return {
+        coordinates,
+        loading,
+        error,
+        refresh: getLocation
+    }
+}
diff --git a/packages/template-retail-react-app/app/hooks/use-geo-location.test.js b/packages/template-retail-react-app/app/hooks/use-geo-location.test.js
new file mode 100644
index 0000000000..8f122940a4
--- /dev/null
+++ b/packages/template-retail-react-app/app/hooks/use-geo-location.test.js
@@ -0,0 +1,162 @@
+/*
+ * Copyright (c) 2024, Salesforce, Inc.
+ * All rights reserved.
+ * SPDX-License-Identifier: BSD-3-Clause
+ * For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/BSD-3-Clause
+ */
+import {renderHook, act} from '@testing-library/react'
+import {useGeolocation} from '@salesforce/retail-react-app/app/hooks/use-geo-location'
+
+describe('useGeolocation', () => {
+    const mockGeolocation = {
+        getCurrentPosition: jest.fn()
+    }
+
+    beforeEach(() => {
+        // Mock GeolocationPositionError if it's not defined
+        if (!global.GeolocationPositionError) {
+            global.GeolocationPositionError = function () {
+                this.code = 1
+                this.message = ''
+                this.PERMISSION_DENIED = 1
+                this.POSITION_UNAVAILABLE = 2
+                this.TIMEOUT = 3
+            }
+        }
+
+        // Setup mock for navigator.geolocation
+        Object.defineProperty(global.navigator, 'geolocation', {
+            value: mockGeolocation,
+            writable: true
+        })
+    })
+
+    afterEach(() => {
+        jest.clearAllMocks()
+    })
+
+    it('initializes with default values', () => {
+        const {result} = renderHook(() => useGeolocation())
+
+        expect(result.current).toEqual({
+            coordinates: {latitude: null, longitude: null},
+            loading: true,
+            error: null,
+            refresh: expect.any(Function)
+        })
+    })
+
+    it('updates coordinates on successful geolocation', async () => {
+        const mockPosition = {
+            coords: {
+                latitude: 37.7749,
+                longitude: -122.4194,
+                accuracy: 0,
+                altitude: null,
+                altitudeAccuracy: null,
+                heading: null,
+                speed: null
+            },
+            timestamp: Date.now()
+        }
+
+        mockGeolocation.getCurrentPosition.mockImplementation((success) => {
+            success(mockPosition)
+        })
+
+        const {result} = renderHook(() => useGeolocation())
+
+        await act(async () => {
+            await new Promise((resolve) => setTimeout(resolve, 0))
+        })
+
+        expect(result.current).toEqual({
+            coordinates: {
+                latitude: 37.7749,
+                longitude: -122.4194
+            },
+            loading: false,
+            error: null,
+            refresh: expect.any(Function)
+        })
+    })
+
+    it('handles geolocation errors', async () => {
+        const mockError = new global.GeolocationPositionError()
+        mockError.code = 1
+        mockError.message = 'User denied geolocation'
+
+        mockGeolocation.getCurrentPosition.mockImplementation((_success, error) => {
+            error(mockError)
+        })
+
+        const {result} = renderHook(() => useGeolocation())
+
+        await act(async () => {
+            await new Promise((resolve) => setTimeout(resolve, 0))
+        })
+
+        expect(result.current).toEqual({
+            coordinates: {latitude: null, longitude: null},
+            loading: false,
+            error: mockError,
+            refresh: expect.any(Function)
+        })
+    })
+
+    it('handles refresh function call', async () => {
+        const mockPosition = {
+            coords: {
+                latitude: 37.7749,
+                longitude: -122.4194,
+                accuracy: 0,
+                altitude: null,
+                altitudeAccuracy: null,
+                heading: null,
+                speed: null
+            },
+            timestamp: Date.now()
+        }
+
+        mockGeolocation.getCurrentPosition.mockImplementation((success) => {
+            success(mockPosition)
+        })
+
+        const {result} = renderHook(() => useGeolocation())
+
+        act(() => {
+            result.current.refresh()
+        })
+
+        await act(async () => {
+            await new Promise((resolve) => setTimeout(resolve, 0))
+        })
+
+        expect(mockGeolocation.getCurrentPosition).toHaveBeenCalledTimes(2)
+        expect(result.current.coordinates).toEqual({
+            latitude: 37.7749,
+            longitude: -122.4194
+        })
+    })
+
+    it('handles case when geolocation is not supported', async () => {
+        // First clear the mock
+        Object.defineProperty(global.navigator, 'geolocation', {
+            value: undefined,
+            writable: true
+        })
+
+        const {result} = renderHook(() => useGeolocation())
+
+        await act(async () => {
+            await new Promise((resolve) => setTimeout(resolve, 0))
+        })
+
+        // Just check that we're in an error state with null coordinates
+        expect(result.current.loading).toBe(false)
+        expect(result.current.coordinates).toEqual({
+            latitude: null,
+            longitude: null
+        })
+    })
+})
diff --git a/packages/template-retail-react-app/app/hooks/use-store-locator.js b/packages/template-retail-react-app/app/hooks/use-store-locator.js
new file mode 100644
index 0000000000..4c05057eec
--- /dev/null
+++ b/packages/template-retail-react-app/app/hooks/use-store-locator.js
@@ -0,0 +1,85 @@
+/*
+ * Copyright (c) 2024, salesforce.com, inc.
+ * All rights reserved.
+ * SPDX-License-Identifier: BSD-3-Clause
+ * For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/BSD-3-Clause
+ */
+
+import {useContext} from 'react'
+import {useSearchStores} from '@salesforce/commerce-sdk-react'
+import {StoreLocatorContext} from '@salesforce/retail-react-app/app/contexts/store-locator-provider'
+
+const useStores = (state) => {
+    //This is an API limit and is therefore not configurable
+    const NUM_STORES_PER_REQUEST_API_MAX = 200
+    const apiParameters =
+        state.mode === 'input'
+            ? {
+                  countryCode: state.formValues.countryCode,
+                  postalCode: state.formValues.postalCode,
+                  maxDistance: state.config.radius,
+                  limit: NUM_STORES_PER_REQUEST_API_MAX,
+                  distanceUnit: state.config.radiusUnit
+              }
+            : {
+                  latitude: state.deviceCoordinates.latitude,
+                  longitude: state.deviceCoordinates.longitude,
+                  maxDistance: state.config.radius,
+                  limit: NUM_STORES_PER_REQUEST_API_MAX,
+                  distanceUnit: state.config.radiusUnit
+              }
+    const shouldFetchStores =
+        Boolean(
+            state.mode === 'input' && state.formValues.countryCode && state.formValues.postalCode
+        ) ||
+        Boolean(
+            state.mode === 'device' &&
+                state.deviceCoordinates.latitude &&
+                state.deviceCoordinates.longitude
+        )
+    return useSearchStores(
+        {
+            parameters: apiParameters
+        },
+        {
+            enabled: shouldFetchStores
+        }
+    )
+}
+
+export const useStoreLocator = () => {
+    const context = useContext(StoreLocatorContext)
+    if (!context) {
+        throw new Error('useStoreLocator must be used within a StoreLocatorProvider')
+    }
+
+    const {state, setState} = context
+    const {data, isLoading} = useStores(state)
+
+    // There are two modes, input and device.
+    // The input mode is when the user is searching for a store
+    // by entering a postal code and country code.
+    // The device mode is when the user is searching for a store by sharing their location.
+    // The mode is implicitly set by user's action.
+    const setFormValues = (formValues) => {
+        setState((prev) => ({...prev, formValues, mode: 'input'}))
+    }
+
+    const setDeviceCoordinates = (coordinates) => {
+        setState((prev) => ({
+            ...prev,
+            deviceCoordinates: coordinates,
+            mode: 'device',
+            formValues: {countryCode: '', postalCode: ''}
+        }))
+    }
+
+    return {
+        ...state,
+        data,
+        isLoading,
+        // Actions
+        setFormValues,
+        setDeviceCoordinates
+    }
+}
diff --git a/packages/template-retail-react-app/app/hooks/use-store-locator.test.jsx b/packages/template-retail-react-app/app/hooks/use-store-locator.test.jsx
new file mode 100644
index 0000000000..b899a49ba7
--- /dev/null
+++ b/packages/template-retail-react-app/app/hooks/use-store-locator.test.jsx
@@ -0,0 +1,190 @@
+/*
+ * Copyright (c) 2024, Salesforce, Inc.
+ * All rights reserved.
+ * SPDX-License-Identifier: BSD-3-Clause
+ * For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/BSD-3-Clause
+ */
+import React from 'react'
+import {renderHook, act} from '@testing-library/react'
+import {useStoreLocator} from '@salesforce/retail-react-app/app/hooks/use-store-locator'
+import {StoreLocatorProvider} from '@salesforce/retail-react-app/app/contexts/store-locator-provider'
+import {useSearchStores} from '@salesforce/commerce-sdk-react'
+
+// Mock the commerce-sdk-react hook
+jest.mock('@salesforce/commerce-sdk-react', () => ({
+    useSearchStores: jest.fn()
+}))
+
+const config = {
+    radius: 100,
+    radiusUnit: 'mi',
+    defaultCountryCode: 'US',
+    defaultPostalCode: '10178'
+}
+
+const wrapper = ({children}) => {
+    return <StoreLocatorProvider config={config}>{children}</StoreLocatorProvider>
+}
+
+describe('useStoreLocator', () => {
+    beforeEach(() => {
+        useSearchStores.mockReset()
+        // Default mock implementation
+        useSearchStores.mockReturnValue({
+            data: undefined,
+            isLoading: false
+        })
+    })
+
+    it('throws error when used outside provider', () => {
+        let error
+        try {
+            renderHook(() => useStoreLocator())
+        } catch (err) {
+            error = err
+        }
+
+        expect(error).toEqual(Error('useStoreLocator must be used within a StoreLocatorProvider'))
+    })
+
+    it('initializes with default values', () => {
+        const {result} = renderHook(() => useStoreLocator(), {wrapper})
+
+        expect(result.current).toMatchObject({
+            mode: 'input',
+            formValues: {
+                countryCode: config.defaultCountryCode,
+                postalCode: config.defaultPostalCode
+            },
+            deviceCoordinates: {latitude: null, longitude: null},
+            isLoading: false,
+            data: undefined
+        })
+    })
+
+    it('updates form values and switches to input mode', () => {
+        const {result} = renderHook(() => useStoreLocator(), {wrapper})
+
+        act(() => {
+            result.current.setFormValues({
+                countryCode: 'US',
+                postalCode: '94105'
+            })
+        })
+
+        expect(result.current.mode).toBe('input')
+        expect(result.current.formValues).toEqual({
+            countryCode: 'US',
+            postalCode: '94105'
+        })
+    })
+
+    it('updates device coordinates and switches to device mode', () => {
+        const {result} = renderHook(() => useStoreLocator(), {wrapper})
+
+        act(() => {
+            result.current.setDeviceCoordinates({
+                latitude: 37.7749,
+                longitude: -122.4194
+            })
+        })
+
+        expect(result.current.mode).toBe('device')
+        expect(result.current.deviceCoordinates).toEqual({
+            latitude: 37.7749,
+            longitude: -122.4194
+        })
+        // Should reset form values when switching to device mode
+        expect(result.current.formValues).toEqual({
+            countryCode: '',
+            postalCode: ''
+        })
+    })
+
+    it('calls useSearchStores with correct parameters in input mode', () => {
+        const {result} = renderHook(() => useStoreLocator(), {wrapper})
+
+        act(() => {
+            result.current.setFormValues({
+                countryCode: 'US',
+                postalCode: '94105'
+            })
+        })
+
+        expect(useSearchStores).toHaveBeenCalledWith(
+            {
+                parameters: {
+                    countryCode: 'US',
+                    postalCode: '94105',
+                    maxDistance: 100,
+                    limit: 200,
+                    distanceUnit: 'mi'
+                }
+            },
+            {
+                enabled: true
+            }
+        )
+    })
+
+    it('calls useSearchStores with correct parameters in device mode', () => {
+        const {result} = renderHook(() => useStoreLocator(), {wrapper})
+
+        act(() => {
+            result.current.setDeviceCoordinates({
+                latitude: 37.7749,
+                longitude: -122.4194
+            })
+        })
+
+        expect(useSearchStores).toHaveBeenCalledWith(
+            {
+                parameters: {
+                    latitude: 37.7749,
+                    longitude: -122.4194,
+                    maxDistance: 100,
+                    limit: 200,
+                    distanceUnit: 'mi'
+                }
+            },
+            {
+                enabled: true
+            }
+        )
+    })
+
+    it('handles loading state', () => {
+        useSearchStores.mockReturnValue({
+            data: undefined,
+            isLoading: true
+        })
+
+        const {result} = renderHook(() => useStoreLocator(), {wrapper})
+
+        expect(result.current.isLoading).toBe(true)
+    })
+
+    it('handles store data', () => {
+        const mockStoreData = [
+            {
+                id: '1',
+                name: 'Test Store',
+                address: {
+                    address1: '123 Test St',
+                    city: 'Test City',
+                    stateCode: 'CA',
+                    postalCode: '94105'
+                }
+            }
+        ]
+
+        useSearchStores.mockReturnValue({
+            data: mockStoreData,
+            isLoading: false
+        })
+
+        const {result} = renderHook(() => useStoreLocator(), {wrapper})
+
+        expect(result.current.data).toEqual(mockStoreData)
+    })
+})
diff --git a/packages/template-retail-react-app/app/pages/account/orders.test.js b/packages/template-retail-react-app/app/pages/account/orders.test.js
index de57b529a5..aefe93c80a 100644
--- a/packages/template-retail-react-app/app/pages/account/orders.test.js
+++ b/packages/template-retail-react-app/app/pages/account/orders.test.js
@@ -66,7 +66,7 @@ test('Renders order history and details', async () => {
         await screen.findAllByAltText(
             'Pleated Bib Long Sleeve Shirt, Silver Grey, small',
             {},
-            {timeout: 15000}
+            {timeout: 500}
         )
     ).toHaveLength(3)
 
@@ -93,3 +93,146 @@ test('Renders order history place holder when no orders', async () => {
 
     expect(await screen.findByTestId('account-order-history-place-holder')).toBeInTheDocument()
 })
+
+describe('Order with empty product list', () => {
+    let user
+    beforeEach(async () => {
+        const emptyProductOrder = {
+            ...mockOrderHistory.data[0],
+            productItems: []
+        }
+        const mockOrderHistoryWithEmptyProduct = {
+            ...mockOrderHistory,
+            data: [emptyProductOrder]
+        }
+        global.server.use(
+            rest.get('*/orders/:orderNo', (req, res, ctx) => {
+                return res(ctx.delay(0), ctx.json(emptyProductOrder))
+            }),
+            rest.get('*/customers/:customerId/orders', (req, res, ctx) => {
+                return res(ctx.delay(0), ctx.json(mockOrderHistoryWithEmptyProduct))
+            })
+        )
+        const renderResult = renderWithProviders(<MockedComponent history={history} />, {
+            wrapperProps: {siteAlias: 'uk', appConfig: mockConfig.app}
+        })
+        user = renderResult.user
+    })
+
+    test('should render order history page', async () => {
+        expect(await screen.findByTestId('account-order-history-page')).toBeInTheDocument()
+    })
+
+    test('should render order details page', async () => {
+        await user.click((await screen.findAllByText(/view details/i))[0])
+        expect(await screen.findByTestId('account-order-details-page')).toBeInTheDocument()
+    })
+
+    test('should show 0 items', async () => {
+        await user.click((await screen.findAllByText(/view details/i))[0])
+        expect(await screen.findByText(/0 items/i)).toBeInTheDocument()
+    })
+
+    test('should not render products', async () => {
+        await user.click((await screen.findAllByText(/view details/i))[0])
+        expect(screen.queryByAltText(/Pleated Bib Long Sleeve Shirt/i)).not.toBeInTheDocument()
+    })
+})
+
+describe('Direct navigation to order details and back to order list', () => {
+    let user, orderNo
+    beforeEach(async () => {
+        global.server.use(
+            rest.get('*/orders/:orderNo', (req, res, ctx) => {
+                return res(ctx.delay(0), ctx.json(mockOrderHistory.data[0]))
+            }),
+            rest.get('*/customers/:customerId/orders', (req, res, ctx) => {
+                return res(ctx.delay(0), ctx.json(mockOrderHistory))
+            }),
+            rest.get('*/products', (req, res, ctx) => {
+                return res(ctx.delay(0), ctx.json(mockOrderProducts))
+            })
+        )
+        orderNo = mockOrderHistory.data[0].orderNo
+        window.history.pushState(
+            {},
+            'Order Details',
+            createPathWithDefaults(`/account/orders/${orderNo}`)
+        )
+        const renderResult = renderWithProviders(<MockedComponent history={history} />, {
+            wrapperProps: {siteAlias: 'uk', appConfig: mockConfig.app}
+        })
+        user = renderResult.user
+    })
+
+    test('should render order details page on direct navigation', async () => {
+        expect(await screen.findByTestId('account-order-details-page')).toBeInTheDocument()
+        expect(window.location.pathname).toMatch(new RegExp(`/account/orders/${orderNo}$`))
+    })
+
+    test('should navigate back to order history page', async () => {
+        await user.click(await screen.findByRole('link', {name: /back to order history/i}))
+        expect(await screen.findByTestId('account-order-history-page')).toBeInTheDocument()
+        expect(window.location.pathname).toMatch(/\/account\/orders$/)
+    })
+
+    test('should show all orders', async () => {
+        await user.click(await screen.findByRole('link', {name: /back to order history/i}))
+        expect(await screen.findAllByText(/Ordered: /i)).toHaveLength(3)
+    })
+
+    test('should show all products', async () => {
+        await user.click(await screen.findByRole('link', {name: /back to order history/i}))
+        expect(
+            await screen.findAllByAltText(
+                'Pleated Bib Long Sleeve Shirt, Silver Grey, small',
+                {},
+                {timeout: 500}
+            )
+        ).toHaveLength(3)
+    })
+})
+
+describe('Handles order with missing or partial data gracefully', () => {
+    let orderNo
+    beforeEach(async () => {
+        const partialOrder = {
+            ...mockOrderHistory.data[0],
+            billingAddress: undefined,
+            shipments: undefined,
+            paymentInstruments: undefined,
+            creationDate: undefined
+        }
+        global.server.use(
+            rest.get('*/orders/:orderNo', (req, res, ctx) => {
+                return res(ctx.delay(0), ctx.json(partialOrder))
+            }),
+            rest.get('*/customers/:customerId/orders', (req, res, ctx) => {
+                return res(ctx.delay(0), ctx.json({...mockOrderHistory, data: [partialOrder]}))
+            })
+        )
+        orderNo = partialOrder.orderNo
+        window.history.pushState(
+            {},
+            'Order Details',
+            createPathWithDefaults(`/account/orders/${orderNo}`)
+        )
+        renderWithProviders(<MockedComponent history={history} />, {
+            wrapperProps: {siteAlias: 'uk', appConfig: mockConfig.app}
+        })
+    })
+
+    test('should render order details page', async () => {
+        expect(await screen.findByTestId('account-order-details-page')).toBeInTheDocument()
+    })
+
+    test('should show the Order Details header', async () => {
+        expect(screen.getByRole('heading', {name: /order details/i})).toBeInTheDocument()
+    })
+
+    test('should not render billing, payment, or shipping sections', async () => {
+        expect(screen.queryByText(/billing address/i)).not.toBeInTheDocument()
+        expect(screen.queryByText(/payment method/i)).not.toBeInTheDocument()
+        expect(screen.queryByText(/shipping address/i)).not.toBeInTheDocument()
+    })
+})
diff --git a/packages/template-retail-react-app/app/pages/store-locator/index.jsx b/packages/template-retail-react-app/app/pages/store-locator/index.jsx
index d568a5f807..16fbff6a77 100644
--- a/packages/template-retail-react-app/app/pages/store-locator/index.jsx
+++ b/packages/template-retail-react-app/app/pages/store-locator/index.jsx
@@ -1,49 +1,35 @@
 /*
- * Copyright (c) 2021, salesforce.com, inc.
+ * Copyright (c) 2024, salesforce.com, inc.
  * All rights reserved.
  * SPDX-License-Identifier: BSD-3-Clause
  * For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/BSD-3-Clause
  */
 
 import React from 'react'
+import {Box, Container} from '@chakra-ui/react'
+import {StoreLocator} from '@salesforce/retail-react-app/app/components/store-locator'
 
-// Components
-import {Box, Container} from '@salesforce/retail-react-app/app/components/shared/ui'
-import Seo from '@salesforce/retail-react-app/app/components/seo'
-import StoreLocatorContent from '@salesforce/retail-react-app/app/components/store-locator-modal/store-locator-content'
-
-// Others
-import {
-    StoreLocatorContext,
-    useStoreLocator
-} from '@salesforce/retail-react-app/app/components/store-locator-modal/index'
-
-const StoreLocator = () => {
-    const storeLocator = useStoreLocator()
-
+const StoreLocatorPage = () => {
     return (
-        <StoreLocatorContext.Provider value={storeLocator}>
-            <Box data-testid="store-locator-page" bg="gray.50" py={[8, 16]}>
-                <Seo title="Store Locator" description="Find a Store" />
-                <Container
-                    overflowY="scroll"
-                    paddingTop={8}
-                    width={['90%']}
-                    bg="white"
-                    paddingBottom={14}
-                    marginTop={8}
-                    marginBottom={8}
-                    borderRadius="base"
-                >
-                    <StoreLocatorContent />
-                </Container>
-            </Box>
-        </StoreLocatorContext.Provider>
+        <Box data-testid="store-locator-page" bg="gray.50" py={[8, 16]}>
+            <Container
+                overflowY="scroll"
+                paddingTop={8}
+                width={['90%']}
+                bg="white"
+                paddingBottom={14}
+                marginTop={8}
+                marginBottom={8}
+                borderRadius="base"
+            >
+                <StoreLocator />
+            </Container>
+        </Box>
     )
 }
 
-StoreLocator.getTemplateName = () => 'store-locator'
+StoreLocatorPage.getTemplateName = () => 'store-locator'
 
-StoreLocator.propTypes = {}
+StoreLocatorPage.propTypes = {}
 
-export default StoreLocator
+export default StoreLocatorPage
diff --git a/packages/template-retail-react-app/app/pages/store-locator/index.test.jsx b/packages/template-retail-react-app/app/pages/store-locator/index.test.jsx
index 959ad891cc..60f037b201 100644
--- a/packages/template-retail-react-app/app/pages/store-locator/index.test.jsx
+++ b/packages/template-retail-react-app/app/pages/store-locator/index.test.jsx
@@ -1,256 +1,36 @@
 /*
- * Copyright (c) 2021, salesforce.com, inc.
+ * Copyright (c) 2025, Salesforce, Inc.
+ * All rights reserved.
+ * SPDX-License-Identifier: BSD-3-Clause
+ * For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/BSD-3-Clause
+ */
+/*
+ * Copyright (c) 2024, salesforce.com, inc.
  * All rights reserved.
  * SPDX-License-Identifier: BSD-3-Clause
  * For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/BSD-3-Clause
  */
-import React from 'react'
-import {screen, waitFor, within} from '@testing-library/react'
-import {rest} from 'msw'
-import {
-    createPathWithDefaults,
-    renderWithProviders
-} from '@salesforce/retail-react-app/app/utils/test-utils'
-import StoreLocator from '.'
-import mockConfig from '@salesforce/retail-react-app/config/mocks/default'
-
-const mockStores = {
-    limit: 4,
-    data: [
-        {
-            address1: 'Kirchgasse 12',
-            city: 'Wiesbaden',
-            countryCode: 'DE',
-            distance: 0.74,
-            distanceUnit: 'km',
-            id: '00019',
-            inventoryId: 'inventory_m_store_store11',
-            latitude: 50.0826,
-            longitude: 8.24,
-            name: 'Wiesbaden Tech Depot',
-            phone: '+49 611 876543',
-            posEnabled: false,
-            postalCode: '65185',
-            storeHours:
-                'Monday 9 AM–7 PM\nTuesday 9 AM–7 PM\nWednesday 9 AM–7 PM\nThursday 9 AM–8 PM\nFriday 9 AM–7 PM\nSaturday 9 AM–6 PM\nSunday Closed',
-            storeLocatorEnabled: true
-        },
-        {
-            address1: 'Schaumainkai 63',
-            city: 'Frankfurt am Main',
-            countryCode: 'DE',
-            distance: 30.78,
-            distanceUnit: 'km',
-            id: '00002',
-            inventoryId: 'inventory_m_store_store4',
-            latitude: 50.097416,
-            longitude: 8.669059,
-            name: 'Frankfurt Electronics Store',
-            phone: '+49 69 111111111',
-            posEnabled: false,
-            postalCode: '60596',
-            storeHours:
-                'Monday 10 AM–6 PM\nTuesday 10 AM–6 PM\nWednesday 10 AM–6 PM\nThursday 10 AM–9 PM\nFriday 10 AM–6 PM\nSaturday 10 AM–6 PM\nSunday 10 AM–6 PM',
-            storeLocatorEnabled: true
-        },
-        {
-            address1: 'Löhrstraße 87',
-            city: 'Koblenz',
-            countryCode: 'DE',
-            distance: 55.25,
-            distanceUnit: 'km',
-            id: '00035',
-            inventoryId: 'inventory_m_store_store27',
-            latitude: 50.3533,
-            longitude: 7.5946,
-            name: 'Koblenz Electronics Store',
-            phone: '+49 261 123456',
-            posEnabled: false,
-            postalCode: '56068',
-            storeHours:
-                'Monday 9 AM–7 PM\nTuesday 9 AM–7 PM\nWednesday 9 AM–7 PM\nThursday 9 AM–8 PM\nFriday 9 AM–7 PM\nSaturday 9 AM–6 PM\nSunday Closed',
-            storeLocatorEnabled: true
-        },
-        {
-            address1: 'Hauptstraße 47',
-            city: 'Heidelberg',
-            countryCode: 'DE',
-            distance: 81.1,
-            distanceUnit: 'km',
-            id: '00021',
-            inventoryId: 'inventory_m_store_store13',
-            latitude: 49.4077,
-            longitude: 8.6908,
-            name: 'Heidelberg Tech Mart',
-            phone: '+49 6221 123456',
-            posEnabled: false,
-            postalCode: '69117',
-            storeHours:
-                'Monday 10 AM–7 PM\nTuesday 10 AM–7 PM\nWednesday 10 AM–7 PM\nThursday 10 AM–8 PM\nFriday 10 AM–7 PM\nSaturday 10 AM–6 PM\nSunday Closed',
-            storeLocatorEnabled: true
-        }
-    ],
-    offset: 0,
-    total: 4
-}
-
-const mockNoStores = {
-    limit: 4,
-    total: 0
-}
-
-const MockedComponent = () => {
-    return (
-        <div>
-            <StoreLocator />
-        </div>
-    )
-}
-
-// Set up and clean up
-beforeEach(() => {
-    jest.resetModules()
-    window.history.pushState({}, 'Store locator', createPathWithDefaults('/store-locator'))
-})
-afterEach(() => {
-    jest.resetModules()
-    localStorage.clear()
-    jest.clearAllMocks()
-})
-
-test('Allows customer to go to store locator page', async () => {
-    global.server.use(
-        rest.get(
-            '*/shopper-stores/v1/organizations/v1/organizations/f_ecom_zzrf_001/store-search',
-            (req, res, ctx) => {
-                return res(ctx.delay(0), ctx.status(200), ctx.json(mockStores))
-            }
-        )
-    )
-
-    // render our test component
-    const {user} = renderWithProviders(<MockedComponent />, {
-        wrapperProps: {siteAlias: 'uk', appConfig: mockConfig.app}
-    })
-
-    await user.click(await screen.findByText('Find a Store'))
-
-    await waitFor(() => {
-        expect(window.location.pathname).toBe('/uk/en-GB/store-locator')
-    })
-})
-
-test('Allows customer to go to store locator page and then select a new store', async () => {
-    global.server.use(
-        rest.get(
-            'https://www.domain.com/mobify/proxy/api/store/shopper-stores/v1/organizations/:organizationId/store-search',
-            (req, res, ctx) => {
-                return res(ctx.delay(0), ctx.status(200), ctx.json(mockStores))
-            }
-        )
-    )
-
-    const {user} = renderWithProviders(<MockedComponent />, {
-        wrapperProps: {siteAlias: 'uk', appConfig: mockConfig.app}
-    })
-
-    await user.click(await screen.findByText('Find a Store'))
-
-    const countrySelect = await screen.findByDisplayValue('Select a country')
-    await user.selectOptions(countrySelect, 'DE')
-
-    await user.type(screen.getByPlaceholderText(/Enter postal code/i), '69117')
-
-    const findButtonInForm = screen.getByRole('button', {name: 'Find'})
-    await user.click(findButtonInForm)
-
-    const storeToSelect = 'Heidelberg Tech Mart'
-    await waitFor(() => {
-        expect(screen.getByText(storeToSelect)).toBeInTheDocument()
-    })
-
-    const storeNameElement = await screen.findByText(storeToSelect)
-
-    const storeAccordionItem = storeNameElement.closest('.chakra-accordion__item')
-    if (!storeAccordionItem) {
-        throw new Error(`Could not find parent .chakra-accordion__item for store: ${storeToSelect}`)
-    }
-
-    const storeRadio = within(storeAccordionItem).getByRole('radio')
-
-    await user.click(storeRadio)
-    expect(storeRadio).toBeChecked()
-})
-
-test('Show no stores are found if there are no stores', async () => {
-    global.server.use(
-        rest.get(
-            '*/shopper-stores/v1/organizations/v1/organizations/f_ecom_zzrf_001/store-search',
-            (req, res, ctx) => {
-                return res(ctx.delay(0), ctx.status(200), ctx.json(mockNoStores))
-            }
-        )
-    )
-
-    // render our test component
-    renderWithProviders(<MockedComponent />, {
-        wrapperProps: {siteAlias: 'uk', appConfig: mockConfig.app}
-    })
-
-    await waitFor(() => {
-        const descriptionFindAStore = screen.getByText(/Find a Store/i)
-        const noLocationsInThisArea = screen.getByText(
-            /Sorry, there are no locations in this area/i
-        )
-        expect(descriptionFindAStore).toBeInTheDocument()
-        expect(noLocationsInThisArea).toBeInTheDocument()
-
-        expect(window.location.pathname).toBe('/uk/en-GB/store-locator')
-    })
-})
-
-test('Allows customer to search for stores and expand to view store details', async () => {
-    global.server.use(
-        rest.get('*/shopper-stores/v1/organizations/*/store-search', (req, res, ctx) => {
-            return res(ctx.delay(0), ctx.status(200), ctx.json(mockStores))
-        })
-    )
-    const {user} = renderWithProviders(<MockedComponent />, {
-        wrapperProps: {siteAlias: 'uk', appConfig: mockConfig.app}
-    })
-
-    await user.click(await screen.findByText('Find a Store'))
 
-    const countrySelect = await screen.findByDisplayValue('Select a country')
-    await user.selectOptions(countrySelect, 'DE')
+import React from 'react'
+import {render, screen} from '@testing-library/react'
+import StoreLocatorPage from '@salesforce/retail-react-app/app/pages/store-locator/index'
 
-    const postalCodeInput = screen.getByPlaceholderText(/Enter postal code/i)
-    await user.type(postalCodeInput, '65185')
+jest.mock('@salesforce/retail-react-app/app/components/store-locator', () => ({
+    StoreLocator: () => <div data-testid="mock-store-locator-content">Mock Content</div>
+}))
 
-    const findButton = screen.getByRole('button', {name: 'Find'})
-    await user.click(findButton)
+describe('StoreLocatorPage', () => {
+    it('renders the store locator page with content', () => {
+        render(<StoreLocatorPage />)
 
-    await waitFor(() => {
-        expect(screen.getByText('Wiesbaden Tech Depot')).toBeInTheDocument()
-        expect(screen.getByText('Frankfurt Electronics Store')).toBeInTheDocument()
-    })
+        // Verify the page wrapper is rendered
+        expect(screen.getByTestId('store-locator-page')).toBeTruthy()
 
-    await waitFor(() => {
-        expect(screen.getByText('Kirchgasse 12')).toBeInTheDocument()
-        expect(screen.getByText(/Phone:\s*\+49 611 876543/)).toBeInTheDocument()
-        expect(screen.getByText('0.74 km away')).toBeInTheDocument()
+        // Verify the mocked content is rendered
+        expect(screen.getByTestId('mock-store-locator-content')).toBeTruthy()
     })
 
-    const wiesbadenStoreElement = await screen.findByText('Wiesbaden Tech Depot')
-    const wiesbadenAccordionItem = wiesbadenStoreElement.closest('.chakra-accordion__item')
-
-    expect(wiesbadenAccordionItem).toBeTruthy()
-
-    const viewMoreButton = within(wiesbadenAccordionItem).getByText('View More')
-    await user.click(viewMoreButton)
-
-    await waitFor(() => {
-        expect(within(wiesbadenAccordionItem).getByText(/Monday 9 AM–7 PM/)).toBeInTheDocument()
-        expect(within(wiesbadenAccordionItem).getByText(/Sunday Closed/)).toBeInTheDocument()
+    it('returns correct template name', () => {
+        expect(StoreLocatorPage.getTemplateName()).toBe('store-locator')
     })
 })
diff --git a/packages/template-retail-react-app/app/static/translations/compiled/de-DE.json b/packages/template-retail-react-app/app/static/translations/compiled/de-DE.json
index 0142e85b09..33e82038aa 100644
--- a/packages/template-retail-react-app/app/static/translations/compiled/de-DE.json
+++ b/packages/template-retail-react-app/app/static/translations/compiled/de-DE.json
@@ -437,6 +437,16 @@
       "value": "Artikel aus dem Warenkorb entfernt"
     }
   ],
+  "cart.product_edit_modal.modal_label": [
+    {
+      "type": 0,
+      "value": "Modales Bearbeitungsfenster für "
+    },
+    {
+      "type": 1,
+      "value": "productName"
+    }
+  ],
   "cart.recommended_products.title.may_also_like": [
     {
       "type": 0,
@@ -539,6 +549,12 @@
       "value": ")"
     }
   ],
+  "category_links.button_text": [
+    {
+      "type": 0,
+      "value": "Kategorien"
+    }
+  ],
   "cc_radio_group.action.remove": [
     {
       "type": 0,
@@ -653,6 +669,24 @@
       "value": "Versand"
     }
   ],
+  "checkout_confirmation.label.shipping.strikethrough.price": [
+    {
+      "type": 0,
+      "value": "Ursprünglich "
+    },
+    {
+      "type": 1,
+      "value": "originalPrice"
+    },
+    {
+      "type": 0,
+      "value": ", jetzt "
+    },
+    {
+      "type": 1,
+      "value": "newPrice"
+    }
+  ],
   "checkout_confirmation.label.subtotal": [
     {
       "type": 0,
@@ -819,6 +853,12 @@
       "value": "Kreditkarte"
     }
   ],
+  "checkout_payment.label.billing_address_form": [
+    {
+      "type": 0,
+      "value": "Formular für Rechnungsadresse"
+    }
+  ],
   "checkout_payment.label.same_as_shipping": [
     {
       "type": 0,
@@ -861,6 +901,18 @@
       "value": "Ja"
     }
   ],
+  "confirmation_modal.default.assistive_msg.no": [
+    {
+      "type": 0,
+      "value": "Nein, Aktion abbrechen"
+    }
+  ],
+  "confirmation_modal.default.assistive_msg.yes": [
+    {
+      "type": 0,
+      "value": "Ja, Aktion bestätigen"
+    }
+  ],
   "confirmation_modal.default.message.you_want_to_continue": [
     {
       "type": 0,
@@ -891,6 +943,24 @@
       "value": "Ja, Artikel entfernen"
     }
   ],
+  "confirmation_modal.remove_cart_item.assistive_msg.no": [
+    {
+      "type": 0,
+      "value": "Nein, Artikel beibehalten"
+    }
+  ],
+  "confirmation_modal.remove_cart_item.assistive_msg.remove": [
+    {
+      "type": 0,
+      "value": "Nicht verfügbare Produkte entfernen"
+    }
+  ],
+  "confirmation_modal.remove_cart_item.assistive_msg.yes": [
+    {
+      "type": 0,
+      "value": "Ja, Artikel entfernen"
+    }
+  ],
   "confirmation_modal.remove_cart_item.message.need_to_remove_due_to_unavailability": [
     {
       "type": 0,
@@ -999,6 +1069,56 @@
       "value": "Informationen zum Sicherheitscode"
     }
   ],
+  "display_price.assistive_msg.current_price": [
+    {
+      "type": 0,
+      "value": "aktueller Preis "
+    },
+    {
+      "type": 1,
+      "value": "currentPrice"
+    }
+  ],
+  "display_price.assistive_msg.current_price_with_range": [
+    {
+      "type": 0,
+      "value": "Ab aktuellem Preis "
+    },
+    {
+      "type": 1,
+      "value": "currentPrice"
+    }
+  ],
+  "display_price.assistive_msg.strikethrough_price": [
+    {
+      "type": 0,
+      "value": "ursprünglicher Preis "
+    },
+    {
+      "type": 1,
+      "value": "listPrice"
+    }
+  ],
+  "display_price.assistive_msg.strikethrough_price_with_range": [
+    {
+      "type": 0,
+      "value": "Ab ursprünglichem Preis "
+    },
+    {
+      "type": 1,
+      "value": "listPrice"
+    }
+  ],
+  "display_price.label.current_price_with_range": [
+    {
+      "type": 0,
+      "value": "Von "
+    },
+    {
+      "type": 1,
+      "value": "currentPrice"
+    }
+  ],
   "drawer_menu.button.account_details": [
     {
       "type": 0,
@@ -1029,6 +1149,12 @@
       "value": "Bestellverlauf"
     }
   ],
+  "drawer_menu.header.assistive_msg.title": [
+    {
+      "type": 0,
+      "value": "Menü-Drawer"
+    }
+  ],
   "drawer_menu.link.about_us": [
     {
       "type": 0,
@@ -1417,6 +1543,12 @@
       "value": "Menü"
     }
   ],
+  "header.button.assistive_msg.menu.open_dialog": [
+    {
+      "type": 0,
+      "value": "Öffnet einen Dialog"
+    }
+  ],
   "header.button.assistive_msg.my_account": [
     {
       "type": 0,
@@ -1439,6 +1571,12 @@
       "value": "numItems"
     }
   ],
+  "header.button.assistive_msg.store_locator": [
+    {
+      "type": 0,
+      "value": "Shop-Finder"
+    }
+  ],
   "header.button.assistive_msg.wishlist": [
     {
       "type": 0,
@@ -1649,6 +1787,12 @@
       "value": "quantity"
     }
   ],
+  "item_attributes.label.selected_options": [
+    {
+      "type": 0,
+      "value": "Ausgewählte Optionen"
+    }
+  ],
   "item_image.label.sale": [
     {
       "type": 0,
@@ -1661,10 +1805,32 @@
       "value": "Nicht verfügbar"
     }
   ],
-  "item_price.label.starting_at": [
+  "item_variant.assistive_msg.quantity": [
+    {
+      "type": 0,
+      "value": "Menge "
+    },
+    {
+      "type": 1,
+      "value": "quantity"
+    }
+  ],
+  "item_variant.quantity.label": [
+    {
+      "type": 0,
+      "value": "Mengenauswahl für "
+    },
+    {
+      "type": 1,
+      "value": "productName"
+    },
     {
       "type": 0,
-      "value": "Ab"
+      "value": ". Die gewählte Menge ist "
+    },
+    {
+      "type": 1,
+      "value": "quantity"
     }
   ],
   "lCPCxk": [
@@ -2477,14 +2643,28 @@
       "value": " aus der Wunschliste entfernt"
     }
   ],
-  "product_tile.label.starting_at_price": [
+  "product_tile.badge.label.new": [
     {
       "type": 0,
-      "value": "Ab "
-    },
+      "value": "Neu"
+    }
+  ],
+  "product_tile.badge.label.sale": [
     {
-      "type": 1,
-      "value": "price"
+      "type": 0,
+      "value": "Sonderangebot"
+    }
+  ],
+  "product_view.button.add_bundle_to_cart": [
+    {
+      "type": 0,
+      "value": "Bündel in den Warenkorb legen"
+    }
+  ],
+  "product_view.button.add_bundle_to_wishlist": [
+    {
+      "type": 0,
+      "value": "Bündel zur Wunschliste hinzufügen"
     }
   ],
   "product_view.button.add_set_to_cart": [
@@ -2520,13 +2700,21 @@
   "product_view.label.assistive_msg.quantity_decrement": [
     {
       "type": 0,
-      "value": "Menge verringern"
+      "value": "Menge verringern für "
+    },
+    {
+      "type": 1,
+      "value": "productName"
     }
   ],
   "product_view.label.assistive_msg.quantity_increment": [
     {
       "type": 0,
-      "value": "Menge erhöhen"
+      "value": "Menge erhöhen für "
+    },
+    {
+      "type": 1,
+      "value": "productName"
     }
   ],
   "product_view.label.quantity": [
@@ -2547,12 +2735,6 @@
       "value": "+"
     }
   ],
-  "product_view.label.starting_at_price": [
-    {
-      "type": 0,
-      "value": "Ab"
-    }
-  ],
   "product_view.label.variant_type": [
     {
       "type": 1,
@@ -2664,7 +2846,7 @@
       "children": [
         {
           "type": 0,
-          "value": "Datenschutzerklärung"
+          "value": "Datenschutzrichtlinie"
         }
       ],
       "type": 8,
@@ -2678,7 +2860,7 @@
       "children": [
         {
           "type": 0,
-          "value": "allgemeinen Geschäftsbedingungen"
+          "value": "Allgemeinen Geschäftsbedingungen"
         }
       ],
       "type": 8,
@@ -2787,6 +2969,32 @@
       "value": "Weiter zur Versandmethode"
     }
   ],
+  "shipping_address.label.edit_button": [
+    {
+      "type": 1,
+      "value": "address"
+    },
+    {
+      "type": 0,
+      "value": " bearbeiten"
+    }
+  ],
+  "shipping_address.label.remove_button": [
+    {
+      "type": 1,
+      "value": "address"
+    },
+    {
+      "type": 0,
+      "value": " entfernen"
+    }
+  ],
+  "shipping_address.label.shipping_address_form": [
+    {
+      "type": 0,
+      "value": "Formular für die Lieferadresse"
+    }
+  ],
   "shipping_address.title.shipping_address": [
     {
       "type": 0,
@@ -2877,6 +3085,144 @@
       "value": "Möchten Sie sich wirklich abmelden? Sie müssen sich wieder anmelden, um mit Ihrer aktuellen Bestellung fortzufahren."
     }
   ],
+  "store_locator.action.find": [
+    {
+      "type": 0,
+      "value": "Suchen"
+    }
+  ],
+  "store_locator.action.select_a_country": [
+    {
+      "type": 0,
+      "value": "Land auswählen"
+    }
+  ],
+  "store_locator.action.use_my_location": [
+    {
+      "type": 0,
+      "value": "Meinen Standort verwenden"
+    }
+  ],
+  "store_locator.action.viewMore": [
+    {
+      "type": 0,
+      "value": "Mehr anzeigen"
+    }
+  ],
+  "store_locator.description.away": [
+    {
+      "type": 0,
+      "value": "entfernt"
+    }
+  ],
+  "store_locator.description.loading_locations": [
+    {
+      "type": 0,
+      "value": "Standorte werden geladen …"
+    }
+  ],
+  "store_locator.description.no_locations": [
+    {
+      "type": 0,
+      "value": "Leider gibt es in dieser Gegend keine Standorte."
+    }
+  ],
+  "store_locator.description.or": [
+    {
+      "type": 0,
+      "value": "Oder"
+    }
+  ],
+  "store_locator.description.phone": [
+    {
+      "type": 0,
+      "value": "Telefon:"
+    }
+  ],
+  "store_locator.description.viewing_near_postal_code": [
+    {
+      "type": 0,
+      "value": "Anzeige von Geschäften innerhalb von "
+    },
+    {
+      "type": 1,
+      "value": "distance"
+    },
+    {
+      "type": 0,
+      "value": " "
+    },
+    {
+      "type": 1,
+      "value": "distanceUnit"
+    },
+    {
+      "type": 0,
+      "value": " von "
+    },
+    {
+      "type": 1,
+      "value": "postalCode"
+    },
+    {
+      "type": 0,
+      "value": " in"
+    }
+  ],
+  "store_locator.description.viewing_near_your_location": [
+    {
+      "type": 0,
+      "value": "Anzeige von Geschäften in der Nähe Ihres Standorts"
+    }
+  ],
+  "store_locator.dropdown.germany": [
+    {
+      "type": 0,
+      "value": "Deutschland"
+    }
+  ],
+  "store_locator.dropdown.united_states": [
+    {
+      "type": 0,
+      "value": "USA"
+    }
+  ],
+  "store_locator.error.agree_to_share_your_location": [
+    {
+      "type": 0,
+      "value": "Bitte stimmen Sie zu, Ihren Standort zu teilen."
+    }
+  ],
+  "store_locator.error.please_enter_a_postal_code": [
+    {
+      "type": 0,
+      "value": "Bitte geben Sie eine Postleitzahl ein."
+    }
+  ],
+  "store_locator.error.please_select_a_country": [
+    {
+      "type": 0,
+      "value": "Bitte wählen Sie ein Land aus."
+    }
+  ],
+  "store_locator.field.placeholder.enter_postal_code": [
+    {
+      "type": 0,
+      "value": "Postleitzahl eingeben"
+    }
+  ],
+  "store_locator.pagination.load_more": [
+    {
+      "type": 0,
+      "value": "Mehr laden"
+    }
+  ],
+  "store_locator.title": [
+    {
+      "type": 0,
+      "value": "Ein Geschäft finden"
+    }
+  ],
   "swatch_group.selected.label": [
     {
       "type": 1,
@@ -2893,6 +3239,30 @@
       "value": "Bearbeiten"
     }
   ],
+  "toggle_card.action.editContactInfo": [
+    {
+      "type": 0,
+      "value": "Kontaktinformationen bearbeiten"
+    }
+  ],
+  "toggle_card.action.editPaymentInfo": [
+    {
+      "type": 0,
+      "value": "Zahlungsinformationen bearbeiten"
+    }
+  ],
+  "toggle_card.action.editShippingAddress": [
+    {
+      "type": 0,
+      "value": "Lieferadresse bearbeiten"
+    }
+  ],
+  "toggle_card.action.editShippingOptions": [
+    {
+      "type": 0,
+      "value": "Versandoptionen bearbeiten"
+    }
+  ],
   "update_password_fields.button.forgot_password": [
     {
       "type": 0,
@@ -3153,12 +3523,44 @@
       "value": " vorhanden!"
     }
   ],
+  "use_product.message.inventory_remaining_for_product": [
+    {
+      "type": 0,
+      "value": "Nur noch "
+    },
+    {
+      "type": 1,
+      "value": "stockLevel"
+    },
+    {
+      "type": 0,
+      "value": " von "
+    },
+    {
+      "type": 1,
+      "value": "productName"
+    },
+    {
+      "type": 0,
+      "value": " vorhanden!"
+    }
+  ],
   "use_product.message.out_of_stock": [
     {
       "type": 0,
       "value": "Nicht vorrätig"
     }
   ],
+  "use_product.message.out_of_stock_for_product": [
+    {
+      "type": 0,
+      "value": "Nicht vorrätig für "
+    },
+    {
+      "type": 1,
+      "value": "productName"
+    }
+  ],
   "use_profile_fields.error.required_email": [
     {
       "type": 0,
@@ -3387,6 +3789,26 @@
       "value": "Neues Passwort"
     }
   ],
+  "wishlist_primary_action.button.addSetToCart.label": [
+    {
+      "type": 1,
+      "value": "productName"
+    },
+    {
+      "type": 0,
+      "value": "-Set im Warenkorb ablegen"
+    }
+  ],
+  "wishlist_primary_action.button.addToCart.label": [
+    {
+      "type": 1,
+      "value": "productName"
+    },
+    {
+      "type": 0,
+      "value": " im Warenkorb ablegen"
+    }
+  ],
   "wishlist_primary_action.button.add_set_to_cart": [
     {
       "type": 0,
@@ -3399,6 +3821,16 @@
       "value": "In den Warenkorb"
     }
   ],
+  "wishlist_primary_action.button.viewFullDetails.label": [
+    {
+      "type": 0,
+      "value": "Vollständige Details anzeigen für "
+    },
+    {
+      "type": 1,
+      "value": "productName"
+    }
+  ],
   "wishlist_primary_action.button.view_full_details": [
     {
       "type": 0,
@@ -3411,6 +3843,16 @@
       "value": "Optionen anzeigen"
     }
   ],
+  "wishlist_primary_action.button.view_options.label": [
+    {
+      "type": 0,
+      "value": "Optionen anzeigen für "
+    },
+    {
+      "type": 1,
+      "value": "productName"
+    }
+  ],
   "wishlist_primary_action.info.added_to_cart": [
     {
       "type": 1,
@@ -3455,6 +3897,16 @@
       "value": "Entfernen"
     }
   ],
+  "wishlist_secondary_button_group.info.item.remove.label": [
+    {
+      "type": 1,
+      "value": "productName"
+    },
+    {
+      "type": 0,
+      "value": " entfernen"
+    }
+  ],
   "wishlist_secondary_button_group.info.item_removed": [
     {
       "type": 0,
diff --git a/packages/template-retail-react-app/app/static/translations/compiled/en-GB.json b/packages/template-retail-react-app/app/static/translations/compiled/en-GB.json
index 352d183530..51fe13a1ae 100644
--- a/packages/template-retail-react-app/app/static/translations/compiled/en-GB.json
+++ b/packages/template-retail-react-app/app/static/translations/compiled/en-GB.json
@@ -1901,12 +1901,6 @@
       "value": "Secure"
     }
   ],
-  "item_attributes.label.is_bonus_product": [
-    {
-      "type": 0,
-      "value": "Bonus Product"
-    }
-  ],
   "item_attributes.label.promotions": [
     {
       "type": 0,
@@ -3289,140 +3283,6 @@
       "value": " to proceed."
     }
   ],
-  "store_locator.action.find": [
-    {
-      "type": 0,
-      "value": "Find"
-    }
-  ],
-  "store_locator.action.select_a_country": [
-    {
-      "type": 0,
-      "value": "Select a country"
-    }
-  ],
-  "store_locator.action.use_my_location": [
-    {
-      "type": 0,
-      "value": "Use My Location"
-    }
-  ],
-  "store_locator.action.viewMore": [
-    {
-      "type": 0,
-      "value": "View More"
-    }
-  ],
-  "store_locator.description.away": [
-    {
-      "type": 0,
-      "value": "away"
-    }
-  ],
-  "store_locator.description.loading_locations": [
-    {
-      "type": 0,
-      "value": "Loading locations..."
-    }
-  ],
-  "store_locator.description.no_locations": [
-    {
-      "type": 0,
-      "value": "Sorry, there are no locations in this area"
-    }
-  ],
-  "store_locator.description.or": [
-    {
-      "type": 0,
-      "value": "Or"
-    }
-  ],
-  "store_locator.description.phone": [
-    {
-      "type": 0,
-      "value": "Phone:"
-    }
-  ],
-  "store_locator.description.viewing_near_postal_code": [
-    {
-      "type": 0,
-      "value": "Viewing stores within "
-    },
-    {
-      "type": 1,
-      "value": "distance"
-    },
-    {
-      "type": 1,
-      "value": "distanceUnit"
-    },
-    {
-      "type": 0,
-      "value": " of "
-    },
-    {
-      "type": 1,
-      "value": "postalCode"
-    },
-    {
-      "type": 0,
-      "value": " in"
-    }
-  ],
-  "store_locator.description.viewing_near_your_location": [
-    {
-      "type": 0,
-      "value": "Viewing stores near your location"
-    }
-  ],
-  "store_locator.dropdown.germany": [
-    {
-      "type": 0,
-      "value": "Germany"
-    }
-  ],
-  "store_locator.dropdown.united_states": [
-    {
-      "type": 0,
-      "value": "United States"
-    }
-  ],
-  "store_locator.error.agree_to_share_your_location": [
-    {
-      "type": 0,
-      "value": "Please agree to share your location"
-    }
-  ],
-  "store_locator.error.please_enter_a_postal_code": [
-    {
-      "type": 0,
-      "value": "Please enter a postal code."
-    }
-  ],
-  "store_locator.error.please_select_a_country": [
-    {
-      "type": 0,
-      "value": "Please select a country."
-    }
-  ],
-  "store_locator.field.placeholder.enter_postal_code": [
-    {
-      "type": 0,
-      "value": "Enter postal code"
-    }
-  ],
-  "store_locator.pagination.load_more": [
-    {
-      "type": 0,
-      "value": "Load More"
-    }
-  ],
-  "store_locator.title": [
-    {
-      "type": 0,
-      "value": "Find a Store"
-    }
-  ],
   "swatch_group.selected.label": [
     {
       "type": 1,
diff --git a/packages/template-retail-react-app/app/static/translations/compiled/en-US.json b/packages/template-retail-react-app/app/static/translations/compiled/en-US.json
index 352d183530..51fe13a1ae 100644
--- a/packages/template-retail-react-app/app/static/translations/compiled/en-US.json
+++ b/packages/template-retail-react-app/app/static/translations/compiled/en-US.json
@@ -1901,12 +1901,6 @@
       "value": "Secure"
     }
   ],
-  "item_attributes.label.is_bonus_product": [
-    {
-      "type": 0,
-      "value": "Bonus Product"
-    }
-  ],
   "item_attributes.label.promotions": [
     {
       "type": 0,
@@ -3289,140 +3283,6 @@
       "value": " to proceed."
     }
   ],
-  "store_locator.action.find": [
-    {
-      "type": 0,
-      "value": "Find"
-    }
-  ],
-  "store_locator.action.select_a_country": [
-    {
-      "type": 0,
-      "value": "Select a country"
-    }
-  ],
-  "store_locator.action.use_my_location": [
-    {
-      "type": 0,
-      "value": "Use My Location"
-    }
-  ],
-  "store_locator.action.viewMore": [
-    {
-      "type": 0,
-      "value": "View More"
-    }
-  ],
-  "store_locator.description.away": [
-    {
-      "type": 0,
-      "value": "away"
-    }
-  ],
-  "store_locator.description.loading_locations": [
-    {
-      "type": 0,
-      "value": "Loading locations..."
-    }
-  ],
-  "store_locator.description.no_locations": [
-    {
-      "type": 0,
-      "value": "Sorry, there are no locations in this area"
-    }
-  ],
-  "store_locator.description.or": [
-    {
-      "type": 0,
-      "value": "Or"
-    }
-  ],
-  "store_locator.description.phone": [
-    {
-      "type": 0,
-      "value": "Phone:"
-    }
-  ],
-  "store_locator.description.viewing_near_postal_code": [
-    {
-      "type": 0,
-      "value": "Viewing stores within "
-    },
-    {
-      "type": 1,
-      "value": "distance"
-    },
-    {
-      "type": 1,
-      "value": "distanceUnit"
-    },
-    {
-      "type": 0,
-      "value": " of "
-    },
-    {
-      "type": 1,
-      "value": "postalCode"
-    },
-    {
-      "type": 0,
-      "value": " in"
-    }
-  ],
-  "store_locator.description.viewing_near_your_location": [
-    {
-      "type": 0,
-      "value": "Viewing stores near your location"
-    }
-  ],
-  "store_locator.dropdown.germany": [
-    {
-      "type": 0,
-      "value": "Germany"
-    }
-  ],
-  "store_locator.dropdown.united_states": [
-    {
-      "type": 0,
-      "value": "United States"
-    }
-  ],
-  "store_locator.error.agree_to_share_your_location": [
-    {
-      "type": 0,
-      "value": "Please agree to share your location"
-    }
-  ],
-  "store_locator.error.please_enter_a_postal_code": [
-    {
-      "type": 0,
-      "value": "Please enter a postal code."
-    }
-  ],
-  "store_locator.error.please_select_a_country": [
-    {
-      "type": 0,
-      "value": "Please select a country."
-    }
-  ],
-  "store_locator.field.placeholder.enter_postal_code": [
-    {
-      "type": 0,
-      "value": "Enter postal code"
-    }
-  ],
-  "store_locator.pagination.load_more": [
-    {
-      "type": 0,
-      "value": "Load More"
-    }
-  ],
-  "store_locator.title": [
-    {
-      "type": 0,
-      "value": "Find a Store"
-    }
-  ],
   "swatch_group.selected.label": [
     {
       "type": 1,
diff --git a/packages/template-retail-react-app/app/static/translations/compiled/en-XA.json b/packages/template-retail-react-app/app/static/translations/compiled/en-XA.json
index 75acacecc2..bc4d6a72bb 100644
--- a/packages/template-retail-react-app/app/static/translations/compiled/en-XA.json
+++ b/packages/template-retail-react-app/app/static/translations/compiled/en-XA.json
@@ -4013,20 +4013,6 @@
       "value": "]"
     }
   ],
-  "item_attributes.label.is_bonus_product": [
-    {
-      "type": 0,
-      "value": "["
-    },
-    {
-      "type": 0,
-      "value": "Ɓǿǿƞŭŭş Ƥřǿǿḓŭŭƈŧ"
-    },
-    {
-      "type": 0,
-      "value": "]"
-    }
-  ],
   "item_attributes.label.promotions": [
     {
       "type": 0,
@@ -7001,292 +6987,6 @@
       "value": "]"
     }
   ],
-  "store_locator.action.find": [
-    {
-      "type": 0,
-      "value": "["
-    },
-    {
-      "type": 0,
-      "value": "Ƒīƞḓ"
-    },
-    {
-      "type": 0,
-      "value": "]"
-    }
-  ],
-  "store_locator.action.select_a_country": [
-    {
-      "type": 0,
-      "value": "["
-    },
-    {
-      "type": 0,
-      "value": "Şḗḗŀḗḗƈŧ ȧȧ ƈǿǿŭŭƞŧřẏ"
-    },
-    {
-      "type": 0,
-      "value": "]"
-    }
-  ],
-  "store_locator.action.use_my_location": [
-    {
-      "type": 0,
-      "value": "["
-    },
-    {
-      "type": 0,
-      "value": "Ŭşḗḗ Ḿẏ Ŀǿǿƈȧȧŧīǿǿƞ"
-    },
-    {
-      "type": 0,
-      "value": "]"
-    }
-  ],
-  "store_locator.action.viewMore": [
-    {
-      "type": 0,
-      "value": "["
-    },
-    {
-      "type": 0,
-      "value": "Ṽīḗḗẇ Ḿǿǿřḗḗ"
-    },
-    {
-      "type": 0,
-      "value": "]"
-    }
-  ],
-  "store_locator.description.away": [
-    {
-      "type": 0,
-      "value": "["
-    },
-    {
-      "type": 0,
-      "value": "ȧȧẇȧȧẏ"
-    },
-    {
-      "type": 0,
-      "value": "]"
-    }
-  ],
-  "store_locator.description.loading_locations": [
-    {
-      "type": 0,
-      "value": "["
-    },
-    {
-      "type": 0,
-      "value": "Ŀǿǿȧȧḓīƞɠ ŀǿǿƈȧȧŧīǿǿƞş..."
-    },
-    {
-      "type": 0,
-      "value": "]"
-    }
-  ],
-  "store_locator.description.no_locations": [
-    {
-      "type": 0,
-      "value": "["
-    },
-    {
-      "type": 0,
-      "value": "Şǿǿřřẏ, ŧħḗḗřḗḗ ȧȧřḗḗ ƞǿǿ ŀǿǿƈȧȧŧīǿǿƞş īƞ ŧħīş ȧȧřḗḗȧȧ"
-    },
-    {
-      "type": 0,
-      "value": "]"
-    }
-  ],
-  "store_locator.description.or": [
-    {
-      "type": 0,
-      "value": "["
-    },
-    {
-      "type": 0,
-      "value": "Ǿř"
-    },
-    {
-      "type": 0,
-      "value": "]"
-    }
-  ],
-  "store_locator.description.phone": [
-    {
-      "type": 0,
-      "value": "["
-    },
-    {
-      "type": 0,
-      "value": "Ƥħǿǿƞḗḗ:"
-    },
-    {
-      "type": 0,
-      "value": "]"
-    }
-  ],
-  "store_locator.description.viewing_near_postal_code": [
-    {
-      "type": 0,
-      "value": "["
-    },
-    {
-      "type": 0,
-      "value": "Ṽīḗḗẇīƞɠ şŧǿǿřḗḗş ẇīŧħīƞ "
-    },
-    {
-      "type": 1,
-      "value": "distance"
-    },
-    {
-      "type": 1,
-      "value": "distanceUnit"
-    },
-    {
-      "type": 0,
-      "value": " ǿǿƒ "
-    },
-    {
-      "type": 1,
-      "value": "postalCode"
-    },
-    {
-      "type": 0,
-      "value": " īƞ"
-    },
-    {
-      "type": 0,
-      "value": "]"
-    }
-  ],
-  "store_locator.description.viewing_near_your_location": [
-    {
-      "type": 0,
-      "value": "["
-    },
-    {
-      "type": 0,
-      "value": "Ṽīḗḗẇīƞɠ şŧǿǿřḗḗş ƞḗḗȧȧř ẏǿǿŭŭř ŀǿǿƈȧȧŧīǿǿƞ"
-    },
-    {
-      "type": 0,
-      "value": "]"
-    }
-  ],
-  "store_locator.dropdown.germany": [
-    {
-      "type": 0,
-      "value": "["
-    },
-    {
-      "type": 0,
-      "value": "Ɠḗḗřḿȧȧƞẏ"
-    },
-    {
-      "type": 0,
-      "value": "]"
-    }
-  ],
-  "store_locator.dropdown.united_states": [
-    {
-      "type": 0,
-      "value": "["
-    },
-    {
-      "type": 0,
-      "value": "Ŭƞīŧḗḗḓ Şŧȧȧŧḗḗş"
-    },
-    {
-      "type": 0,
-      "value": "]"
-    }
-  ],
-  "store_locator.error.agree_to_share_your_location": [
-    {
-      "type": 0,
-      "value": "["
-    },
-    {
-      "type": 0,
-      "value": "Ƥŀḗḗȧȧşḗḗ ȧȧɠřḗḗḗḗ ŧǿǿ şħȧȧřḗḗ ẏǿǿŭŭř ŀǿǿƈȧȧŧīǿǿƞ"
-    },
-    {
-      "type": 0,
-      "value": "]"
-    }
-  ],
-  "store_locator.error.please_enter_a_postal_code": [
-    {
-      "type": 0,
-      "value": "["
-    },
-    {
-      "type": 0,
-      "value": "Ƥŀḗḗȧȧşḗḗ ḗḗƞŧḗḗř ȧȧ ƥǿǿşŧȧȧŀ ƈǿǿḓḗḗ."
-    },
-    {
-      "type": 0,
-      "value": "]"
-    }
-  ],
-  "store_locator.error.please_select_a_country": [
-    {
-      "type": 0,
-      "value": "["
-    },
-    {
-      "type": 0,
-      "value": "Ƥŀḗḗȧȧşḗḗ şḗḗŀḗḗƈŧ ȧȧ ƈǿǿŭŭƞŧřẏ."
-    },
-    {
-      "type": 0,
-      "value": "]"
-    }
-  ],
-  "store_locator.field.placeholder.enter_postal_code": [
-    {
-      "type": 0,
-      "value": "["
-    },
-    {
-      "type": 0,
-      "value": "Ḗƞŧḗḗř ƥǿǿşŧȧȧŀ ƈǿǿḓḗḗ"
-    },
-    {
-      "type": 0,
-      "value": "]"
-    }
-  ],
-  "store_locator.pagination.load_more": [
-    {
-      "type": 0,
-      "value": "["
-    },
-    {
-      "type": 0,
-      "value": "Ŀǿǿȧȧḓ Ḿǿǿřḗḗ"
-    },
-    {
-      "type": 0,
-      "value": "]"
-    }
-  ],
-  "store_locator.title": [
-    {
-      "type": 0,
-      "value": "["
-    },
-    {
-      "type": 0,
-      "value": "Ƒīƞḓ ȧȧ Şŧǿǿřḗḗ"
-    },
-    {
-      "type": 0,
-      "value": "]"
-    }
-  ],
   "swatch_group.selected.label": [
     {
       "type": 0,
diff --git a/packages/template-retail-react-app/app/static/translations/compiled/es-MX.json b/packages/template-retail-react-app/app/static/translations/compiled/es-MX.json
index 53ef078c5d..8f0a5b311c 100644
--- a/packages/template-retail-react-app/app/static/translations/compiled/es-MX.json
+++ b/packages/template-retail-react-app/app/static/translations/compiled/es-MX.json
@@ -437,6 +437,16 @@
       "value": "Artículo eliminado del carrito"
     }
   ],
+  "cart.product_edit_modal.modal_label": [
+    {
+      "type": 0,
+      "value": "Editar modal para "
+    },
+    {
+      "type": 1,
+      "value": "productName"
+    }
+  ],
   "cart.recommended_products.title.may_also_like": [
     {
       "type": 0,
@@ -539,6 +549,12 @@
       "value": ")"
     }
   ],
+  "category_links.button_text": [
+    {
+      "type": 0,
+      "value": "Categorías"
+    }
+  ],
   "cc_radio_group.action.remove": [
     {
       "type": 0,
@@ -653,6 +669,24 @@
       "value": "Envío"
     }
   ],
+  "checkout_confirmation.label.shipping.strikethrough.price": [
+    {
+      "type": 0,
+      "value": "Originalmente "
+    },
+    {
+      "type": 1,
+      "value": "originalPrice"
+    },
+    {
+      "type": 0,
+      "value": ", ahora "
+    },
+    {
+      "type": 1,
+      "value": "newPrice"
+    }
+  ],
   "checkout_confirmation.label.subtotal": [
     {
       "type": 0,
@@ -819,6 +853,12 @@
       "value": "Tarjeta de crédito"
     }
   ],
+  "checkout_payment.label.billing_address_form": [
+    {
+      "type": 0,
+      "value": "Formulario de dirección de facturación"
+    }
+  ],
   "checkout_payment.label.same_as_shipping": [
     {
       "type": 0,
@@ -861,6 +901,18 @@
       "value": "Sí"
     }
   ],
+  "confirmation_modal.default.assistive_msg.no": [
+    {
+      "type": 0,
+      "value": "No, cancelar acción"
+    }
+  ],
+  "confirmation_modal.default.assistive_msg.yes": [
+    {
+      "type": 0,
+      "value": "Sí, confirme la acción"
+    }
+  ],
   "confirmation_modal.default.message.you_want_to_continue": [
     {
       "type": 0,
@@ -891,6 +943,24 @@
       "value": "Sí, eliminar artículo"
     }
   ],
+  "confirmation_modal.remove_cart_item.assistive_msg.no": [
+    {
+      "type": 0,
+      "value": "No, conservar artículo"
+    }
+  ],
+  "confirmation_modal.remove_cart_item.assistive_msg.remove": [
+    {
+      "type": 0,
+      "value": "Eliminar productos no disponibles"
+    }
+  ],
+  "confirmation_modal.remove_cart_item.assistive_msg.yes": [
+    {
+      "type": 0,
+      "value": "Sí, eliminar artículo"
+    }
+  ],
   "confirmation_modal.remove_cart_item.message.need_to_remove_due_to_unavailability": [
     {
       "type": 0,
@@ -999,6 +1069,56 @@
       "value": "Información del código de seguridad"
     }
   ],
+  "display_price.assistive_msg.current_price": [
+    {
+      "type": 0,
+      "value": "precio actual "
+    },
+    {
+      "type": 1,
+      "value": "currentPrice"
+    }
+  ],
+  "display_price.assistive_msg.current_price_with_range": [
+    {
+      "type": 0,
+      "value": "A partir del precio actual "
+    },
+    {
+      "type": 1,
+      "value": "currentPrice"
+    }
+  ],
+  "display_price.assistive_msg.strikethrough_price": [
+    {
+      "type": 0,
+      "value": "precio original "
+    },
+    {
+      "type": 1,
+      "value": "listPrice"
+    }
+  ],
+  "display_price.assistive_msg.strikethrough_price_with_range": [
+    {
+      "type": 0,
+      "value": "Desde el precio original "
+    },
+    {
+      "type": 1,
+      "value": "listPrice"
+    }
+  ],
+  "display_price.label.current_price_with_range": [
+    {
+      "type": 0,
+      "value": "De "
+    },
+    {
+      "type": 1,
+      "value": "currentPrice"
+    }
+  ],
   "drawer_menu.button.account_details": [
     {
       "type": 0,
@@ -1029,6 +1149,12 @@
       "value": "Historial de pedidos"
     }
   ],
+  "drawer_menu.header.assistive_msg.title": [
+    {
+      "type": 0,
+      "value": "Cajón de menú"
+    }
+  ],
   "drawer_menu.link.about_us": [
     {
       "type": 0,
@@ -1080,7 +1206,7 @@
   "drawer_menu.link.sign_in": [
     {
       "type": 0,
-      "value": "Registrarte"
+      "value": "Registrarse"
     }
   ],
   "drawer_menu.link.site_map": [
@@ -1417,6 +1543,12 @@
       "value": "Menú"
     }
   ],
+  "header.button.assistive_msg.menu.open_dialog": [
+    {
+      "type": 0,
+      "value": "Abre un cuadro de diálogo"
+    }
+  ],
   "header.button.assistive_msg.my_account": [
     {
       "type": 0,
@@ -1439,6 +1571,12 @@
       "value": "numItems"
     }
   ],
+  "header.button.assistive_msg.store_locator": [
+    {
+      "type": 0,
+      "value": "Localizador de tiendas"
+    }
+  ],
   "header.button.assistive_msg.wishlist": [
     {
       "type": 0,
@@ -1649,6 +1787,12 @@
       "value": "quantity"
     }
   ],
+  "item_attributes.label.selected_options": [
+    {
+      "type": 0,
+      "value": "Opciones seleccionadas:"
+    }
+  ],
   "item_image.label.sale": [
     {
       "type": 0,
@@ -1661,10 +1805,32 @@
       "value": "No disponible"
     }
   ],
-  "item_price.label.starting_at": [
+  "item_variant.assistive_msg.quantity": [
     {
       "type": 0,
-      "value": "Comienza en"
+      "value": "Cantidad "
+    },
+    {
+      "type": 1,
+      "value": "quantity"
+    }
+  ],
+  "item_variant.quantity.label": [
+    {
+      "type": 0,
+      "value": "Selector de cantidad para "
+    },
+    {
+      "type": 1,
+      "value": "productName"
+    },
+    {
+      "type": 0,
+      "value": ". La cantidad seleccionada es "
+    },
+    {
+      "type": 1,
+      "value": "quantity"
     }
   ],
   "lCPCxk": [
@@ -2489,14 +2655,28 @@
       "value": " de la lista de deseos"
     }
   ],
-  "product_tile.label.starting_at_price": [
+  "product_tile.badge.label.new": [
     {
       "type": 0,
-      "value": "Comienza en "
-    },
+      "value": "Crear"
+    }
+  ],
+  "product_tile.badge.label.sale": [
     {
-      "type": 1,
-      "value": "price"
+      "type": 0,
+      "value": "Ofertas"
+    }
+  ],
+  "product_view.button.add_bundle_to_cart": [
+    {
+      "type": 0,
+      "value": "Agregar paquete al carrito"
+    }
+  ],
+  "product_view.button.add_bundle_to_wishlist": [
+    {
+      "type": 0,
+      "value": "Añadir paquete a la lista de deseos"
     }
   ],
   "product_view.button.add_set_to_cart": [
@@ -2532,13 +2712,21 @@
   "product_view.label.assistive_msg.quantity_decrement": [
     {
       "type": 0,
-      "value": "Cantidad de decremento"
+      "value": "Disminuir la cantidad de "
+    },
+    {
+      "type": 1,
+      "value": "productName"
     }
   ],
   "product_view.label.assistive_msg.quantity_increment": [
     {
       "type": 0,
-      "value": "Incrementar cantidad"
+      "value": "Incrementar cantidad de "
+    },
+    {
+      "type": 1,
+      "value": "productName"
     }
   ],
   "product_view.label.quantity": [
@@ -2559,12 +2747,6 @@
       "value": "+"
     }
   ],
-  "product_view.label.starting_at_price": [
-    {
-      "type": 0,
-      "value": "Comienza en"
-    }
-  ],
   "product_view.label.variant_type": [
     {
       "type": 1,
@@ -2799,6 +2981,32 @@
       "value": "Continuar a método de envío"
     }
   ],
+  "shipping_address.label.edit_button": [
+    {
+      "type": 0,
+      "value": "Editar "
+    },
+    {
+      "type": 1,
+      "value": "address"
+    }
+  ],
+  "shipping_address.label.remove_button": [
+    {
+      "type": 0,
+      "value": "Eliminar "
+    },
+    {
+      "type": 1,
+      "value": "address"
+    }
+  ],
+  "shipping_address.label.shipping_address_form": [
+    {
+      "type": 0,
+      "value": "Formulario de dirección de envío"
+    }
+  ],
   "shipping_address.title.shipping_address": [
     {
       "type": 0,
@@ -2889,6 +3097,140 @@
       "value": "¿Está seguro de que desea cerrar sesión? Deberá volver a registrarse para continuar con su pedido actual."
     }
   ],
+  "store_locator.action.find": [
+    {
+      "type": 0,
+      "value": "Encontrar"
+    }
+  ],
+  "store_locator.action.select_a_country": [
+    {
+      "type": 0,
+      "value": "Seleccionar un país..."
+    }
+  ],
+  "store_locator.action.use_my_location": [
+    {
+      "type": 0,
+      "value": "Usar mi ubicación"
+    }
+  ],
+  "store_locator.action.viewMore": [
+    {
+      "type": 0,
+      "value": "Ver más"
+    }
+  ],
+  "store_locator.description.away": [
+    {
+      "type": 0,
+      "value": "de distancia"
+    }
+  ],
+  "store_locator.description.loading_locations": [
+    {
+      "type": 0,
+      "value": "Lugares de carga..."
+    }
+  ],
+  "store_locator.description.no_locations": [
+    {
+      "type": 0,
+      "value": "Lo sentimos, no hay ubicaciones en esta área"
+    }
+  ],
+  "store_locator.description.or": [
+    {
+      "type": 0,
+      "value": "O"
+    }
+  ],
+  "store_locator.description.phone": [
+    {
+      "type": 0,
+      "value": "Teléfono:"
+    }
+  ],
+  "store_locator.description.viewing_near_postal_code": [
+    {
+      "type": 0,
+      "value": "Visualización de tiendas dentro "
+    },
+    {
+      "type": 1,
+      "value": "distance"
+    },
+    {
+      "type": 1,
+      "value": "distanceUnit"
+    },
+    {
+      "type": 0,
+      "value": " de "
+    },
+    {
+      "type": 1,
+      "value": "postalCode"
+    },
+    {
+      "type": 0,
+      "value": " en"
+    }
+  ],
+  "store_locator.description.viewing_near_your_location": [
+    {
+      "type": 0,
+      "value": "Ver tiendas cerca de tu ubicación"
+    }
+  ],
+  "store_locator.dropdown.germany": [
+    {
+      "type": 0,
+      "value": "Alemania"
+    }
+  ],
+  "store_locator.dropdown.united_states": [
+    {
+      "type": 0,
+      "value": "Estados Unidos"
+    }
+  ],
+  "store_locator.error.agree_to_share_your_location": [
+    {
+      "type": 0,
+      "value": "Acepte compartir su ubicación"
+    }
+  ],
+  "store_locator.error.please_enter_a_postal_code": [
+    {
+      "type": 0,
+      "value": "Introduzca un código postal."
+    }
+  ],
+  "store_locator.error.please_select_a_country": [
+    {
+      "type": 0,
+      "value": "Seleccione un país."
+    }
+  ],
+  "store_locator.field.placeholder.enter_postal_code": [
+    {
+      "type": 0,
+      "value": "Ingrese el código postal"
+    }
+  ],
+  "store_locator.pagination.load_more": [
+    {
+      "type": 0,
+      "value": "Cargar más"
+    }
+  ],
+  "store_locator.title": [
+    {
+      "type": 0,
+      "value": "Buscar una tienda"
+    }
+  ],
   "swatch_group.selected.label": [
     {
       "type": 1,
@@ -2905,6 +3247,30 @@
       "value": "Editar"
     }
   ],
+  "toggle_card.action.editContactInfo": [
+    {
+      "type": 0,
+      "value": "Editar información de contacto"
+    }
+  ],
+  "toggle_card.action.editPaymentInfo": [
+    {
+      "type": 0,
+      "value": "Editar información de pago"
+    }
+  ],
+  "toggle_card.action.editShippingAddress": [
+    {
+      "type": 0,
+      "value": "Editar dirección de envío"
+    }
+  ],
+  "toggle_card.action.editShippingOptions": [
+    {
+      "type": 0,
+      "value": "Editar opciones de envío"
+    }
+  ],
   "update_password_fields.button.forgot_password": [
     {
       "type": 0,
@@ -2956,7 +3322,7 @@
   "use_address_fields.error.please_select_your_state_or_province": [
     {
       "type": 0,
-      "value": "Seleccione su estado/provincia."
+      "value": "Seleccione su estado."
     }
   ],
   "use_address_fields.error.required": [
@@ -3165,12 +3531,44 @@
       "value": "!"
     }
   ],
+  "use_product.message.inventory_remaining_for_product": [
+    {
+      "type": 0,
+      "value": "¡Solo "
+    },
+    {
+      "type": 1,
+      "value": "stockLevel"
+    },
+    {
+      "type": 0,
+      "value": " queda para "
+    },
+    {
+      "type": 1,
+      "value": "productName"
+    },
+    {
+      "type": 0,
+      "value": "!"
+    }
+  ],
   "use_product.message.out_of_stock": [
     {
       "type": 0,
       "value": "Agotado"
     }
   ],
+  "use_product.message.out_of_stock_for_product": [
+    {
+      "type": 0,
+      "value": "Agotado para "
+    },
+    {
+      "type": 1,
+      "value": "productName"
+    }
+  ],
   "use_profile_fields.error.required_email": [
     {
       "type": 0,
@@ -3399,6 +3797,34 @@
       "value": "Contraseña nueva"
     }
   ],
+  "wishlist_primary_action.button.addSetToCart.label": [
+    {
+      "type": 0,
+      "value": "Agregar conjunto de "
+    },
+    {
+      "type": 1,
+      "value": "productName"
+    },
+    {
+      "type": 0,
+      "value": " al carrito"
+    }
+  ],
+  "wishlist_primary_action.button.addToCart.label": [
+    {
+      "type": 0,
+      "value": "Agregar "
+    },
+    {
+      "type": 1,
+      "value": "productName"
+    },
+    {
+      "type": 0,
+      "value": " al carrito"
+    }
+  ],
   "wishlist_primary_action.button.add_set_to_cart": [
     {
       "type": 0,
@@ -3411,6 +3837,16 @@
       "value": "Agregar al carrito"
     }
   ],
+  "wishlist_primary_action.button.viewFullDetails.label": [
+    {
+      "type": 0,
+      "value": "Ver todos los detalles de "
+    },
+    {
+      "type": 1,
+      "value": "productName"
+    }
+  ],
   "wishlist_primary_action.button.view_full_details": [
     {
       "type": 0,
@@ -3423,6 +3859,16 @@
       "value": "Ver opciones"
     }
   ],
+  "wishlist_primary_action.button.view_options.label": [
+    {
+      "type": 0,
+      "value": "Ver opciones para "
+    },
+    {
+      "type": 1,
+      "value": "productName"
+    }
+  ],
   "wishlist_primary_action.info.added_to_cart": [
     {
       "type": 1,
@@ -3467,6 +3913,16 @@
       "value": "Eliminar"
     }
   ],
+  "wishlist_secondary_button_group.info.item.remove.label": [
+    {
+      "type": 0,
+      "value": "Eliminar "
+    },
+    {
+      "type": 1,
+      "value": "productName"
+    }
+  ],
   "wishlist_secondary_button_group.info.item_removed": [
     {
       "type": 0,
diff --git a/packages/template-retail-react-app/app/static/translations/compiled/fr-FR.json b/packages/template-retail-react-app/app/static/translations/compiled/fr-FR.json
index 45ec55f871..ad655d64aa 100644
--- a/packages/template-retail-react-app/app/static/translations/compiled/fr-FR.json
+++ b/packages/template-retail-react-app/app/static/translations/compiled/fr-FR.json
@@ -437,6 +437,16 @@
       "value": "Article supprimé du panier"
     }
   ],
+  "cart.product_edit_modal.modal_label": [
+    {
+      "type": 0,
+      "value": "Modifier la fenêtre modale pour "
+    },
+    {
+      "type": 1,
+      "value": "productName"
+    }
+  ],
   "cart.recommended_products.title.may_also_like": [
     {
       "type": 0,
@@ -539,6 +549,12 @@
       "value": ")"
     }
   ],
+  "category_links.button_text": [
+    {
+      "type": 0,
+      "value": "Catégories"
+    }
+  ],
   "cc_radio_group.action.remove": [
     {
       "type": 0,
@@ -653,6 +669,24 @@
       "value": "Livraison"
     }
   ],
+  "checkout_confirmation.label.shipping.strikethrough.price": [
+    {
+      "type": 0,
+      "value": "À l’origine "
+    },
+    {
+      "type": 1,
+      "value": "originalPrice"
+    },
+    {
+      "type": 0,
+      "value": ", aujourd’hui "
+    },
+    {
+      "type": 1,
+      "value": "newPrice"
+    }
+  ],
   "checkout_confirmation.label.subtotal": [
     {
       "type": 0,
@@ -819,6 +853,12 @@
       "value": "Carte de crédit"
     }
   ],
+  "checkout_payment.label.billing_address_form": [
+    {
+      "type": 0,
+      "value": "Formulaire d’adresse de facturation"
+    }
+  ],
   "checkout_payment.label.same_as_shipping": [
     {
       "type": 0,
@@ -861,6 +901,18 @@
       "value": "Oui"
     }
   ],
+  "confirmation_modal.default.assistive_msg.no": [
+    {
+      "type": 0,
+      "value": "Non, annuler l’action"
+    }
+  ],
+  "confirmation_modal.default.assistive_msg.yes": [
+    {
+      "type": 0,
+      "value": "Oui, confirmer l’action"
+    }
+  ],
   "confirmation_modal.default.message.you_want_to_continue": [
     {
       "type": 0,
@@ -891,6 +943,24 @@
       "value": "Oui, supprimer l’article"
     }
   ],
+  "confirmation_modal.remove_cart_item.assistive_msg.no": [
+    {
+      "type": 0,
+      "value": "Non, garder l’article"
+    }
+  ],
+  "confirmation_modal.remove_cart_item.assistive_msg.remove": [
+    {
+      "type": 0,
+      "value": "Supprimer les produits non disponibles"
+    }
+  ],
+  "confirmation_modal.remove_cart_item.assistive_msg.yes": [
+    {
+      "type": 0,
+      "value": "Oui, supprimer l’article"
+    }
+  ],
   "confirmation_modal.remove_cart_item.message.need_to_remove_due_to_unavailability": [
     {
       "type": 0,
@@ -999,6 +1069,56 @@
       "value": "Cryptogramme"
     }
   ],
+  "display_price.assistive_msg.current_price": [
+    {
+      "type": 0,
+      "value": "prix actuel "
+    },
+    {
+      "type": 1,
+      "value": "currentPrice"
+    }
+  ],
+  "display_price.assistive_msg.current_price_with_range": [
+    {
+      "type": 0,
+      "value": "À partir du prix actuel "
+    },
+    {
+      "type": 1,
+      "value": "currentPrice"
+    }
+  ],
+  "display_price.assistive_msg.strikethrough_price": [
+    {
+      "type": 0,
+      "value": "prix d’origine "
+    },
+    {
+      "type": 1,
+      "value": "listPrice"
+    }
+  ],
+  "display_price.assistive_msg.strikethrough_price_with_range": [
+    {
+      "type": 0,
+      "value": "À partir du prix d’origine "
+    },
+    {
+      "type": 1,
+      "value": "listPrice"
+    }
+  ],
+  "display_price.label.current_price_with_range": [
+    {
+      "type": 0,
+      "value": "Du "
+    },
+    {
+      "type": 1,
+      "value": "currentPrice"
+    }
+  ],
   "drawer_menu.button.account_details": [
     {
       "type": 0,
@@ -1029,6 +1149,12 @@
       "value": "Historique des commandes"
     }
   ],
+  "drawer_menu.header.assistive_msg.title": [
+    {
+      "type": 0,
+      "value": "Tiroir de menu"
+    }
+  ],
   "drawer_menu.link.about_us": [
     {
       "type": 0,
@@ -1417,6 +1543,12 @@
       "value": "Menu"
     }
   ],
+  "header.button.assistive_msg.menu.open_dialog": [
+    {
+      "type": 0,
+      "value": "Ouvre une boîte de dialogue"
+    }
+  ],
   "header.button.assistive_msg.my_account": [
     {
       "type": 0,
@@ -1439,6 +1571,12 @@
       "value": "numItems"
     }
   ],
+  "header.button.assistive_msg.store_locator": [
+    {
+      "type": 0,
+      "value": "Localisateur de magasins"
+    }
+  ],
   "header.button.assistive_msg.wishlist": [
     {
       "type": 0,
@@ -1649,10 +1787,16 @@
       "value": "quantity"
     }
   ],
+  "item_attributes.label.selected_options": [
+    {
+      "type": 0,
+      "value": "Options sélectionnées"
+    }
+  ],
   "item_image.label.sale": [
     {
       "type": 0,
-      "value": "Vente"
+      "value": "En solde"
     }
   ],
   "item_image.label.unavailable": [
@@ -1661,10 +1805,32 @@
       "value": "Non disponible"
     }
   ],
-  "item_price.label.starting_at": [
+  "item_variant.assistive_msg.quantity": [
     {
       "type": 0,
-      "value": "À partir de"
+      "value": "Quantité "
+    },
+    {
+      "type": 1,
+      "value": "quantity"
+    }
+  ],
+  "item_variant.quantity.label": [
+    {
+      "type": 0,
+      "value": "Sélecteur de quantité pour "
+    },
+    {
+      "type": 1,
+      "value": "productName"
+    },
+    {
+      "type": 0,
+      "value": ". La quantité sélectionnée est "
+    },
+    {
+      "type": 1,
+      "value": "quantity"
     }
   ],
   "lCPCxk": [
@@ -2489,14 +2655,28 @@
       "value": " de la liste de souhaits"
     }
   ],
-  "product_tile.label.starting_at_price": [
+  "product_tile.badge.label.new": [
     {
       "type": 0,
-      "value": "À partir de "
-    },
+      "value": "Nouveau"
+    }
+  ],
+  "product_tile.badge.label.sale": [
     {
-      "type": 1,
-      "value": "price"
+      "type": 0,
+      "value": "En solde"
+    }
+  ],
+  "product_view.button.add_bundle_to_cart": [
+    {
+      "type": 0,
+      "value": "Ajouter l’offre groupée au panier"
+    }
+  ],
+  "product_view.button.add_bundle_to_wishlist": [
+    {
+      "type": 0,
+      "value": "Ajouter l’offre groupée à la liste de souhaits"
     }
   ],
   "product_view.button.add_set_to_cart": [
@@ -2532,13 +2712,21 @@
   "product_view.label.assistive_msg.quantity_decrement": [
     {
       "type": 0,
-      "value": "Décrémenter la quantité"
+      "value": "Décrémenter la quantité pour "
+    },
+    {
+      "type": 1,
+      "value": "productName"
     }
   ],
   "product_view.label.assistive_msg.quantity_increment": [
     {
       "type": 0,
-      "value": "Incrémenter la quantité"
+      "value": "Incrémenter la quantité pour "
+    },
+    {
+      "type": 1,
+      "value": "productName"
     }
   ],
   "product_view.label.quantity": [
@@ -2559,12 +2747,6 @@
       "value": "+"
     }
   ],
-  "product_view.label.starting_at_price": [
-    {
-      "type": 0,
-      "value": "À partir de"
-    }
-  ],
   "product_view.label.variant_type": [
     {
       "type": 1,
@@ -2799,6 +2981,32 @@
       "value": "Continuer vers le mode de livraison"
     }
   ],
+  "shipping_address.label.edit_button": [
+    {
+      "type": 0,
+      "value": "Modifier "
+    },
+    {
+      "type": 1,
+      "value": "address"
+    }
+  ],
+  "shipping_address.label.remove_button": [
+    {
+      "type": 0,
+      "value": "Supprimer "
+    },
+    {
+      "type": 1,
+      "value": "address"
+    }
+  ],
+  "shipping_address.label.shipping_address_form": [
+    {
+      "type": 0,
+      "value": "Formulaire d’adresse de livraison"
+    }
+  ],
   "shipping_address.title.shipping_address": [
     {
       "type": 0,
@@ -2889,6 +3097,144 @@
       "value": "Voulez-vous vraiment vous déconnecter ? Vous devrez vous reconnecter pour poursuivre votre commande en cours."
     }
   ],
+  "store_locator.action.find": [
+    {
+      "type": 0,
+      "value": "Rechercher"
+    }
+  ],
+  "store_locator.action.select_a_country": [
+    {
+      "type": 0,
+      "value": "Sélectionner un pays"
+    }
+  ],
+  "store_locator.action.use_my_location": [
+    {
+      "type": 0,
+      "value": "Utiliser mon emplacement"
+    }
+  ],
+  "store_locator.action.viewMore": [
+    {
+      "type": 0,
+      "value": "Afficher plus"
+    }
+  ],
+  "store_locator.description.away": [
+    {
+      "type": 0,
+      "value": "à"
+    }
+  ],
+  "store_locator.description.loading_locations": [
+    {
+      "type": 0,
+      "value": "Lieux de chargement..."
+    }
+  ],
+  "store_locator.description.no_locations": [
+    {
+      "type": 0,
+      "value": "Désolé, il n’y a pas d’emplacements dans cette zone"
+    }
+  ],
+  "store_locator.description.or": [
+    {
+      "type": 0,
+      "value": "Ou"
+    }
+  ],
+  "store_locator.description.phone": [
+    {
+      "type": 0,
+      "value": "Téléphone :"
+    }
+  ],
+  "store_locator.description.viewing_near_postal_code": [
+    {
+      "type": 0,
+      "value": "Affichage des magasins à moins de "
+    },
+    {
+      "type": 1,
+      "value": "distance"
+    },
+    {
+      "type": 0,
+      "value": " "
+    },
+    {
+      "type": 1,
+      "value": "distanceUnit"
+    },
+    {
+      "type": 0,
+      "value": " de "
+    },
+    {
+      "type": 1,
+      "value": "postalCode"
+    },
+    {
+      "type": 0,
+      "value": " dans ce pays :"
+    }
+  ],
+  "store_locator.description.viewing_near_your_location": [
+    {
+      "type": 0,
+      "value": "Affichage des magasins à proximité de votre emplacement"
+    }
+  ],
+  "store_locator.dropdown.germany": [
+    {
+      "type": 0,
+      "value": "Allemagne"
+    }
+  ],
+  "store_locator.dropdown.united_states": [
+    {
+      "type": 0,
+      "value": "États-Unis"
+    }
+  ],
+  "store_locator.error.agree_to_share_your_location": [
+    {
+      "type": 0,
+      "value": "Veuillez accepter de partager votre emplacement"
+    }
+  ],
+  "store_locator.error.please_enter_a_postal_code": [
+    {
+      "type": 0,
+      "value": "Veuillez saisir un code postal."
+    }
+  ],
+  "store_locator.error.please_select_a_country": [
+    {
+      "type": 0,
+      "value": "Veuillez sélectionner un pays."
+    }
+  ],
+  "store_locator.field.placeholder.enter_postal_code": [
+    {
+      "type": 0,
+      "value": "Entrer un code postal"
+    }
+  ],
+  "store_locator.pagination.load_more": [
+    {
+      "type": 0,
+      "value": "Charger plus de résultats"
+    }
+  ],
+  "store_locator.title": [
+    {
+      "type": 0,
+      "value": "Trouver un magasin"
+    }
+  ],
   "swatch_group.selected.label": [
     {
       "type": 1,
@@ -2905,6 +3251,30 @@
       "value": "Modifier"
     }
   ],
+  "toggle_card.action.editContactInfo": [
+    {
+      "type": 0,
+      "value": "Modifier les coordonnées"
+    }
+  ],
+  "toggle_card.action.editPaymentInfo": [
+    {
+      "type": 0,
+      "value": "Modifier les informations de paiement"
+    }
+  ],
+  "toggle_card.action.editShippingAddress": [
+    {
+      "type": 0,
+      "value": "Modifier l’adresse de livraison"
+    }
+  ],
+  "toggle_card.action.editShippingOptions": [
+    {
+      "type": 0,
+      "value": "Modifier les options de livraison"
+    }
+  ],
   "update_password_fields.button.forgot_password": [
     {
       "type": 0,
@@ -3165,12 +3535,44 @@
       "value": " !"
     }
   ],
+  "use_product.message.inventory_remaining_for_product": [
+    {
+      "type": 0,
+      "value": "Il ne reste plus que "
+    },
+    {
+      "type": 1,
+      "value": "stockLevel"
+    },
+    {
+      "type": 0,
+      "value": " articles pour "
+    },
+    {
+      "type": 1,
+      "value": "productName"
+    },
+    {
+      "type": 0,
+      "value": " !"
+    }
+  ],
   "use_product.message.out_of_stock": [
     {
       "type": 0,
       "value": "En rupture de stock"
     }
   ],
+  "use_product.message.out_of_stock_for_product": [
+    {
+      "type": 0,
+      "value": "Rupture de stock pour "
+    },
+    {
+      "type": 1,
+      "value": "productName"
+    }
+  ],
   "use_profile_fields.error.required_email": [
     {
       "type": 0,
@@ -3399,6 +3801,34 @@
       "value": "Nouveau mot de passe"
     }
   ],
+  "wishlist_primary_action.button.addSetToCart.label": [
+    {
+      "type": 0,
+      "value": "Ajouter le lot "
+    },
+    {
+      "type": 1,
+      "value": "productName"
+    },
+    {
+      "type": 0,
+      "value": " au panier"
+    }
+  ],
+  "wishlist_primary_action.button.addToCart.label": [
+    {
+      "type": 0,
+      "value": "Ajouter le "
+    },
+    {
+      "type": 1,
+      "value": "productName"
+    },
+    {
+      "type": 0,
+      "value": " au panier"
+    }
+  ],
   "wishlist_primary_action.button.add_set_to_cart": [
     {
       "type": 0,
@@ -3411,6 +3841,16 @@
       "value": "Ajouter au panier"
     }
   ],
+  "wishlist_primary_action.button.viewFullDetails.label": [
+    {
+      "type": 0,
+      "value": "Afficher tous les détails pour "
+    },
+    {
+      "type": 1,
+      "value": "productName"
+    }
+  ],
   "wishlist_primary_action.button.view_full_details": [
     {
       "type": 0,
@@ -3423,6 +3863,16 @@
       "value": "Afficher les options"
     }
   ],
+  "wishlist_primary_action.button.view_options.label": [
+    {
+      "type": 0,
+      "value": "Afficher les options pour "
+    },
+    {
+      "type": 1,
+      "value": "productName"
+    }
+  ],
   "wishlist_primary_action.info.added_to_cart": [
     {
       "type": 1,
@@ -3467,6 +3917,16 @@
       "value": "Supprimer"
     }
   ],
+  "wishlist_secondary_button_group.info.item.remove.label": [
+    {
+      "type": 0,
+      "value": "Supprimer "
+    },
+    {
+      "type": 1,
+      "value": "productName"
+    }
+  ],
   "wishlist_secondary_button_group.info.item_removed": [
     {
       "type": 0,
diff --git a/packages/template-retail-react-app/app/static/translations/compiled/it-IT.json b/packages/template-retail-react-app/app/static/translations/compiled/it-IT.json
index 73033848dd..d215e143ae 100644
--- a/packages/template-retail-react-app/app/static/translations/compiled/it-IT.json
+++ b/packages/template-retail-react-app/app/static/translations/compiled/it-IT.json
@@ -437,6 +437,16 @@
       "value": "Articolo rimosso dal carrello"
     }
   ],
+  "cart.product_edit_modal.modal_label": [
+    {
+      "type": 0,
+      "value": "Modifica modale per "
+    },
+    {
+      "type": 1,
+      "value": "productName"
+    }
+  ],
   "cart.recommended_products.title.may_also_like": [
     {
       "type": 0,
@@ -539,6 +549,12 @@
       "value": ")"
     }
   ],
+  "category_links.button_text": [
+    {
+      "type": 0,
+      "value": "Categorie"
+    }
+  ],
   "cc_radio_group.action.remove": [
     {
       "type": 0,
@@ -653,6 +669,24 @@
       "value": "Spedizione"
     }
   ],
+  "checkout_confirmation.label.shipping.strikethrough.price": [
+    {
+      "type": 0,
+      "value": "Originariamente "
+    },
+    {
+      "type": 1,
+      "value": "originalPrice"
+    },
+    {
+      "type": 0,
+      "value": ", ora "
+    },
+    {
+      "type": 1,
+      "value": "newPrice"
+    }
+  ],
   "checkout_confirmation.label.subtotal": [
     {
       "type": 0,
@@ -819,6 +853,12 @@
       "value": "Carta di credito"
     }
   ],
+  "checkout_payment.label.billing_address_form": [
+    {
+      "type": 0,
+      "value": "Modulo indirizzo di fatturazione"
+    }
+  ],
   "checkout_payment.label.same_as_shipping": [
     {
       "type": 0,
@@ -861,6 +901,18 @@
       "value": "Sì"
     }
   ],
+  "confirmation_modal.default.assistive_msg.no": [
+    {
+      "type": 0,
+      "value": "No, annulla azione"
+    }
+  ],
+  "confirmation_modal.default.assistive_msg.yes": [
+    {
+      "type": 0,
+      "value": "Sì, conferma azione"
+    }
+  ],
   "confirmation_modal.default.message.you_want_to_continue": [
     {
       "type": 0,
@@ -891,10 +943,28 @@
       "value": "Sì, rimuovi articolo"
     }
   ],
+  "confirmation_modal.remove_cart_item.assistive_msg.no": [
+    {
+      "type": 0,
+      "value": "No, conserva articolo"
+    }
+  ],
+  "confirmation_modal.remove_cart_item.assistive_msg.remove": [
+    {
+      "type": 0,
+      "value": "Rimuovi prodotti non disponibili"
+    }
+  ],
+  "confirmation_modal.remove_cart_item.assistive_msg.yes": [
+    {
+      "type": 0,
+      "value": "Sì, rimuovi articolo"
+    }
+  ],
   "confirmation_modal.remove_cart_item.message.need_to_remove_due_to_unavailability": [
     {
       "type": 0,
-      "value": "Alcuni articoli non sono più dispoinibili online e verranno rimossi dal carrello."
+      "value": "Alcuni articoli non sono più disponibili online e verranno rimossi dal carrello."
     }
   ],
   "confirmation_modal.remove_cart_item.message.sure_to_remove": [
@@ -999,6 +1069,56 @@
       "value": "Info codice di sicurezza"
     }
   ],
+  "display_price.assistive_msg.current_price": [
+    {
+      "type": 0,
+      "value": "prezzo attuale "
+    },
+    {
+      "type": 1,
+      "value": "currentPrice"
+    }
+  ],
+  "display_price.assistive_msg.current_price_with_range": [
+    {
+      "type": 0,
+      "value": "A partire dal prezzo attuale "
+    },
+    {
+      "type": 1,
+      "value": "currentPrice"
+    }
+  ],
+  "display_price.assistive_msg.strikethrough_price": [
+    {
+      "type": 0,
+      "value": "prezzo originale "
+    },
+    {
+      "type": 1,
+      "value": "listPrice"
+    }
+  ],
+  "display_price.assistive_msg.strikethrough_price_with_range": [
+    {
+      "type": 0,
+      "value": "A partire dal prezzo originale "
+    },
+    {
+      "type": 1,
+      "value": "listPrice"
+    }
+  ],
+  "display_price.label.current_price_with_range": [
+    {
+      "type": 0,
+      "value": "Da "
+    },
+    {
+      "type": 1,
+      "value": "currentPrice"
+    }
+  ],
   "drawer_menu.button.account_details": [
     {
       "type": 0,
@@ -1029,6 +1149,12 @@
       "value": "Cronologia ordini"
     }
   ],
+  "drawer_menu.header.assistive_msg.title": [
+    {
+      "type": 0,
+      "value": "Cassetto menu"
+    }
+  ],
   "drawer_menu.link.about_us": [
     {
       "type": 0,
@@ -1417,6 +1543,12 @@
       "value": "Menu"
     }
   ],
+  "header.button.assistive_msg.menu.open_dialog": [
+    {
+      "type": 0,
+      "value": "Apre una finestra di dialogo"
+    }
+  ],
   "header.button.assistive_msg.my_account": [
     {
       "type": 0,
@@ -1439,6 +1571,12 @@
       "value": "numItems"
     }
   ],
+  "header.button.assistive_msg.store_locator": [
+    {
+      "type": 0,
+      "value": "Store locator"
+    }
+  ],
   "header.button.assistive_msg.wishlist": [
     {
       "type": 0,
@@ -1649,6 +1787,12 @@
       "value": "quantity"
     }
   ],
+  "item_attributes.label.selected_options": [
+    {
+      "type": 0,
+      "value": "Opzioni selezionate"
+    }
+  ],
   "item_image.label.sale": [
     {
       "type": 0,
@@ -1661,10 +1805,32 @@
       "value": "Non disponibile"
     }
   ],
-  "item_price.label.starting_at": [
+  "item_variant.assistive_msg.quantity": [
     {
       "type": 0,
-      "value": "A partire da"
+      "value": "Quantità "
+    },
+    {
+      "type": 1,
+      "value": "quantity"
+    }
+  ],
+  "item_variant.quantity.label": [
+    {
+      "type": 0,
+      "value": "Selettore di quantità per "
+    },
+    {
+      "type": 1,
+      "value": "productName"
+    },
+    {
+      "type": 0,
+      "value": ". La quantità selezionata è "
+    },
+    {
+      "type": 1,
+      "value": "quantity"
     }
   ],
   "lCPCxk": [
@@ -2489,14 +2655,28 @@
       "value": " dalla lista desideri"
     }
   ],
-  "product_tile.label.starting_at_price": [
+  "product_tile.badge.label.new": [
     {
       "type": 0,
-      "value": "A partire da "
-    },
+      "value": "Crea"
+    }
+  ],
+  "product_tile.badge.label.sale": [
     {
-      "type": 1,
-      "value": "price"
+      "type": 0,
+      "value": "Saldi"
+    }
+  ],
+  "product_view.button.add_bundle_to_cart": [
+    {
+      "type": 0,
+      "value": "Aggiungi bundle al carrello"
+    }
+  ],
+  "product_view.button.add_bundle_to_wishlist": [
+    {
+      "type": 0,
+      "value": "Aggiungi Bundle alla Wishlist"
     }
   ],
   "product_view.button.add_set_to_cart": [
@@ -2532,13 +2712,21 @@
   "product_view.label.assistive_msg.quantity_decrement": [
     {
       "type": 0,
-      "value": "Riduci quantità"
+      "value": "Riduci quantità per "
+    },
+    {
+      "type": 1,
+      "value": "productName"
     }
   ],
   "product_view.label.assistive_msg.quantity_increment": [
     {
       "type": 0,
-      "value": "Incrementa quantità"
+      "value": "Aumenta quantità per "
+    },
+    {
+      "type": 1,
+      "value": "productName"
     }
   ],
   "product_view.label.quantity": [
@@ -2559,12 +2747,6 @@
       "value": "+"
     }
   ],
-  "product_view.label.starting_at_price": [
-    {
-      "type": 0,
-      "value": "A partire da"
-    }
-  ],
   "product_view.label.variant_type": [
     {
       "type": 1,
@@ -2771,6 +2953,32 @@
       "value": "Passa al metodo di spedizione"
     }
   ],
+  "shipping_address.label.edit_button": [
+    {
+      "type": 0,
+      "value": "Modifica "
+    },
+    {
+      "type": 1,
+      "value": "address"
+    }
+  ],
+  "shipping_address.label.remove_button": [
+    {
+      "type": 0,
+      "value": "Rimuovi "
+    },
+    {
+      "type": 1,
+      "value": "address"
+    }
+  ],
+  "shipping_address.label.shipping_address_form": [
+    {
+      "type": 0,
+      "value": "Modulo indirizzo di spedizione"
+    }
+  ],
   "shipping_address.title.shipping_address": [
     {
       "type": 0,
@@ -2861,6 +3069,144 @@
       "value": "Uscire? Per procedere con l'ordine corrente devi eseguire di nuovo l'accesso."
     }
   ],
+  "store_locator.action.find": [
+    {
+      "type": 0,
+      "value": "Trova"
+    }
+  ],
+  "store_locator.action.select_a_country": [
+    {
+      "type": 0,
+      "value": "Seleziona un Paese"
+    }
+  ],
+  "store_locator.action.use_my_location": [
+    {
+      "type": 0,
+      "value": "Usa la mia posizione"
+    }
+  ],
+  "store_locator.action.viewMore": [
+    {
+      "type": 0,
+      "value": "Visualizza altri"
+    }
+  ],
+  "store_locator.description.away": [
+    {
+      "type": 0,
+      "value": "di distanza"
+    }
+  ],
+  "store_locator.description.loading_locations": [
+    {
+      "type": 0,
+      "value": "Caricamento posizioni..."
+    }
+  ],
+  "store_locator.description.no_locations": [
+    {
+      "type": 0,
+      "value": "Siamo spiacenti, non ci sono sedi in quest'area"
+    }
+  ],
+  "store_locator.description.or": [
+    {
+      "type": 0,
+      "value": "Oppure"
+    }
+  ],
+  "store_locator.description.phone": [
+    {
+      "type": 0,
+      "value": "Telefono:"
+    }
+  ],
+  "store_locator.description.viewing_near_postal_code": [
+    {
+      "type": 0,
+      "value": "Visualizzazione dei negozi entro "
+    },
+    {
+      "type": 1,
+      "value": "distance"
+    },
+    {
+      "type": 0,
+      "value": " "
+    },
+    {
+      "type": 1,
+      "value": "distanceUnit"
+    },
+    {
+      "type": 0,
+      "value": " da "
+    },
+    {
+      "type": 1,
+      "value": "postalCode"
+    },
+    {
+      "type": 0,
+      "value": " in:"
+    }
+  ],
+  "store_locator.description.viewing_near_your_location": [
+    {
+      "type": 0,
+      "value": "Visualizzazione dei negozi vicino alla tua posizione"
+    }
+  ],
+  "store_locator.dropdown.germany": [
+    {
+      "type": 0,
+      "value": "Germania"
+    }
+  ],
+  "store_locator.dropdown.united_states": [
+    {
+      "type": 0,
+      "value": "Stati Uniti"
+    }
+  ],
+  "store_locator.error.agree_to_share_your_location": [
+    {
+      "type": 0,
+      "value": "Accetta di condividere la tua posizione"
+    }
+  ],
+  "store_locator.error.please_enter_a_postal_code": [
+    {
+      "type": 0,
+      "value": "Inserisci un codice postale."
+    }
+  ],
+  "store_locator.error.please_select_a_country": [
+    {
+      "type": 0,
+      "value": "Seleziona un Paese."
+    }
+  ],
+  "store_locator.field.placeholder.enter_postal_code": [
+    {
+      "type": 0,
+      "value": "Inserisci codice postale"
+    }
+  ],
+  "store_locator.pagination.load_more": [
+    {
+      "type": 0,
+      "value": "Carica altri"
+    }
+  ],
+  "store_locator.title": [
+    {
+      "type": 0,
+      "value": "Trova un negozio"
+    }
+  ],
   "swatch_group.selected.label": [
     {
       "type": 1,
@@ -2877,6 +3223,30 @@
       "value": "Modifica"
     }
   ],
+  "toggle_card.action.editContactInfo": [
+    {
+      "type": 0,
+      "value": "Modifica informazioni di contatto"
+    }
+  ],
+  "toggle_card.action.editPaymentInfo": [
+    {
+      "type": 0,
+      "value": "Modifica informazioni di pagamento"
+    }
+  ],
+  "toggle_card.action.editShippingAddress": [
+    {
+      "type": 0,
+      "value": "Modifica indirizzo di spedizione"
+    }
+  ],
+  "toggle_card.action.editShippingOptions": [
+    {
+      "type": 0,
+      "value": "Modifica opzioni di spedizione"
+    }
+  ],
   "update_password_fields.button.forgot_password": [
     {
       "type": 0,
@@ -2904,7 +3274,7 @@
   "use_address_fields.error.please_enter_your_postal_or_zip": [
     {
       "type": 0,
-      "value": "Inserisci il codice postale."
+      "value": "Inserisci il tuo codice postale."
     }
   ],
   "use_address_fields.error.please_select_your_address": [
@@ -2928,7 +3298,7 @@
   "use_address_fields.error.please_select_your_state_or_province": [
     {
       "type": 0,
-      "value": "Seleziona lo stato/la provincia."
+      "value": "Seleziona il tuo stato."
     }
   ],
   "use_address_fields.error.required": [
@@ -3137,12 +3507,44 @@
       "value": " rimasti!"
     }
   ],
+  "use_product.message.inventory_remaining_for_product": [
+    {
+      "type": 0,
+      "value": "Solo "
+    },
+    {
+      "type": 1,
+      "value": "stockLevel"
+    },
+    {
+      "type": 0,
+      "value": " rimasti per "
+    },
+    {
+      "type": 1,
+      "value": "productName"
+    },
+    {
+      "type": 0,
+      "value": "!"
+    }
+  ],
   "use_product.message.out_of_stock": [
     {
       "type": 0,
       "value": "Esaurito"
     }
   ],
+  "use_product.message.out_of_stock_for_product": [
+    {
+      "type": 0,
+      "value": "Esaurito per "
+    },
+    {
+      "type": 1,
+      "value": "productName"
+    }
+  ],
   "use_profile_fields.error.required_email": [
     {
       "type": 0,
@@ -3260,7 +3662,7 @@
   "use_registration_fields.error.required_password": [
     {
       "type": 0,
-      "value": "Creare una password."
+      "value": "Crea una password."
     }
   ],
   "use_registration_fields.error.special_character": [
@@ -3371,6 +3773,34 @@
       "value": "Nuova password"
     }
   ],
+  "wishlist_primary_action.button.addSetToCart.label": [
+    {
+      "type": 0,
+      "value": "Aggiungi set "
+    },
+    {
+      "type": 1,
+      "value": "productName"
+    },
+    {
+      "type": 0,
+      "value": " al carrello"
+    }
+  ],
+  "wishlist_primary_action.button.addToCart.label": [
+    {
+      "type": 0,
+      "value": "Aggiungi "
+    },
+    {
+      "type": 1,
+      "value": "productName"
+    },
+    {
+      "type": 0,
+      "value": " al carrello"
+    }
+  ],
   "wishlist_primary_action.button.add_set_to_cart": [
     {
       "type": 0,
@@ -3383,6 +3813,16 @@
       "value": "Aggiungi al carrello"
     }
   ],
+  "wishlist_primary_action.button.viewFullDetails.label": [
+    {
+      "type": 0,
+      "value": "Mostra tutti i dettagli per "
+    },
+    {
+      "type": 1,
+      "value": "productName"
+    }
+  ],
   "wishlist_primary_action.button.view_full_details": [
     {
       "type": 0,
@@ -3395,6 +3835,16 @@
       "value": "Visualizza opzioni"
     }
   ],
+  "wishlist_primary_action.button.view_options.label": [
+    {
+      "type": 0,
+      "value": "Visualizza opzioni per "
+    },
+    {
+      "type": 1,
+      "value": "productName"
+    }
+  ],
   "wishlist_primary_action.info.added_to_cart": [
     {
       "type": 1,
@@ -3439,6 +3889,16 @@
       "value": "Rimuovi"
     }
   ],
+  "wishlist_secondary_button_group.info.item.remove.label": [
+    {
+      "type": 0,
+      "value": "Rimuovi "
+    },
+    {
+      "type": 1,
+      "value": "productName"
+    }
+  ],
   "wishlist_secondary_button_group.info.item_removed": [
     {
       "type": 0,
diff --git a/packages/template-retail-react-app/app/static/translations/compiled/ja-JP.json b/packages/template-retail-react-app/app/static/translations/compiled/ja-JP.json
index 64323d1040..8cb8cf1161 100644
--- a/packages/template-retail-react-app/app/static/translations/compiled/ja-JP.json
+++ b/packages/template-retail-react-app/app/static/translations/compiled/ja-JP.json
@@ -437,6 +437,16 @@
       "value": "買い物カゴから商品が削除されました"
     }
   ],
+  "cart.product_edit_modal.modal_label": [
+    {
+      "type": 1,
+      "value": "productName"
+    },
+    {
+      "type": 0,
+      "value": " のモーダルを編集"
+    }
+  ],
   "cart.recommended_products.title.may_also_like": [
     {
       "type": 0,
@@ -539,6 +549,12 @@
       "value": ")"
     }
   ],
+  "category_links.button_text": [
+    {
+      "type": 0,
+      "value": "カテゴリ"
+    }
+  ],
   "cc_radio_group.action.remove": [
     {
       "type": 0,
@@ -653,6 +669,24 @@
       "value": "配送"
     }
   ],
+  "checkout_confirmation.label.shipping.strikethrough.price": [
+    {
+      "type": 0,
+      "value": "元の価格は "
+    },
+    {
+      "type": 1,
+      "value": "originalPrice"
+    },
+    {
+      "type": 0,
+      "value": " だが、現在は "
+    },
+    {
+      "type": 1,
+      "value": "newPrice"
+    }
+  ],
   "checkout_confirmation.label.subtotal": [
     {
       "type": 0,
@@ -819,6 +853,12 @@
       "value": "クレジットカード"
     }
   ],
+  "checkout_payment.label.billing_address_form": [
+    {
+      "type": 0,
+      "value": "請求先住所フォーム"
+    }
+  ],
   "checkout_payment.label.same_as_shipping": [
     {
       "type": 0,
@@ -861,6 +901,18 @@
       "value": "はい"
     }
   ],
+  "confirmation_modal.default.assistive_msg.no": [
+    {
+      "type": 0,
+      "value": "いいえ、操作をキャンセルします"
+    }
+  ],
+  "confirmation_modal.default.assistive_msg.yes": [
+    {
+      "type": 0,
+      "value": "はい、操作を確認します"
+    }
+  ],
   "confirmation_modal.default.message.you_want_to_continue": [
     {
       "type": 0,
@@ -891,6 +943,24 @@
       "value": "はい、商品を削除します"
     }
   ],
+  "confirmation_modal.remove_cart_item.assistive_msg.no": [
+    {
+      "type": 0,
+      "value": "いいえ、商品をキープします"
+    }
+  ],
+  "confirmation_modal.remove_cart_item.assistive_msg.remove": [
+    {
+      "type": 0,
+      "value": "入手不可の商品を削除"
+    }
+  ],
+  "confirmation_modal.remove_cart_item.assistive_msg.yes": [
+    {
+      "type": 0,
+      "value": "はい、商品を削除します"
+    }
+  ],
   "confirmation_modal.remove_cart_item.message.need_to_remove_due_to_unavailability": [
     {
       "type": 0,
@@ -999,6 +1069,64 @@
       "value": "セキュリティコード情報"
     }
   ],
+  "display_price.assistive_msg.current_price": [
+    {
+      "type": 0,
+      "value": "現在の価格 "
+    },
+    {
+      "type": 1,
+      "value": "currentPrice"
+    }
+  ],
+  "display_price.assistive_msg.current_price_with_range": [
+    {
+      "type": 0,
+      "value": "現在の価格 "
+    },
+    {
+      "type": 1,
+      "value": "currentPrice"
+    },
+    {
+      "type": 0,
+      "value": " から"
+    }
+  ],
+  "display_price.assistive_msg.strikethrough_price": [
+    {
+      "type": 0,
+      "value": "元の価格 "
+    },
+    {
+      "type": 1,
+      "value": "listPrice"
+    }
+  ],
+  "display_price.assistive_msg.strikethrough_price_with_range": [
+    {
+      "type": 0,
+      "value": "元の価格 "
+    },
+    {
+      "type": 1,
+      "value": "listPrice"
+    },
+    {
+      "type": 0,
+      "value": " から"
+    }
+  ],
+  "display_price.label.current_price_with_range": [
+    {
+      "type": 1,
+      "value": "currentPrice"
+    },
+    {
+      "type": 0,
+      "value": " から"
+    }
+  ],
   "drawer_menu.button.account_details": [
     {
       "type": 0,
@@ -1029,6 +1157,12 @@
       "value": "注文履歴"
     }
   ],
+  "drawer_menu.header.assistive_msg.title": [
+    {
+      "type": 0,
+      "value": "ドロワーメニュー"
+    }
+  ],
   "drawer_menu.link.about_us": [
     {
       "type": 0,
@@ -1413,6 +1547,12 @@
       "value": "メニュー"
     }
   ],
+  "header.button.assistive_msg.menu.open_dialog": [
+    {
+      "type": 0,
+      "value": "ダイアログを開く"
+    }
+  ],
   "header.button.assistive_msg.my_account": [
     {
       "type": 0,
@@ -1435,6 +1575,12 @@
       "value": "numItems"
     }
   ],
+  "header.button.assistive_msg.store_locator": [
+    {
+      "type": 0,
+      "value": "店舗検索"
+    }
+  ],
   "header.button.assistive_msg.wishlist": [
     {
       "type": 0,
@@ -1645,6 +1791,12 @@
       "value": "quantity"
     }
   ],
+  "item_attributes.label.selected_options": [
+    {
+      "type": 0,
+      "value": "選択したオプション"
+    }
+  ],
   "item_image.label.sale": [
     {
       "type": 0,
@@ -1657,10 +1809,32 @@
       "value": "入手不可"
     }
   ],
-  "item_price.label.starting_at": [
+  "item_variant.assistive_msg.quantity": [
+    {
+      "type": 0,
+      "value": "数量 "
+    },
+    {
+      "type": 1,
+      "value": "quantity"
+    }
+  ],
+  "item_variant.quantity.label": [
+    {
+      "type": 1,
+      "value": "productName"
+    },
+    {
+      "type": 0,
+      "value": "の数量セレクター。選択された数量は "
+    },
+    {
+      "type": 1,
+      "value": "quantity"
+    },
     {
       "type": 0,
-      "value": "最低価格"
+      "value": " です"
     }
   ],
   "lCPCxk": [
@@ -2473,14 +2647,28 @@
       "value": " をほしい物リストから削除"
     }
   ],
-  "product_tile.label.starting_at_price": [
+  "product_tile.badge.label.new": [
     {
       "type": 0,
-      "value": "最低価格: "
-    },
+      "value": "新規"
+    }
+  ],
+  "product_tile.badge.label.sale": [
     {
-      "type": 1,
-      "value": "price"
+      "type": 0,
+      "value": "セール"
+    }
+  ],
+  "product_view.button.add_bundle_to_cart": [
+    {
+      "type": 0,
+      "value": "バンドルを買い物カゴに追加"
+    }
+  ],
+  "product_view.button.add_bundle_to_wishlist": [
+    {
+      "type": 0,
+      "value": "バンドルをほしい物リストに追加"
     }
   ],
   "product_view.button.add_set_to_cart": [
@@ -2514,15 +2702,23 @@
     }
   ],
   "product_view.label.assistive_msg.quantity_decrement": [
+    {
+      "type": 1,
+      "value": "productName"
+    },
     {
       "type": 0,
-      "value": "数量を減らす"
+      "value": " の数量を減らす"
     }
   ],
   "product_view.label.assistive_msg.quantity_increment": [
+    {
+      "type": 1,
+      "value": "productName"
+    },
     {
       "type": 0,
-      "value": "数量を増やす"
+      "value": " の数量を増やす"
     }
   ],
   "product_view.label.quantity": [
@@ -2543,12 +2739,6 @@
       "value": "+"
     }
   ],
-  "product_view.label.starting_at_price": [
-    {
-      "type": 0,
-      "value": "最低価格"
-    }
-  ],
   "product_view.label.variant_type": [
     {
       "type": 1,
@@ -2682,7 +2872,7 @@
     },
     {
       "type": 0,
-      "value": "にご同意いただいたものと見なされます"
+      "value": "にご同意いただいたものと見なされます。"
     }
   ],
   "register_form.message.already_have_account": [
@@ -2783,6 +2973,32 @@
       "value": "配送方法に進む"
     }
   ],
+  "shipping_address.label.edit_button": [
+    {
+      "type": 1,
+      "value": "address"
+    },
+    {
+      "type": 0,
+      "value": " の編集"
+    }
+  ],
+  "shipping_address.label.remove_button": [
+    {
+      "type": 1,
+      "value": "address"
+    },
+    {
+      "type": 0,
+      "value": " の削除"
+    }
+  ],
+  "shipping_address.label.shipping_address_form": [
+    {
+      "type": 0,
+      "value": "配送先住所フォーム"
+    }
+  ],
   "shipping_address.title.shipping_address": [
     {
       "type": 0,
@@ -2873,6 +3089,140 @@
       "value": "サインアウトしますか?現在のご注文を処理するには、再度サインインする必要があります。"
     }
   ],
+  "store_locator.action.find": [
+    {
+      "type": 0,
+      "value": "検索"
+    }
+  ],
+  "store_locator.action.select_a_country": [
+    {
+      "type": 0,
+      "value": "国を選択してください"
+    }
+  ],
+  "store_locator.action.use_my_location": [
+    {
+      "type": 0,
+      "value": "現在地を使用"
+    }
+  ],
+  "store_locator.action.viewMore": [
+    {
+      "type": 0,
+      "value": "もっと見る"
+    }
+  ],
+  "store_locator.description.away": [
+    {
+      "type": 0,
+      "value": "の距離"
+    }
+  ],
+  "store_locator.description.loading_locations": [
+    {
+      "type": 0,
+      "value": "位置情報を読み込んでいます..."
+    }
+  ],
+  "store_locator.description.no_locations": [
+    {
+      "type": 0,
+      "value": "申し訳ございませんが、このエリアには店舗がありません"
+    }
+  ],
+  "store_locator.description.or": [
+    {
+      "type": 0,
+      "value": "または"
+    }
+  ],
+  "store_locator.description.phone": [
+    {
+      "type": 0,
+      "value": "電話:"
+    }
+  ],
+  "store_locator.description.viewing_near_postal_code": [
+    {
+      "type": 0,
+      "value": "次の "
+    },
+    {
+      "type": 1,
+      "value": "postalCode"
+    },
+    {
+      "type": 0,
+      "value": " から "
+    },
+    {
+      "type": 1,
+      "value": "distance"
+    },
+    {
+      "type": 1,
+      "value": "distanceUnit"
+    },
+    {
+      "type": 0,
+      "value": " 以内の店舗を表示しています: "
+    }
+  ],
+  "store_locator.description.viewing_near_your_location": [
+    {
+      "type": 0,
+      "value": "現在地の近くの店舗を表示しています"
+    }
+  ],
+  "store_locator.dropdown.germany": [
+    {
+      "type": 0,
+      "value": "ドイツ"
+    }
+  ],
+  "store_locator.dropdown.united_states": [
+    {
+      "type": 0,
+      "value": "米国"
+    }
+  ],
+  "store_locator.error.agree_to_share_your_location": [
+    {
+      "type": 0,
+      "value": "現在地を共有することに同意してください"
+    }
+  ],
+  "store_locator.error.please_enter_a_postal_code": [
+    {
+      "type": 0,
+      "value": "郵便番号を入力してください。"
+    }
+  ],
+  "store_locator.error.please_select_a_country": [
+    {
+      "type": 0,
+      "value": "国を選択してください。"
+    }
+  ],
+  "store_locator.field.placeholder.enter_postal_code": [
+    {
+      "type": 0,
+      "value": "郵便番号を入力してください"
+    }
+  ],
+  "store_locator.pagination.load_more": [
+    {
+      "type": 0,
+      "value": "さらに読み込む"
+    }
+  ],
+  "store_locator.title": [
+    {
+      "type": 0,
+      "value": "店舗の検索"
+    }
+  ],
   "swatch_group.selected.label": [
     {
       "type": 1,
@@ -2889,6 +3239,30 @@
       "value": "編集"
     }
   ],
+  "toggle_card.action.editContactInfo": [
+    {
+      "type": 0,
+      "value": "連絡先情報の編集"
+    }
+  ],
+  "toggle_card.action.editPaymentInfo": [
+    {
+      "type": 0,
+      "value": "支払情報の編集"
+    }
+  ],
+  "toggle_card.action.editShippingAddress": [
+    {
+      "type": 0,
+      "value": "配送先住所の編集"
+    }
+  ],
+  "toggle_card.action.editShippingOptions": [
+    {
+      "type": 0,
+      "value": "配送オプションの編集"
+    }
+  ],
   "update_password_fields.button.forgot_password": [
     {
       "type": 0,
@@ -3146,7 +3520,25 @@
     },
     {
       "type": 0,
-      "value": " 点!"
+      "value": " 点のみ!"
+    }
+  ],
+  "use_product.message.inventory_remaining_for_product": [
+    {
+      "type": 1,
+      "value": "productName"
+    },
+    {
+      "type": 0,
+      "value": " は残り "
+    },
+    {
+      "type": 1,
+      "value": "stockLevel"
+    },
+    {
+      "type": 0,
+      "value": " 点のみ!"
     }
   ],
   "use_product.message.out_of_stock": [
@@ -3155,6 +3547,16 @@
       "value": "在庫切れ"
     }
   ],
+  "use_product.message.out_of_stock_for_product": [
+    {
+      "type": 1,
+      "value": "productName"
+    },
+    {
+      "type": 0,
+      "value": " は在庫切れです"
+    }
+  ],
   "use_profile_fields.error.required_email": [
     {
       "type": 0,
@@ -3383,6 +3785,26 @@
       "value": "新しいパスワード:"
     }
   ],
+  "wishlist_primary_action.button.addSetToCart.label": [
+    {
+      "type": 1,
+      "value": "productName"
+    },
+    {
+      "type": 0,
+      "value": " のセットを買い物カゴに追加"
+    }
+  ],
+  "wishlist_primary_action.button.addToCart.label": [
+    {
+      "type": 1,
+      "value": "productName"
+    },
+    {
+      "type": 0,
+      "value": " を買い物カゴに追加"
+    }
+  ],
   "wishlist_primary_action.button.add_set_to_cart": [
     {
       "type": 0,
@@ -3395,6 +3817,16 @@
       "value": "買い物カゴに追加"
     }
   ],
+  "wishlist_primary_action.button.viewFullDetails.label": [
+    {
+      "type": 1,
+      "value": "productName"
+    },
+    {
+      "type": 0,
+      "value": " の詳細を表示"
+    }
+  ],
   "wishlist_primary_action.button.view_full_details": [
     {
       "type": 0,
@@ -3407,6 +3839,16 @@
       "value": "オプションを表示"
     }
   ],
+  "wishlist_primary_action.button.view_options.label": [
+    {
+      "type": 1,
+      "value": "productName"
+    },
+    {
+      "type": 0,
+      "value": " のオプションを表示"
+    }
+  ],
   "wishlist_primary_action.info.added_to_cart": [
     {
       "type": 1,
@@ -3451,6 +3893,16 @@
       "value": "削除"
     }
   ],
+  "wishlist_secondary_button_group.info.item.remove.label": [
+    {
+      "type": 1,
+      "value": "productName"
+    },
+    {
+      "type": 0,
+      "value": " の削除"
+    }
+  ],
   "wishlist_secondary_button_group.info.item_removed": [
     {
       "type": 0,
diff --git a/packages/template-retail-react-app/app/static/translations/compiled/ko-KR.json b/packages/template-retail-react-app/app/static/translations/compiled/ko-KR.json
index f0f158630c..6cce9d5bd6 100644
--- a/packages/template-retail-react-app/app/static/translations/compiled/ko-KR.json
+++ b/packages/template-retail-react-app/app/static/translations/compiled/ko-KR.json
@@ -429,6 +429,16 @@
       "value": "항목이 카트에서 제거됨"
     }
   ],
+  "cart.product_edit_modal.modal_label": [
+    {
+      "type": 1,
+      "value": "productName"
+    },
+    {
+      "type": 0,
+      "value": "에 대한 모달 편집"
+    }
+  ],
   "cart.recommended_products.title.may_also_like": [
     {
       "type": 0,
@@ -531,6 +541,12 @@
       "value": ")"
     }
   ],
+  "category_links.button_text": [
+    {
+      "type": 0,
+      "value": "카테고리"
+    }
+  ],
   "cc_radio_group.action.remove": [
     {
       "type": 0,
@@ -645,6 +661,24 @@
       "value": "배송"
     }
   ],
+  "checkout_confirmation.label.shipping.strikethrough.price": [
+    {
+      "type": 0,
+      "value": "원래 가격: "
+    },
+    {
+      "type": 1,
+      "value": "originalPrice"
+    },
+    {
+      "type": 0,
+      "value": " , 현재 가격: "
+    },
+    {
+      "type": 1,
+      "value": "newPrice"
+    }
+  ],
   "checkout_confirmation.label.subtotal": [
     {
       "type": 0,
@@ -807,6 +841,12 @@
       "value": "신용카드"
     }
   ],
+  "checkout_payment.label.billing_address_form": [
+    {
+      "type": 0,
+      "value": "청구 주소 양식"
+    }
+  ],
   "checkout_payment.label.same_as_shipping": [
     {
       "type": 0,
@@ -849,6 +889,18 @@
       "value": "예"
     }
   ],
+  "confirmation_modal.default.assistive_msg.no": [
+    {
+      "type": 0,
+      "value": "아니요, 작업을 취소합니다."
+    }
+  ],
+  "confirmation_modal.default.assistive_msg.yes": [
+    {
+      "type": 0,
+      "value": "예, 작업을 확인합니다"
+    }
+  ],
   "confirmation_modal.default.message.you_want_to_continue": [
     {
       "type": 0,
@@ -879,6 +931,24 @@
       "value": "예. 항목을 제거합니다."
     }
   ],
+  "confirmation_modal.remove_cart_item.assistive_msg.no": [
+    {
+      "type": 0,
+      "value": "아니요. 항목을 그대로 둡니다."
+    }
+  ],
+  "confirmation_modal.remove_cart_item.assistive_msg.remove": [
+    {
+      "type": 0,
+      "value": "사용할 수 없는 제품 제거"
+    }
+  ],
+  "confirmation_modal.remove_cart_item.assistive_msg.yes": [
+    {
+      "type": 0,
+      "value": "예. 항목을 제거합니다."
+    }
+  ],
   "confirmation_modal.remove_cart_item.message.need_to_remove_due_to_unavailability": [
     {
       "type": 0,
@@ -987,6 +1057,64 @@
       "value": "보안 코드 정보"
     }
   ],
+  "display_price.assistive_msg.current_price": [
+    {
+      "type": 0,
+      "value": "현재 가격 "
+    },
+    {
+      "type": 1,
+      "value": "currentPrice"
+    }
+  ],
+  "display_price.assistive_msg.current_price_with_range": [
+    {
+      "type": 0,
+      "value": "현재 가격 "
+    },
+    {
+      "type": 1,
+      "value": "currentPrice"
+    },
+    {
+      "type": 0,
+      "value": "에서"
+    }
+  ],
+  "display_price.assistive_msg.strikethrough_price": [
+    {
+      "type": 0,
+      "value": "원래 가격 "
+    },
+    {
+      "type": 1,
+      "value": "listPrice"
+    }
+  ],
+  "display_price.assistive_msg.strikethrough_price_with_range": [
+    {
+      "type": 0,
+      "value": "원래 가격 "
+    },
+    {
+      "type": 1,
+      "value": "listPrice"
+    },
+    {
+      "type": 0,
+      "value": "에서"
+    }
+  ],
+  "display_price.label.current_price_with_range": [
+    {
+      "type": 1,
+      "value": "currentPrice"
+    },
+    {
+      "type": 0,
+      "value": "부터 시작"
+    }
+  ],
   "drawer_menu.button.account_details": [
     {
       "type": 0,
@@ -1017,6 +1145,12 @@
       "value": "주문 내역"
     }
   ],
+  "drawer_menu.header.assistive_msg.title": [
+    {
+      "type": 0,
+      "value": "메뉴 서랍"
+    }
+  ],
   "drawer_menu.link.about_us": [
     {
       "type": 0,
@@ -1393,6 +1527,12 @@
       "value": "메뉴"
     }
   ],
+  "header.button.assistive_msg.menu.open_dialog": [
+    {
+      "type": 0,
+      "value": "대화창 열기"
+    }
+  ],
   "header.button.assistive_msg.my_account": [
     {
       "type": 0,
@@ -1415,6 +1555,12 @@
       "value": "numItems"
     }
   ],
+  "header.button.assistive_msg.store_locator": [
+    {
+      "type": 0,
+      "value": "매장 찾기"
+    }
+  ],
   "header.button.assistive_msg.wishlist": [
     {
       "type": 0,
@@ -1625,6 +1771,12 @@
       "value": "quantity"
     }
   ],
+  "item_attributes.label.selected_options": [
+    {
+      "type": 0,
+      "value": "선택한 옵션"
+    }
+  ],
   "item_image.label.sale": [
     {
       "type": 0,
@@ -1637,10 +1789,32 @@
       "value": "사용 불가"
     }
   ],
-  "item_price.label.starting_at": [
+  "item_variant.assistive_msg.quantity": [
     {
       "type": 0,
-      "value": "시작가"
+      "value": "수량 "
+    },
+    {
+      "type": 1,
+      "value": "quantity"
+    }
+  ],
+  "item_variant.quantity.label": [
+    {
+      "type": 1,
+      "value": "productName"
+    },
+    {
+      "type": 0,
+      "value": "에 대한 수량 선택기 선택한 수량은 "
+    },
+    {
+      "type": 1,
+      "value": "quantity"
+    },
+    {
+      "type": 0,
+      "value": "개입니다."
     }
   ],
   "lCPCxk": [
@@ -2465,14 +2639,28 @@
       "value": " 제거"
     }
   ],
-  "product_tile.label.starting_at_price": [
+  "product_tile.badge.label.new": [
     {
       "type": 0,
-      "value": "시작가: "
-    },
+      "value": "신규"
+    }
+  ],
+  "product_tile.badge.label.sale": [
     {
-      "type": 1,
-      "value": "price"
+      "type": 0,
+      "value": "판매"
+    }
+  ],
+  "product_view.button.add_bundle_to_cart": [
+    {
+      "type": 0,
+      "value": "카트에 번들 추가"
+    }
+  ],
+  "product_view.button.add_bundle_to_wishlist": [
+    {
+      "type": 0,
+      "value": "위시리스트에 번들 추가"
     }
   ],
   "product_view.button.add_set_to_cart": [
@@ -2506,15 +2694,23 @@
     }
   ],
   "product_view.label.assistive_msg.quantity_decrement": [
+    {
+      "type": 1,
+      "value": "productName"
+    },
     {
       "type": 0,
-      "value": "수량 줄이기"
+      "value": "의 감소 수량"
     }
   ],
   "product_view.label.assistive_msg.quantity_increment": [
+    {
+      "type": 1,
+      "value": "productName"
+    },
     {
       "type": 0,
-      "value": "수량 늘리기"
+      "value": "에 대한 증분 수량"
     }
   ],
   "product_view.label.quantity": [
@@ -2535,12 +2731,6 @@
       "value": "+"
     }
   ],
-  "product_view.label.starting_at_price": [
-    {
-      "type": 0,
-      "value": "시작가"
-    }
-  ],
   "product_view.label.variant_type": [
     {
       "type": 1,
@@ -2652,7 +2842,7 @@
       "children": [
         {
           "type": 0,
-          "value": "개인정보보호 정책"
+          "value": "개인정보 보호정책"
         }
       ],
       "type": 8,
@@ -2660,13 +2850,13 @@
     },
     {
       "type": 0,
-      "value": "과 "
+      "value": " 및 "
     },
     {
       "children": [
         {
           "type": 0,
-          "value": "이용 약관"
+          "value": "약관"
         }
       ],
       "type": 8,
@@ -2674,7 +2864,7 @@
     },
     {
       "type": 0,
-      "value": "에 동의한 것으로 간주됩니다."
+      "value": "에 동의하는 것입니다."
     }
   ],
   "register_form.message.already_have_account": [
@@ -2771,6 +2961,32 @@
       "value": "배송 방법으로 계속 진행하기"
     }
   ],
+  "shipping_address.label.edit_button": [
+    {
+      "type": 1,
+      "value": "address"
+    },
+    {
+      "type": 0,
+      "value": " 편집"
+    }
+  ],
+  "shipping_address.label.remove_button": [
+    {
+      "type": 1,
+      "value": "address"
+    },
+    {
+      "type": 0,
+      "value": " 제거"
+    }
+  ],
+  "shipping_address.label.shipping_address_form": [
+    {
+      "type": 0,
+      "value": "배송 주소 양식"
+    }
+  ],
   "shipping_address.title.shipping_address": [
     {
       "type": 0,
@@ -2861,6 +3077,136 @@
       "value": "로그아웃하시겠습니까? 현재 주문을 처리하려면 다시 로그인해야 합니다."
     }
   ],
+  "store_locator.action.find": [
+    {
+      "type": 0,
+      "value": "찾기"
+    }
+  ],
+  "store_locator.action.select_a_country": [
+    {
+      "type": 0,
+      "value": "국가 선택"
+    }
+  ],
+  "store_locator.action.use_my_location": [
+    {
+      "type": 0,
+      "value": "내 위치 사용"
+    }
+  ],
+  "store_locator.action.viewMore": [
+    {
+      "type": 0,
+      "value": "자세히 보기"
+    }
+  ],
+  "store_locator.description.away": [
+    {
+      "type": 0,
+      "value": "떨어진 곳에 위치"
+    }
+  ],
+  "store_locator.description.loading_locations": [
+    {
+      "type": 0,
+      "value": "위치 로드 중..."
+    }
+  ],
+  "store_locator.description.no_locations": [
+    {
+      "type": 0,
+      "value": "죄송하지만 이 지역에는 위치가 없습니다."
+    }
+  ],
+  "store_locator.description.or": [
+    {
+      "type": 0,
+      "value": "Or"
+    }
+  ],
+  "store_locator.description.phone": [
+    {
+      "type": 0,
+      "value": "전화번호:"
+    }
+  ],
+  "store_locator.description.viewing_near_postal_code": [
+    {
+      "type": 1,
+      "value": "postalCode"
+    },
+    {
+      "type": 0,
+      "value": "에서 "
+    },
+    {
+      "type": 1,
+      "value": "distance"
+    },
+    {
+      "type": 1,
+      "value": "distanceUnit"
+    },
+    {
+      "type": 0,
+      "value": " 내에 위치한 매장 보기"
+    }
+  ],
+  "store_locator.description.viewing_near_your_location": [
+    {
+      "type": 0,
+      "value": "현재 위치에서 가까운 매장 보기"
+    }
+  ],
+  "store_locator.dropdown.germany": [
+    {
+      "type": 0,
+      "value": "독일"
+    }
+  ],
+  "store_locator.dropdown.united_states": [
+    {
+      "type": 0,
+      "value": "미국"
+    }
+  ],
+  "store_locator.error.agree_to_share_your_location": [
+    {
+      "type": 0,
+      "value": "위치 공유에 동의하십시오."
+    }
+  ],
+  "store_locator.error.please_enter_a_postal_code": [
+    {
+      "type": 0,
+      "value": "우편번호를 입력해 주세요."
+    }
+  ],
+  "store_locator.error.please_select_a_country": [
+    {
+      "type": 0,
+      "value": "국가를 선택하십시오."
+    }
+  ],
+  "store_locator.field.placeholder.enter_postal_code": [
+    {
+      "type": 0,
+      "value": "우편번호 입력"
+    }
+  ],
+  "store_locator.pagination.load_more": [
+    {
+      "type": 0,
+      "value": "추가 로드"
+    }
+  ],
+  "store_locator.title": [
+    {
+      "type": 0,
+      "value": "매장 찾기"
+    }
+  ],
   "swatch_group.selected.label": [
     {
       "type": 1,
@@ -2877,6 +3223,30 @@
       "value": "편집"
     }
   ],
+  "toggle_card.action.editContactInfo": [
+    {
+      "type": 0,
+      "value": "연락처 정보 편집"
+    }
+  ],
+  "toggle_card.action.editPaymentInfo": [
+    {
+      "type": 0,
+      "value": "결제 정보 편집"
+    }
+  ],
+  "toggle_card.action.editShippingAddress": [
+    {
+      "type": 0,
+      "value": "배송 주소 편집"
+    }
+  ],
+  "toggle_card.action.editShippingOptions": [
+    {
+      "type": 0,
+      "value": "배송 옵션 편집"
+    }
+  ],
   "update_password_fields.button.forgot_password": [
     {
       "type": 0,
@@ -2928,7 +3298,7 @@
   "use_address_fields.error.please_select_your_state_or_province": [
     {
       "type": 0,
-      "value": "시/도를 선택하십시오."
+      "value": "주를 선택하십시오."
     }
   ],
   "use_address_fields.error.required": [
@@ -3137,12 +3507,40 @@
       "value": "개 남음)"
     }
   ],
+  "use_product.message.inventory_remaining_for_product": [
+    {
+      "type": 1,
+      "value": "productName"
+    },
+    {
+      "type": 0,
+      "value": "이(가) "
+    },
+    {
+      "type": 1,
+      "value": "stockLevel"
+    },
+    {
+      "type": 0,
+      "value": "개 남았습니다!"
+    }
+  ],
   "use_product.message.out_of_stock": [
     {
       "type": 0,
       "value": "품절"
     }
   ],
+  "use_product.message.out_of_stock_for_product": [
+    {
+      "type": 1,
+      "value": "productName"
+    },
+    {
+      "type": 0,
+      "value": "이(가) 품절입니다."
+    }
+  ],
   "use_profile_fields.error.required_email": [
     {
       "type": 0,
@@ -3371,6 +3769,34 @@
       "value": "새 암호"
     }
   ],
+  "wishlist_primary_action.button.addSetToCart.label": [
+    {
+      "type": 0,
+      "value": "카트에 "
+    },
+    {
+      "type": 1,
+      "value": "productName"
+    },
+    {
+      "type": 0,
+      "value": " 세트 추가"
+    }
+  ],
+  "wishlist_primary_action.button.addToCart.label": [
+    {
+      "type": 0,
+      "value": "카트에 "
+    },
+    {
+      "type": 1,
+      "value": "productName"
+    },
+    {
+      "type": 0,
+      "value": " 추가"
+    }
+  ],
   "wishlist_primary_action.button.add_set_to_cart": [
     {
       "type": 0,
@@ -3383,6 +3809,16 @@
       "value": "카트에 추가"
     }
   ],
+  "wishlist_primary_action.button.viewFullDetails.label": [
+    {
+      "type": 1,
+      "value": "productName"
+    },
+    {
+      "type": 0,
+      "value": "에 대한 전체 세부 정보 보기"
+    }
+  ],
   "wishlist_primary_action.button.view_full_details": [
     {
       "type": 0,
@@ -3395,6 +3831,16 @@
       "value": "옵션 보기"
     }
   ],
+  "wishlist_primary_action.button.view_options.label": [
+    {
+      "type": 1,
+      "value": "productName"
+    },
+    {
+      "type": 0,
+      "value": "에 대한 보기 옵션"
+    }
+  ],
   "wishlist_primary_action.info.added_to_cart": [
     {
       "type": 1,
@@ -3439,6 +3885,16 @@
       "value": "제거"
     }
   ],
+  "wishlist_secondary_button_group.info.item.remove.label": [
+    {
+      "type": 1,
+      "value": "productName"
+    },
+    {
+      "type": 0,
+      "value": " 제거"
+    }
+  ],
   "wishlist_secondary_button_group.info.item_removed": [
     {
       "type": 0,
diff --git a/packages/template-retail-react-app/app/static/translations/compiled/pt-BR.json b/packages/template-retail-react-app/app/static/translations/compiled/pt-BR.json
index bd59d8c0c6..7a5bc4adde 100644
--- a/packages/template-retail-react-app/app/static/translations/compiled/pt-BR.json
+++ b/packages/template-retail-react-app/app/static/translations/compiled/pt-BR.json
@@ -437,6 +437,16 @@
       "value": "Item removido do carrinho"
     }
   ],
+  "cart.product_edit_modal.modal_label": [
+    {
+      "type": 0,
+      "value": "Editar modal para "
+    },
+    {
+      "type": 1,
+      "value": "productName"
+    }
+  ],
   "cart.recommended_products.title.may_also_like": [
     {
       "type": 0,
@@ -539,6 +549,12 @@
       "value": ")"
     }
   ],
+  "category_links.button_text": [
+    {
+      "type": 0,
+      "value": "Categorias"
+    }
+  ],
   "cc_radio_group.action.remove": [
     {
       "type": 0,
@@ -653,6 +669,24 @@
       "value": "Frete"
     }
   ],
+  "checkout_confirmation.label.shipping.strikethrough.price": [
+    {
+      "type": 0,
+      "value": "Originalmente "
+    },
+    {
+      "type": 1,
+      "value": "originalPrice"
+    },
+    {
+      "type": 0,
+      "value": ", agora "
+    },
+    {
+      "type": 1,
+      "value": "newPrice"
+    }
+  ],
   "checkout_confirmation.label.subtotal": [
     {
       "type": 0,
@@ -823,6 +857,12 @@
       "value": "Cartão de crédito"
     }
   ],
+  "checkout_payment.label.billing_address_form": [
+    {
+      "type": 0,
+      "value": "Formulário de endereço para faturamento"
+    }
+  ],
   "checkout_payment.label.same_as_shipping": [
     {
       "type": 0,
@@ -865,6 +905,18 @@
       "value": "Sim"
     }
   ],
+  "confirmation_modal.default.assistive_msg.no": [
+    {
+      "type": 0,
+      "value": "Não, cancelar ação"
+    }
+  ],
+  "confirmation_modal.default.assistive_msg.yes": [
+    {
+      "type": 0,
+      "value": "Sim, confirmar ação"
+    }
+  ],
   "confirmation_modal.default.message.you_want_to_continue": [
     {
       "type": 0,
@@ -895,6 +947,24 @@
       "value": "Sim, remover item"
     }
   ],
+  "confirmation_modal.remove_cart_item.assistive_msg.no": [
+    {
+      "type": 0,
+      "value": "Não, manter item"
+    }
+  ],
+  "confirmation_modal.remove_cart_item.assistive_msg.remove": [
+    {
+      "type": 0,
+      "value": "Remover produtos indisponíveis"
+    }
+  ],
+  "confirmation_modal.remove_cart_item.assistive_msg.yes": [
+    {
+      "type": 0,
+      "value": "Sim, remover item"
+    }
+  ],
   "confirmation_modal.remove_cart_item.message.need_to_remove_due_to_unavailability": [
     {
       "type": 0,
@@ -1003,6 +1073,56 @@
       "value": "Informações do código de segurança"
     }
   ],
+  "display_price.assistive_msg.current_price": [
+    {
+      "type": 0,
+      "value": "preço atual "
+    },
+    {
+      "type": 1,
+      "value": "currentPrice"
+    }
+  ],
+  "display_price.assistive_msg.current_price_with_range": [
+    {
+      "type": 0,
+      "value": "A partir do preço atual "
+    },
+    {
+      "type": 1,
+      "value": "currentPrice"
+    }
+  ],
+  "display_price.assistive_msg.strikethrough_price": [
+    {
+      "type": 0,
+      "value": "preço original "
+    },
+    {
+      "type": 1,
+      "value": "listPrice"
+    }
+  ],
+  "display_price.assistive_msg.strikethrough_price_with_range": [
+    {
+      "type": 0,
+      "value": "A partir do preço original "
+    },
+    {
+      "type": 1,
+      "value": "listPrice"
+    }
+  ],
+  "display_price.label.current_price_with_range": [
+    {
+      "type": 0,
+      "value": "De "
+    },
+    {
+      "type": 1,
+      "value": "currentPrice"
+    }
+  ],
   "drawer_menu.button.account_details": [
     {
       "type": 0,
@@ -1033,6 +1153,12 @@
       "value": "Histórico de pedidos"
     }
   ],
+  "drawer_menu.header.assistive_msg.title": [
+    {
+      "type": 0,
+      "value": "Gaveta de menu"
+    }
+  ],
   "drawer_menu.link.about_us": [
     {
       "type": 0,
@@ -1048,7 +1174,7 @@
   "drawer_menu.link.customer_support.contact_us": [
     {
       "type": 0,
-      "value": "Entrar em contato"
+      "value": "Entre em contato"
     }
   ],
   "drawer_menu.link.customer_support.shipping_and_returns": [
@@ -1421,6 +1547,12 @@
       "value": "Menu"
     }
   ],
+  "header.button.assistive_msg.menu.open_dialog": [
+    {
+      "type": 0,
+      "value": "Abre uma caixa de diálogo"
+    }
+  ],
   "header.button.assistive_msg.my_account": [
     {
       "type": 0,
@@ -1443,6 +1575,12 @@
       "value": "numItems"
     }
   ],
+  "header.button.assistive_msg.store_locator": [
+    {
+      "type": 0,
+      "value": "Localizador de lojas"
+    }
+  ],
   "header.button.assistive_msg.wishlist": [
     {
       "type": 0,
@@ -1653,6 +1791,12 @@
       "value": "quantity"
     }
   ],
+  "item_attributes.label.selected_options": [
+    {
+      "type": 0,
+      "value": "Opções selecionadas"
+    }
+  ],
   "item_image.label.sale": [
     {
       "type": 0,
@@ -1665,10 +1809,32 @@
       "value": "Indisponível"
     }
   ],
-  "item_price.label.starting_at": [
+  "item_variant.assistive_msg.quantity": [
     {
       "type": 0,
-      "value": "A partir de"
+      "value": "Quantidade "
+    },
+    {
+      "type": 1,
+      "value": "quantity"
+    }
+  ],
+  "item_variant.quantity.label": [
+    {
+      "type": 0,
+      "value": "Seletor de quantidade para "
+    },
+    {
+      "type": 1,
+      "value": "productName"
+    },
+    {
+      "type": 0,
+      "value": ". A quantidade selecionada é "
+    },
+    {
+      "type": 1,
+      "value": "quantity"
     }
   ],
   "lCPCxk": [
@@ -2493,14 +2659,28 @@
       "value": " da lista de desejos"
     }
   ],
-  "product_tile.label.starting_at_price": [
+  "product_tile.badge.label.new": [
     {
       "type": 0,
-      "value": "A partir de "
-    },
+      "value": "Criar"
+    }
+  ],
+  "product_tile.badge.label.sale": [
     {
-      "type": 1,
-      "value": "price"
+      "type": 0,
+      "value": "Promoção"
+    }
+  ],
+  "product_view.button.add_bundle_to_cart": [
+    {
+      "type": 0,
+      "value": "Adicionar pacote ao carrinho"
+    }
+  ],
+  "product_view.button.add_bundle_to_wishlist": [
+    {
+      "type": 0,
+      "value": "Adicionar pacote à lista de desejos"
     }
   ],
   "product_view.button.add_set_to_cart": [
@@ -2536,13 +2716,21 @@
   "product_view.label.assistive_msg.quantity_decrement": [
     {
       "type": 0,
-      "value": "Quantidade de decremento"
+      "value": "Quantidade em decremento para "
+    },
+    {
+      "type": 1,
+      "value": "productName"
     }
   ],
   "product_view.label.assistive_msg.quantity_increment": [
     {
       "type": 0,
-      "value": "Quantidade de incremento"
+      "value": "Quantidade em incremento para "
+    },
+    {
+      "type": 1,
+      "value": "productName"
     }
   ],
   "product_view.label.quantity": [
@@ -2563,12 +2751,6 @@
       "value": "+"
     }
   ],
-  "product_view.label.starting_at_price": [
-    {
-      "type": 0,
-      "value": "A partir de"
-    }
-  ],
   "product_view.label.variant_type": [
     {
       "type": 1,
@@ -2803,6 +2985,32 @@
       "value": "Ir ao método de entrega"
     }
   ],
+  "shipping_address.label.edit_button": [
+    {
+      "type": 0,
+      "value": "Editar "
+    },
+    {
+      "type": 1,
+      "value": "address"
+    }
+  ],
+  "shipping_address.label.remove_button": [
+    {
+      "type": 0,
+      "value": "Remover "
+    },
+    {
+      "type": 1,
+      "value": "address"
+    }
+  ],
+  "shipping_address.label.shipping_address_form": [
+    {
+      "type": 0,
+      "value": "Formulário de endereço de entrega"
+    }
+  ],
   "shipping_address.title.shipping_address": [
     {
       "type": 0,
@@ -2893,6 +3101,140 @@
       "value": "Tem certeza de que deseja fazer logout? Será preciso fazer logon novamente para dar continuidade ao seu pedido atual."
     }
   ],
+  "store_locator.action.find": [
+    {
+      "type": 0,
+      "value": "Localizar"
+    }
+  ],
+  "store_locator.action.select_a_country": [
+    {
+      "type": 0,
+      "value": "Selecione um país"
+    }
+  ],
+  "store_locator.action.use_my_location": [
+    {
+      "type": 0,
+      "value": "Utilizar a minha localização"
+    }
+  ],
+  "store_locator.action.viewMore": [
+    {
+      "type": 0,
+      "value": "Ver mais"
+    }
+  ],
+  "store_locator.description.away": [
+    {
+      "type": 0,
+      "value": "de distância"
+    }
+  ],
+  "store_locator.description.loading_locations": [
+    {
+      "type": 0,
+      "value": "Carregando localizações..."
+    }
+  ],
+  "store_locator.description.no_locations": [
+    {
+      "type": 0,
+      "value": "Desculpe, não há localizações nesta área"
+    }
+  ],
+  "store_locator.description.or": [
+    {
+      "type": 0,
+      "value": "Ou"
+    }
+  ],
+  "store_locator.description.phone": [
+    {
+      "type": 0,
+      "value": "Telefone:"
+    }
+  ],
+  "store_locator.description.viewing_near_postal_code": [
+    {
+      "type": 0,
+      "value": "Visualizando lojas dentro de "
+    },
+    {
+      "type": 1,
+      "value": "distance"
+    },
+    {
+      "type": 1,
+      "value": "distanceUnit"
+    },
+    {
+      "type": 0,
+      "value": " de "
+    },
+    {
+      "type": 1,
+      "value": "postalCode"
+    },
+    {
+      "type": 0,
+      "value": " em"
+    }
+  ],
+  "store_locator.description.viewing_near_your_location": [
+    {
+      "type": 0,
+      "value": "Ver lojas perto da sua localização"
+    }
+  ],
+  "store_locator.dropdown.germany": [
+    {
+      "type": 0,
+      "value": "Alemanha"
+    }
+  ],
+  "store_locator.dropdown.united_states": [
+    {
+      "type": 0,
+      "value": "Estados Unidos"
+    }
+  ],
+  "store_locator.error.agree_to_share_your_location": [
+    {
+      "type": 0,
+      "value": "Aceite compartilhar sua localização"
+    }
+  ],
+  "store_locator.error.please_enter_a_postal_code": [
+    {
+      "type": 0,
+      "value": "Insira um código postal."
+    }
+  ],
+  "store_locator.error.please_select_a_country": [
+    {
+      "type": 0,
+      "value": "Selecione um país."
+    }
+  ],
+  "store_locator.field.placeholder.enter_postal_code": [
+    {
+      "type": 0,
+      "value": "Inserir código postal"
+    }
+  ],
+  "store_locator.pagination.load_more": [
+    {
+      "type": 0,
+      "value": "Carregar mais"
+    }
+  ],
+  "store_locator.title": [
+    {
+      "type": 0,
+      "value": "Encontre uma loja"
+    }
+  ],
   "swatch_group.selected.label": [
     {
       "type": 1,
@@ -2909,6 +3251,30 @@
       "value": "Editar"
     }
   ],
+  "toggle_card.action.editContactInfo": [
+    {
+      "type": 0,
+      "value": "Editar informações de contato"
+    }
+  ],
+  "toggle_card.action.editPaymentInfo": [
+    {
+      "type": 0,
+      "value": "Editar informações de pagamento"
+    }
+  ],
+  "toggle_card.action.editShippingAddress": [
+    {
+      "type": 0,
+      "value": "Editar endereço de entrega"
+    }
+  ],
+  "toggle_card.action.editShippingOptions": [
+    {
+      "type": 0,
+      "value": "Editar opções de envio"
+    }
+  ],
   "update_password_fields.button.forgot_password": [
     {
       "type": 0,
@@ -2936,7 +3302,7 @@
   "use_address_fields.error.please_enter_your_postal_or_zip": [
     {
       "type": 0,
-      "value": "Insira seu código postal."
+      "value": "Insira seu CEP."
     }
   ],
   "use_address_fields.error.please_select_your_address": [
@@ -2960,7 +3326,7 @@
   "use_address_fields.error.please_select_your_state_or_province": [
     {
       "type": 0,
-      "value": "Selecione estado/província."
+      "value": "Selecione seu estado."
     }
   ],
   "use_address_fields.error.required": [
@@ -3169,12 +3535,44 @@
       "value": " restante(s)!"
     }
   ],
+  "use_product.message.inventory_remaining_for_product": [
+    {
+      "type": 0,
+      "value": "Sobraram somente "
+    },
+    {
+      "type": 1,
+      "value": "stockLevel"
+    },
+    {
+      "type": 0,
+      "value": " para "
+    },
+    {
+      "type": 1,
+      "value": "productName"
+    },
+    {
+      "type": 0,
+      "value": "!"
+    }
+  ],
   "use_product.message.out_of_stock": [
     {
       "type": 0,
       "value": "Fora de estoque"
     }
   ],
+  "use_product.message.out_of_stock_for_product": [
+    {
+      "type": 1,
+      "value": "productName"
+    },
+    {
+      "type": 0,
+      "value": " esgotado(a)"
+    }
+  ],
   "use_profile_fields.error.required_email": [
     {
       "type": 0,
@@ -3403,6 +3801,34 @@
       "value": "Nova senha"
     }
   ],
+  "wishlist_primary_action.button.addSetToCart.label": [
+    {
+      "type": 0,
+      "value": "Adicionar conjunto de "
+    },
+    {
+      "type": 1,
+      "value": "productName"
+    },
+    {
+      "type": 0,
+      "value": " ao carrinho"
+    }
+  ],
+  "wishlist_primary_action.button.addToCart.label": [
+    {
+      "type": 0,
+      "value": "Adicionar "
+    },
+    {
+      "type": 1,
+      "value": "productName"
+    },
+    {
+      "type": 0,
+      "value": " ao carrinho"
+    }
+  ],
   "wishlist_primary_action.button.add_set_to_cart": [
     {
       "type": 0,
@@ -3415,6 +3841,16 @@
       "value": "Adicionar ao carrinho"
     }
   ],
+  "wishlist_primary_action.button.viewFullDetails.label": [
+    {
+      "type": 0,
+      "value": "Ver todos os detalhes de "
+    },
+    {
+      "type": 1,
+      "value": "productName"
+    }
+  ],
   "wishlist_primary_action.button.view_full_details": [
     {
       "type": 0,
@@ -3427,6 +3863,16 @@
       "value": "Ver opções"
     }
   ],
+  "wishlist_primary_action.button.view_options.label": [
+    {
+      "type": 0,
+      "value": "Ver opções para "
+    },
+    {
+      "type": 1,
+      "value": "productName"
+    }
+  ],
   "wishlist_primary_action.info.added_to_cart": [
     {
       "type": 1,
@@ -3471,6 +3917,16 @@
       "value": "Remover"
     }
   ],
+  "wishlist_secondary_button_group.info.item.remove.label": [
+    {
+      "type": 0,
+      "value": "Remover "
+    },
+    {
+      "type": 1,
+      "value": "productName"
+    }
+  ],
   "wishlist_secondary_button_group.info.item_removed": [
     {
       "type": 0,
diff --git a/packages/template-retail-react-app/app/static/translations/compiled/zh-CN.json b/packages/template-retail-react-app/app/static/translations/compiled/zh-CN.json
index d406c55c72..f81152f55c 100644
--- a/packages/template-retail-react-app/app/static/translations/compiled/zh-CN.json
+++ b/packages/template-retail-react-app/app/static/translations/compiled/zh-CN.json
@@ -437,6 +437,20 @@
       "value": "从购物车中移除商品"
     }
   ],
+  "cart.product_edit_modal.modal_label": [
+    {
+      "type": 0,
+      "value": "编辑 "
+    },
+    {
+      "type": 1,
+      "value": "productName"
+    },
+    {
+      "type": 0,
+      "value": " 模态"
+    }
+  ],
   "cart.recommended_products.title.may_also_like": [
     {
       "type": 0,
@@ -539,6 +553,12 @@
       "value": "）"
     }
   ],
+  "category_links.button_text": [
+    {
+      "type": 0,
+      "value": "类别"
+    }
+  ],
   "cc_radio_group.action.remove": [
     {
       "type": 0,
@@ -653,6 +673,24 @@
       "value": "送货"
     }
   ],
+  "checkout_confirmation.label.shipping.strikethrough.price": [
+    {
+      "type": 0,
+      "value": "原价 "
+    },
+    {
+      "type": 1,
+      "value": "originalPrice"
+    },
+    {
+      "type": 0,
+      "value": "，现价 "
+    },
+    {
+      "type": 1,
+      "value": "newPrice"
+    }
+  ],
   "checkout_confirmation.label.subtotal": [
     {
       "type": 0,
@@ -819,6 +857,12 @@
       "value": "信用卡"
     }
   ],
+  "checkout_payment.label.billing_address_form": [
+    {
+      "type": 0,
+      "value": "帐单地址表格"
+    }
+  ],
   "checkout_payment.label.same_as_shipping": [
     {
       "type": 0,
@@ -861,6 +905,18 @@
       "value": "是"
     }
   ],
+  "confirmation_modal.default.assistive_msg.no": [
+    {
+      "type": 0,
+      "value": "否，取消操作"
+    }
+  ],
+  "confirmation_modal.default.assistive_msg.yes": [
+    {
+      "type": 0,
+      "value": "是，确认操作"
+    }
+  ],
   "confirmation_modal.default.message.you_want_to_continue": [
     {
       "type": 0,
@@ -891,6 +947,24 @@
       "value": "是，移除商品"
     }
   ],
+  "confirmation_modal.remove_cart_item.assistive_msg.no": [
+    {
+      "type": 0,
+      "value": "否，保留商品"
+    }
+  ],
+  "confirmation_modal.remove_cart_item.assistive_msg.remove": [
+    {
+      "type": 0,
+      "value": "移除无货产品"
+    }
+  ],
+  "confirmation_modal.remove_cart_item.assistive_msg.yes": [
+    {
+      "type": 0,
+      "value": "是，移除商品"
+    }
+  ],
   "confirmation_modal.remove_cart_item.message.need_to_remove_due_to_unavailability": [
     {
       "type": 0,
@@ -999,6 +1073,60 @@
       "value": "安全码信息"
     }
   ],
+  "display_price.assistive_msg.current_price": [
+    {
+      "type": 0,
+      "value": "当前价格 "
+    },
+    {
+      "type": 1,
+      "value": "currentPrice"
+    }
+  ],
+  "display_price.assistive_msg.current_price_with_range": [
+    {
+      "type": 0,
+      "value": "从当前价格 "
+    },
+    {
+      "type": 1,
+      "value": "currentPrice"
+    }
+  ],
+  "display_price.assistive_msg.strikethrough_price": [
+    {
+      "type": 0,
+      "value": "原价 "
+    },
+    {
+      "type": 1,
+      "value": "listPrice"
+    }
+  ],
+  "display_price.assistive_msg.strikethrough_price_with_range": [
+    {
+      "type": 0,
+      "value": "从原价 "
+    },
+    {
+      "type": 1,
+      "value": "listPrice"
+    }
+  ],
+  "display_price.label.current_price_with_range": [
+    {
+      "type": 0,
+      "value": "从 "
+    },
+    {
+      "type": 1,
+      "value": "currentPrice"
+    },
+    {
+      "type": 0,
+      "value": " 起"
+    }
+  ],
   "drawer_menu.button.account_details": [
     {
       "type": 0,
@@ -1029,6 +1157,12 @@
       "value": "订单记录"
     }
   ],
+  "drawer_menu.header.assistive_msg.title": [
+    {
+      "type": 0,
+      "value": "菜单抽屉"
+    }
+  ],
   "drawer_menu.link.about_us": [
     {
       "type": 0,
@@ -1417,6 +1551,12 @@
       "value": "菜单"
     }
   ],
+  "header.button.assistive_msg.menu.open_dialog": [
+    {
+      "type": 0,
+      "value": "打开对话框"
+    }
+  ],
   "header.button.assistive_msg.my_account": [
     {
       "type": 0,
@@ -1439,6 +1579,12 @@
       "value": "numItems"
     }
   ],
+  "header.button.assistive_msg.store_locator": [
+    {
+      "type": 0,
+      "value": "实体店地址搜索"
+    }
+  ],
   "header.button.assistive_msg.wishlist": [
     {
       "type": 0,
@@ -1649,6 +1795,12 @@
       "value": "quantity"
     }
   ],
+  "item_attributes.label.selected_options": [
+    {
+      "type": 0,
+      "value": "已选选项"
+    }
+  ],
   "item_image.label.sale": [
     {
       "type": 0,
@@ -1661,10 +1813,28 @@
       "value": "不可用"
     }
   ],
-  "item_price.label.starting_at": [
+  "item_variant.assistive_msg.quantity": [
+    {
+      "type": 0,
+      "value": "数量 "
+    },
+    {
+      "type": 1,
+      "value": "quantity"
+    }
+  ],
+  "item_variant.quantity.label": [
+    {
+      "type": 1,
+      "value": "productName"
+    },
     {
       "type": 0,
-      "value": "起价："
+      "value": " 的数量选择器。选择的数量是 "
+    },
+    {
+      "type": 1,
+      "value": "quantity"
     }
   ],
   "lCPCxk": [
@@ -2485,14 +2655,28 @@
       "value": "product"
     }
   ],
-  "product_tile.label.starting_at_price": [
+  "product_tile.badge.label.new": [
     {
       "type": 0,
-      "value": "起价："
-    },
+      "value": "新建"
+    }
+  ],
+  "product_tile.badge.label.sale": [
     {
-      "type": 1,
-      "value": "price"
+      "type": 0,
+      "value": "销售"
+    }
+  ],
+  "product_view.button.add_bundle_to_cart": [
+    {
+      "type": 0,
+      "value": "将套装添加到购物车"
+    }
+  ],
+  "product_view.button.add_bundle_to_wishlist": [
+    {
+      "type": 0,
+      "value": "将套装添加到心愿单"
     }
   ],
   "product_view.button.add_set_to_cart": [
@@ -2528,13 +2712,29 @@
   "product_view.label.assistive_msg.quantity_decrement": [
     {
       "type": 0,
-      "value": "递减数量"
+      "value": "递减 "
+    },
+    {
+      "type": 1,
+      "value": "productName"
+    },
+    {
+      "type": 0,
+      "value": " 数量"
     }
   ],
   "product_view.label.assistive_msg.quantity_increment": [
     {
       "type": 0,
-      "value": "递增数量"
+      "value": "递增 "
+    },
+    {
+      "type": 1,
+      "value": "productName"
+    },
+    {
+      "type": 0,
+      "value": " 数量"
     }
   ],
   "product_view.label.quantity": [
@@ -2555,12 +2755,6 @@
       "value": "+"
     }
   ],
-  "product_view.label.starting_at_price": [
-    {
-      "type": 0,
-      "value": "起价："
-    }
-  ],
   "product_view.label.variant_type": [
     {
       "type": 1,
@@ -2666,7 +2860,7 @@
   "register_form.message.agree_to_policy_terms": [
     {
       "type": 0,
-      "value": "创建账户即表明您同意 Salesforce "
+      "value": "创建帐户即表示您同意 Salesforce "
     },
     {
       "children": [
@@ -2680,7 +2874,7 @@
     },
     {
       "type": 0,
-      "value": "以及"
+      "value": "和"
     },
     {
       "children": [
@@ -2791,6 +2985,32 @@
       "value": "继续并选择送货方式"
     }
   ],
+  "shipping_address.label.edit_button": [
+    {
+      "type": 0,
+      "value": "编辑 "
+    },
+    {
+      "type": 1,
+      "value": "address"
+    }
+  ],
+  "shipping_address.label.remove_button": [
+    {
+      "type": 0,
+      "value": "移除"
+    },
+    {
+      "type": 1,
+      "value": "address"
+    }
+  ],
+  "shipping_address.label.shipping_address_form": [
+    {
+      "type": 0,
+      "value": "送货地址表格"
+    }
+  ],
   "shipping_address.title.shipping_address": [
     {
       "type": 0,
@@ -2881,6 +3101,140 @@
       "value": "是否确定要注销？您需要重新登录才能继续处理当前订单。"
     }
   ],
+  "store_locator.action.find": [
+    {
+      "type": 0,
+      "value": "查找"
+    }
+  ],
+  "store_locator.action.select_a_country": [
+    {
+      "type": 0,
+      "value": "选择国家/地区"
+    }
+  ],
+  "store_locator.action.use_my_location": [
+    {
+      "type": 0,
+      "value": "使用我的位置"
+    }
+  ],
+  "store_locator.action.viewMore": [
+    {
+      "type": 0,
+      "value": "查看更多"
+    }
+  ],
+  "store_locator.description.away": [
+    {
+      "type": 0,
+      "value": "離開"
+    }
+  ],
+  "store_locator.description.loading_locations": [
+    {
+      "type": 0,
+      "value": "正在加载位置..."
+    }
+  ],
+  "store_locator.description.no_locations": [
+    {
+      "type": 0,
+      "value": "对不起，这个区域没有位置"
+    }
+  ],
+  "store_locator.description.or": [
+    {
+      "type": 0,
+      "value": "或"
+    }
+  ],
+  "store_locator.description.phone": [
+    {
+      "type": 0,
+      "value": "电话:"
+    }
+  ],
+  "store_locator.description.viewing_near_postal_code": [
+    {
+      "type": 0,
+      "value": "查看查看距离 "
+    },
+    {
+      "type": 1,
+      "value": "postalCode"
+    },
+    {
+      "type": 0,
+      "value": " "
+    },
+    {
+      "type": 1,
+      "value": "distance"
+    },
+    {
+      "type": 1,
+      "value": "distanceUnit"
+    },
+    {
+      "type": 0,
+      "value": " 内的实体店"
+    }
+  ],
+  "store_locator.description.viewing_near_your_location": [
+    {
+      "type": 0,
+      "value": "查看您所在位置附近的实体店"
+    }
+  ],
+  "store_locator.dropdown.germany": [
+    {
+      "type": 0,
+      "value": "德国"
+    }
+  ],
+  "store_locator.dropdown.united_states": [
+    {
+      "type": 0,
+      "value": "美国"
+    }
+  ],
+  "store_locator.error.agree_to_share_your_location": [
+    {
+      "type": 0,
+      "value": "请同意分享您的所在位置"
+    }
+  ],
+  "store_locator.error.please_enter_a_postal_code": [
+    {
+      "type": 0,
+      "value": "请输入邮政编码。"
+    }
+  ],
+  "store_locator.error.please_select_a_country": [
+    {
+      "type": 0,
+      "value": "请选择国家。"
+    }
+  ],
+  "store_locator.field.placeholder.enter_postal_code": [
+    {
+      "type": 0,
+      "value": "输入邮政编码"
+    }
+  ],
+  "store_locator.pagination.load_more": [
+    {
+      "type": 0,
+      "value": "加载更多"
+    }
+  ],
+  "store_locator.title": [
+    {
+      "type": 0,
+      "value": "查找实体店"
+    }
+  ],
   "swatch_group.selected.label": [
     {
       "type": 1,
@@ -2897,6 +3251,30 @@
       "value": "编辑"
     }
   ],
+  "toggle_card.action.editContactInfo": [
+    {
+      "type": 0,
+      "value": "编辑联系信息"
+    }
+  ],
+  "toggle_card.action.editPaymentInfo": [
+    {
+      "type": 0,
+      "value": "编辑付款信息"
+    }
+  ],
+  "toggle_card.action.editShippingAddress": [
+    {
+      "type": 0,
+      "value": "编辑送货地址"
+    }
+  ],
+  "toggle_card.action.editShippingOptions": [
+    {
+      "type": 0,
+      "value": "编辑送货选项"
+    }
+  ],
   "update_password_fields.button.forgot_password": [
     {
       "type": 0,
@@ -2948,7 +3326,7 @@
   "use_address_fields.error.please_select_your_state_or_province": [
     {
       "type": 0,
-      "value": "请选择您所在的州／省。"
+      "value": "请选择您所在的州。"
     }
   ],
   "use_address_fields.error.required": [
@@ -3157,12 +3535,40 @@
       "value": " 件！"
     }
   ],
+  "use_product.message.inventory_remaining_for_product": [
+    {
+      "type": 1,
+      "value": "productName"
+    },
+    {
+      "type": 0,
+      "value": " 只剩下 "
+    },
+    {
+      "type": 1,
+      "value": "stockLevel"
+    },
+    {
+      "type": 0,
+      "value": "！"
+    }
+  ],
   "use_product.message.out_of_stock": [
     {
       "type": 0,
       "value": "无库存"
     }
   ],
+  "use_product.message.out_of_stock_for_product": [
+    {
+      "type": 1,
+      "value": "productName"
+    },
+    {
+      "type": 0,
+      "value": " 无库存"
+    }
+  ],
   "use_profile_fields.error.required_email": [
     {
       "type": 0,
@@ -3391,6 +3797,34 @@
       "value": "新密码"
     }
   ],
+  "wishlist_primary_action.button.addSetToCart.label": [
+    {
+      "type": 0,
+      "value": "将 "
+    },
+    {
+      "type": 1,
+      "value": "productName"
+    },
+    {
+      "type": 0,
+      "value": " 套装添加到购物车"
+    }
+  ],
+  "wishlist_primary_action.button.addToCart.label": [
+    {
+      "type": 0,
+      "value": "将 "
+    },
+    {
+      "type": 1,
+      "value": "productName"
+    },
+    {
+      "type": 0,
+      "value": " 添加到购物车"
+    }
+  ],
   "wishlist_primary_action.button.add_set_to_cart": [
     {
       "type": 0,
@@ -3403,6 +3837,20 @@
       "value": "添加到购物车"
     }
   ],
+  "wishlist_primary_action.button.viewFullDetails.label": [
+    {
+      "type": 0,
+      "value": "查看 "
+    },
+    {
+      "type": 1,
+      "value": "productName"
+    },
+    {
+      "type": 0,
+      "value": " 的完整详细信息"
+    }
+  ],
   "wishlist_primary_action.button.view_full_details": [
     {
       "type": 0,
@@ -3415,6 +3863,20 @@
       "value": "查看选项"
     }
   ],
+  "wishlist_primary_action.button.view_options.label": [
+    {
+      "type": 0,
+      "value": "查看 "
+    },
+    {
+      "type": 1,
+      "value": "productName"
+    },
+    {
+      "type": 0,
+      "value": " 的选项"
+    }
+  ],
   "wishlist_primary_action.info.added_to_cart": [
     {
       "type": 1,
@@ -3459,6 +3921,16 @@
       "value": "移除"
     }
   ],
+  "wishlist_secondary_button_group.info.item.remove.label": [
+    {
+      "type": 0,
+      "value": "移除"
+    },
+    {
+      "type": 1,
+      "value": "productName"
+    }
+  ],
   "wishlist_secondary_button_group.info.item_removed": [
     {
       "type": 0,
diff --git a/packages/template-retail-react-app/app/static/translations/compiled/zh-TW.json b/packages/template-retail-react-app/app/static/translations/compiled/zh-TW.json
index 3877030193..1702e03af2 100644
--- a/packages/template-retail-react-app/app/static/translations/compiled/zh-TW.json
+++ b/packages/template-retail-react-app/app/static/translations/compiled/zh-TW.json
@@ -433,6 +433,16 @@
       "value": "已從購物車移除商品"
     }
   ],
+  "cart.product_edit_modal.modal_label": [
+    {
+      "type": 1,
+      "value": "productName"
+    },
+    {
+      "type": 0,
+      "value": " 的編輯互動視窗 (modal)"
+    }
+  ],
   "cart.recommended_products.title.may_also_like": [
     {
       "type": 0,
@@ -535,6 +545,12 @@
       "value": ")"
     }
   ],
+  "category_links.button_text": [
+    {
+      "type": 0,
+      "value": "類別"
+    }
+  ],
   "cc_radio_group.action.remove": [
     {
       "type": 0,
@@ -649,6 +665,24 @@
       "value": "運送"
     }
   ],
+  "checkout_confirmation.label.shipping.strikethrough.price": [
+    {
+      "type": 0,
+      "value": "原本 "
+    },
+    {
+      "type": 1,
+      "value": "originalPrice"
+    },
+    {
+      "type": 0,
+      "value": " ，現在 "
+    },
+    {
+      "type": 1,
+      "value": "newPrice"
+    }
+  ],
   "checkout_confirmation.label.subtotal": [
     {
       "type": 0,
@@ -815,6 +849,12 @@
       "value": "信用卡"
     }
   ],
+  "checkout_payment.label.billing_address_form": [
+    {
+      "type": 0,
+      "value": "帳單地址表單"
+    }
+  ],
   "checkout_payment.label.same_as_shipping": [
     {
       "type": 0,
@@ -857,6 +897,18 @@
       "value": "是"
     }
   ],
+  "confirmation_modal.default.assistive_msg.no": [
+    {
+      "type": 0,
+      "value": "否，取消動作"
+    }
+  ],
+  "confirmation_modal.default.assistive_msg.yes": [
+    {
+      "type": 0,
+      "value": "是，確認動作"
+    }
+  ],
   "confirmation_modal.default.message.you_want_to_continue": [
     {
       "type": 0,
@@ -887,6 +939,24 @@
       "value": "是，移除商品"
     }
   ],
+  "confirmation_modal.remove_cart_item.assistive_msg.no": [
+    {
+      "type": 0,
+      "value": "否，保留商品"
+    }
+  ],
+  "confirmation_modal.remove_cart_item.assistive_msg.remove": [
+    {
+      "type": 0,
+      "value": "移除無法提供的產品"
+    }
+  ],
+  "confirmation_modal.remove_cart_item.assistive_msg.yes": [
+    {
+      "type": 0,
+      "value": "是，移除商品"
+    }
+  ],
   "confirmation_modal.remove_cart_item.message.need_to_remove_due_to_unavailability": [
     {
       "type": 0,
@@ -995,6 +1065,56 @@
       "value": "安全碼資訊"
     }
   ],
+  "display_price.assistive_msg.current_price": [
+    {
+      "type": 0,
+      "value": "目前價格 "
+    },
+    {
+      "type": 1,
+      "value": "currentPrice"
+    }
+  ],
+  "display_price.assistive_msg.current_price_with_range": [
+    {
+      "type": 0,
+      "value": "從目前價格 "
+    },
+    {
+      "type": 1,
+      "value": "currentPrice"
+    }
+  ],
+  "display_price.assistive_msg.strikethrough_price": [
+    {
+      "type": 0,
+      "value": "原價 "
+    },
+    {
+      "type": 1,
+      "value": "listPrice"
+    }
+  ],
+  "display_price.assistive_msg.strikethrough_price_with_range": [
+    {
+      "type": 0,
+      "value": "從原價 "
+    },
+    {
+      "type": 1,
+      "value": "listPrice"
+    }
+  ],
+  "display_price.label.current_price_with_range": [
+    {
+      "type": 0,
+      "value": "從 "
+    },
+    {
+      "type": 1,
+      "value": "currentPrice"
+    }
+  ],
   "drawer_menu.button.account_details": [
     {
       "type": 0,
@@ -1025,6 +1145,12 @@
       "value": "訂單記錄"
     }
   ],
+  "drawer_menu.header.assistive_msg.title": [
+    {
+      "type": 0,
+      "value": "隱藏式側選單"
+    }
+  ],
   "drawer_menu.link.about_us": [
     {
       "type": 0,
@@ -1413,6 +1539,12 @@
       "value": "選單"
     }
   ],
+  "header.button.assistive_msg.menu.open_dialog": [
+    {
+      "type": 0,
+      "value": "開啟對話方塊"
+    }
+  ],
   "header.button.assistive_msg.my_account": [
     {
       "type": 0,
@@ -1435,6 +1567,12 @@
       "value": "numItems"
     }
   ],
+  "header.button.assistive_msg.store_locator": [
+    {
+      "type": 0,
+      "value": "商店位置搜尋"
+    }
+  ],
   "header.button.assistive_msg.wishlist": [
     {
       "type": 0,
@@ -1645,6 +1783,12 @@
       "value": "quantity"
     }
   ],
+  "item_attributes.label.selected_options": [
+    {
+      "type": 0,
+      "value": "已選取的選項"
+    }
+  ],
   "item_image.label.sale": [
     {
       "type": 0,
@@ -1657,10 +1801,28 @@
       "value": "不可用"
     }
   ],
-  "item_price.label.starting_at": [
+  "item_variant.assistive_msg.quantity": [
     {
       "type": 0,
-      "value": "起始"
+      "value": "數量 "
+    },
+    {
+      "type": 1,
+      "value": "quantity"
+    }
+  ],
+  "item_variant.quantity.label": [
+    {
+      "type": 1,
+      "value": "productName"
+    },
+    {
+      "type": 0,
+      "value": " 的數量選擇器 。 選擇的數量是 "
+    },
+    {
+      "type": 1,
+      "value": "quantity"
     }
   ],
   "lCPCxk": [
@@ -2481,14 +2643,28 @@
       "value": "product"
     }
   ],
-  "product_tile.label.starting_at_price": [
+  "product_tile.badge.label.new": [
     {
-      "type": 1,
-      "value": "price"
-    },
+      "type": 0,
+      "value": "新增"
+    }
+  ],
+  "product_tile.badge.label.sale": [
+    {
+      "type": 0,
+      "value": "特價"
+    }
+  ],
+  "product_view.button.add_bundle_to_cart": [
     {
       "type": 0,
-      "value": " 起"
+      "value": "新增搭售方案到購物車"
+    }
+  ],
+  "product_view.button.add_bundle_to_wishlist": [
+    {
+      "type": 0,
+      "value": "新增搭售方案到願望清單"
     }
   ],
   "product_view.button.add_set_to_cart": [
@@ -2522,15 +2698,23 @@
     }
   ],
   "product_view.label.assistive_msg.quantity_decrement": [
+    {
+      "type": 1,
+      "value": "productName"
+    },
     {
       "type": 0,
-      "value": "遞減數量"
+      "value": " 的遞減數量"
     }
   ],
   "product_view.label.assistive_msg.quantity_increment": [
+    {
+      "type": 1,
+      "value": "productName"
+    },
     {
       "type": 0,
-      "value": "遞增數量"
+      "value": " 的遞增數量"
     }
   ],
   "product_view.label.quantity": [
@@ -2551,12 +2735,6 @@
       "value": "+"
     }
   ],
-  "product_view.label.starting_at_price": [
-    {
-      "type": 0,
-      "value": "起始"
-    }
-  ],
   "product_view.label.variant_type": [
     {
       "type": 1,
@@ -2784,7 +2962,33 @@
   "shipping_address.button.continue_to_shipping": [
     {
       "type": 0,
-      "value": "繼續前往運送方式"
+      "value": "繼續前往送貨方式"
+    }
+  ],
+  "shipping_address.label.edit_button": [
+    {
+      "type": 0,
+      "value": "編輯 "
+    },
+    {
+      "type": 1,
+      "value": "address"
+    }
+  ],
+  "shipping_address.label.remove_button": [
+    {
+      "type": 0,
+      "value": "移除 "
+    },
+    {
+      "type": 1,
+      "value": "address"
+    }
+  ],
+  "shipping_address.label.shipping_address_form": [
+    {
+      "type": 0,
+      "value": "送貨地址表單"
     }
   ],
   "shipping_address.title.shipping_address": [
@@ -2877,6 +3081,144 @@
       "value": "確定要登出嗎？您必須重新登入，才能繼續目前的訂單流程。"
     }
   ],
+  "store_locator.action.find": [
+    {
+      "type": 0,
+      "value": "尋找"
+    }
+  ],
+  "store_locator.action.select_a_country": [
+    {
+      "type": 0,
+      "value": "選擇國家/地區"
+    }
+  ],
+  "store_locator.action.use_my_location": [
+    {
+      "type": 0,
+      "value": "使用我的位置"
+    }
+  ],
+  "store_locator.action.viewMore": [
+    {
+      "type": 0,
+      "value": "檢視更多"
+    }
+  ],
+  "store_locator.description.away": [
+    {
+      "type": 0,
+      "value": "離開"
+    }
+  ],
+  "store_locator.description.loading_locations": [
+    {
+      "type": 0,
+      "value": "載入位置..."
+    }
+  ],
+  "store_locator.description.no_locations": [
+    {
+      "type": 0,
+      "value": "對不起，此區域沒有位置"
+    }
+  ],
+  "store_locator.description.or": [
+    {
+      "type": 0,
+      "value": "或"
+    }
+  ],
+  "store_locator.description.phone": [
+    {
+      "type": 0,
+      "value": "電話："
+    }
+  ],
+  "store_locator.description.viewing_near_postal_code": [
+    {
+      "type": 0,
+      "value": "檢視在 "
+    },
+    {
+      "type": 1,
+      "value": "postalCode"
+    },
+    {
+      "type": 0,
+      "value": " 的 "
+    },
+    {
+      "type": 1,
+      "value": "distance"
+    },
+    {
+      "type": 0,
+      "value": " "
+    },
+    {
+      "type": 1,
+      "value": "distanceUnit"
+    },
+    {
+      "type": 0,
+      "value": " 商店"
+    }
+  ],
+  "store_locator.description.viewing_near_your_location": [
+    {
+      "type": 0,
+      "value": "檢視您所在附近的商店位置"
+    }
+  ],
+  "store_locator.dropdown.germany": [
+    {
+      "type": 0,
+      "value": "德國"
+    }
+  ],
+  "store_locator.dropdown.united_states": [
+    {
+      "type": 0,
+      "value": "美國"
+    }
+  ],
+  "store_locator.error.agree_to_share_your_location": [
+    {
+      "type": 0,
+      "value": "請同意分享您的位置"
+    }
+  ],
+  "store_locator.error.please_enter_a_postal_code": [
+    {
+      "type": 0,
+      "value": "請輸入郵遞區號。"
+    }
+  ],
+  "store_locator.error.please_select_a_country": [
+    {
+      "type": 0,
+      "value": "請選擇國家/地區。"
+    }
+  ],
+  "store_locator.field.placeholder.enter_postal_code": [
+    {
+      "type": 0,
+      "value": "輸入郵遞區號"
+    }
+  ],
+  "store_locator.pagination.load_more": [
+    {
+      "type": 0,
+      "value": "載入更多"
+    }
+  ],
+  "store_locator.title": [
+    {
+      "type": 0,
+      "value": "尋找商店"
+    }
+  ],
   "swatch_group.selected.label": [
     {
       "type": 1,
@@ -2893,6 +3235,30 @@
       "value": "編輯"
     }
   ],
+  "toggle_card.action.editContactInfo": [
+    {
+      "type": 0,
+      "value": "編輯聯絡資訊"
+    }
+  ],
+  "toggle_card.action.editPaymentInfo": [
+    {
+      "type": 0,
+      "value": "編輯付款資訊"
+    }
+  ],
+  "toggle_card.action.editShippingAddress": [
+    {
+      "type": 0,
+      "value": "編輯運送地址"
+    }
+  ],
+  "toggle_card.action.editShippingOptions": [
+    {
+      "type": 0,
+      "value": "編輯運送選項"
+    }
+  ],
   "update_password_fields.button.forgot_password": [
     {
       "type": 0,
@@ -2944,7 +3310,7 @@
   "use_address_fields.error.please_select_your_state_or_province": [
     {
       "type": 0,
-      "value": "請選擇您的州/省。"
+      "value": "請選擇您所在的州。"
     }
   ],
   "use_address_fields.error.required": [
@@ -3153,12 +3519,40 @@
       "value": " 個！"
     }
   ],
+  "use_product.message.inventory_remaining_for_product": [
+    {
+      "type": 1,
+      "value": "productName"
+    },
+    {
+      "type": 0,
+      "value": "只剩下 "
+    },
+    {
+      "type": 1,
+      "value": "stockLevel"
+    },
+    {
+      "type": 0,
+      "value": "！"
+    }
+  ],
   "use_product.message.out_of_stock": [
     {
       "type": 0,
       "value": "缺貨"
     }
   ],
+  "use_product.message.out_of_stock_for_product": [
+    {
+      "type": 0,
+      "value": "缺貨 "
+    },
+    {
+      "type": 1,
+      "value": "productName"
+    }
+  ],
   "use_profile_fields.error.required_email": [
     {
       "type": 0,
@@ -3387,6 +3781,34 @@
       "value": "新密碼"
     }
   ],
+  "wishlist_primary_action.button.addSetToCart.label": [
+    {
+      "type": 0,
+      "value": "新增 "
+    },
+    {
+      "type": 1,
+      "value": "productName"
+    },
+    {
+      "type": 0,
+      "value": " 組合至購物車"
+    }
+  ],
+  "wishlist_primary_action.button.addToCart.label": [
+    {
+      "type": 0,
+      "value": "新增 "
+    },
+    {
+      "type": 1,
+      "value": "productName"
+    },
+    {
+      "type": 0,
+      "value": " 至購物車"
+    }
+  ],
   "wishlist_primary_action.button.add_set_to_cart": [
     {
       "type": 0,
@@ -3399,6 +3821,20 @@
       "value": "新增至購物車"
     }
   ],
+  "wishlist_primary_action.button.viewFullDetails.label": [
+    {
+      "type": 0,
+      "value": "檢視 "
+    },
+    {
+      "type": 1,
+      "value": "productName"
+    },
+    {
+      "type": 0,
+      "value": " 完整詳細資訊"
+    }
+  ],
   "wishlist_primary_action.button.view_full_details": [
     {
       "type": 0,
@@ -3411,6 +3847,20 @@
       "value": "檢視選項"
     }
   ],
+  "wishlist_primary_action.button.view_options.label": [
+    {
+      "type": 0,
+      "value": "檢視 "
+    },
+    {
+      "type": 1,
+      "value": "productName"
+    },
+    {
+      "type": 0,
+      "value": " 的選項"
+    }
+  ],
   "wishlist_primary_action.info.added_to_cart": [
     {
       "type": 1,
@@ -3455,6 +3905,16 @@
       "value": "移除"
     }
   ],
+  "wishlist_secondary_button_group.info.item.remove.label": [
+    {
+      "type": 0,
+      "value": "移除 "
+    },
+    {
+      "type": 1,
+      "value": "productName"
+    }
+  ],
   "wishlist_secondary_button_group.info.item_removed": [
     {
       "type": 0,
diff --git a/packages/template-retail-react-app/app/utils/test-utils.js b/packages/template-retail-react-app/app/utils/test-utils.js
index febcb7f4dc..747429bd19 100644
--- a/packages/template-retail-react-app/app/utils/test-utils.js
+++ b/packages/template-retail-react-app/app/utils/test-utils.js
@@ -21,10 +21,23 @@ import {withReactQuery} from '@salesforce/pwa-kit-react-sdk/ssr/universal/compon
 import fallbackMessages from '@salesforce/retail-react-app/app/static/translations/compiled/en-GB.json'
 import mockConfig from '@salesforce/retail-react-app/config/mocks/default'
 // Contexts
-import {CurrencyProvider, MultiSiteProvider} from '@salesforce/retail-react-app/app/contexts'
+import {
+    CurrencyProvider,
+    MultiSiteProvider,
+    StoreLocatorProvider
+} from '@salesforce/retail-react-app/app/contexts'
 
 import {createUrlTemplate} from '@salesforce/retail-react-app/app/utils/url'
 import {getSiteByReference} from '@salesforce/retail-react-app/app/utils/site-utils'
+import {
+    STORE_LOCATOR_RADIUS,
+    STORE_LOCATOR_RADIUS_UNIT,
+    STORE_LOCATOR_DEFAULT_COUNTRY,
+    STORE_LOCATOR_DEFAULT_COUNTRY_CODE,
+    STORE_LOCATOR_DEFAULT_POSTAL_CODE,
+    STORE_LOCATOR_DEFAULT_PAGE_SIZE,
+    STORE_LOCATOR_SUPPORTED_COUNTRIES
+} from '@salesforce/retail-react-app/app/constants'
 import jwt from 'jsonwebtoken'
 import userEvent from '@testing-library/user-event'
 // This JWT's payload is special
@@ -121,6 +134,16 @@ export const TestProviders = ({
         locale.alias || locale.id
     )
 
+    const storeLocatorConfig = {
+        radius: STORE_LOCATOR_RADIUS,
+        radiusUnit: STORE_LOCATOR_RADIUS_UNIT,
+        defaultCountry: STORE_LOCATOR_DEFAULT_COUNTRY,
+        defaultCountryCode: STORE_LOCATOR_DEFAULT_COUNTRY_CODE,
+        defaultPostalCode: STORE_LOCATOR_DEFAULT_POSTAL_CODE,
+        defaultPageSize: STORE_LOCATOR_DEFAULT_PAGE_SIZE,
+        supportedCountries: STORE_LOCATOR_SUPPORTED_COUNTRIES
+    }
+
     return (
         <ServerContext.Provider value={{}}>
             <IntlProvider locale={locale.id} defaultLocale={DEFAULT_LOCALE} messages={messages}>
@@ -136,15 +159,17 @@ export const TestProviders = ({
                         fetchedToken={bypassAuth ? (isGuest ? guestToken : registerUserToken) : ''}
                     >
                         <CurrencyProvider currency={DEFAULT_CURRENCY}>
-                            <Router>
-                                <ChakraProvider theme={theme}>
-                                    <AddToCartModalProvider>
+                            <StoreLocatorProvider config={storeLocatorConfig}>
+                                <Router>
+                                    <ChakraProvider theme={theme}>
+                                        <AddToCartModalProvider>
                                         <BonusProductModalProvider>
                                             {children}
                                         </BonusProductModalProvider>
                                     </AddToCartModalProvider>
-                                </ChakraProvider>
-                            </Router>
+                                    </ChakraProvider>
+                                </Router>
+                            </StoreLocatorProvider>
                         </CurrencyProvider>
                     </CommerceApiProvider>
                 </MultiSiteProvider>
diff --git a/packages/template-retail-react-app/translations/de-DE.json b/packages/template-retail-react-app/translations/de-DE.json
index b1f7513a09..bd390f3e6b 100644
--- a/packages/template-retail-react-app/translations/de-DE.json
+++ b/packages/template-retail-react-app/translations/de-DE.json
@@ -174,6 +174,9 @@
   "cart.info.removed_from_cart": {
     "defaultMessage": "Artikel aus dem Warenkorb entfernt"
   },
+  "cart.product_edit_modal.modal_label": {
+    "defaultMessage": "Modales Bearbeitungsfenster für {productName}"
+  },
   "cart.recommended_products.title.may_also_like": {
     "defaultMessage": "Das könnte Ihnen auch gefallen"
   },
@@ -204,6 +207,9 @@
   "cart_title.title.cart_num_of_items": {
     "defaultMessage": "Warenkorb ({itemCount, plural, =0 {0 Artikel} one {# Artikel} other {# Artikel}})"
   },
+  "category_links.button_text": {
+    "defaultMessage": "Kategorien"
+  },
   "cc_radio_group.action.remove": {
     "defaultMessage": "Entfernen"
   },
@@ -261,6 +267,9 @@
   "checkout_confirmation.label.shipping": {
     "defaultMessage": "Versand"
   },
+  "checkout_confirmation.label.shipping.strikethrough.price": {
+    "defaultMessage": "Ursprünglich {originalPrice}, jetzt {newPrice}"
+  },
   "checkout_confirmation.label.subtotal": {
     "defaultMessage": "Zwischensumme"
   },
@@ -319,6 +328,9 @@
   "checkout_payment.heading.credit_card": {
     "defaultMessage": "Kreditkarte"
   },
+  "checkout_payment.label.billing_address_form": {
+    "defaultMessage": "Formular für Rechnungsadresse"
+  },
   "checkout_payment.label.same_as_shipping": {
     "defaultMessage": "Entspricht der Lieferadresse"
   },
@@ -334,6 +346,12 @@
   "confirmation_modal.default.action.yes": {
     "defaultMessage": "Ja"
   },
+  "confirmation_modal.default.assistive_msg.no": {
+    "defaultMessage": "Nein, Aktion abbrechen"
+  },
+  "confirmation_modal.default.assistive_msg.yes": {
+    "defaultMessage": "Ja, Aktion bestätigen"
+  },
   "confirmation_modal.default.message.you_want_to_continue": {
     "defaultMessage": "Möchten Sie wirklich fortfahren?"
   },
@@ -349,6 +367,15 @@
   "confirmation_modal.remove_cart_item.action.yes": {
     "defaultMessage": "Ja, Artikel entfernen"
   },
+  "confirmation_modal.remove_cart_item.assistive_msg.no": {
+    "defaultMessage": "Nein, Artikel beibehalten"
+  },
+  "confirmation_modal.remove_cart_item.assistive_msg.remove": {
+    "defaultMessage": "Nicht verfügbare Produkte entfernen"
+  },
+  "confirmation_modal.remove_cart_item.assistive_msg.yes": {
+    "defaultMessage": "Ja, Artikel entfernen"
+  },
   "confirmation_modal.remove_cart_item.message.need_to_remove_due_to_unavailability": {
     "defaultMessage": "Einige Artikel sind nicht mehr online verfügbar und werden aus Ihrem Warenkorb entfernt."
   },
@@ -405,6 +432,21 @@
   "credit_card_fields.tool_tip.security_code_aria_label": {
     "defaultMessage": "Informationen zum Sicherheitscode"
   },
+  "display_price.assistive_msg.current_price": {
+    "defaultMessage": "aktueller Preis {currentPrice}"
+  },
+  "display_price.assistive_msg.current_price_with_range": {
+    "defaultMessage": "Ab aktuellem Preis {currentPrice}"
+  },
+  "display_price.assistive_msg.strikethrough_price": {
+    "defaultMessage": "ursprünglicher Preis {listPrice}"
+  },
+  "display_price.assistive_msg.strikethrough_price_with_range": {
+    "defaultMessage": "Ab ursprünglichem Preis {listPrice}"
+  },
+  "display_price.label.current_price_with_range": {
+    "defaultMessage": "Von {currentPrice}"
+  },
   "drawer_menu.button.account_details": {
     "defaultMessage": "Kontodetails"
   },
@@ -420,6 +462,9 @@
   "drawer_menu.button.order_history": {
     "defaultMessage": "Bestellverlauf"
   },
+  "drawer_menu.header.assistive_msg.title": {
+    "defaultMessage": "Menü-Drawer"
+  },
   "drawer_menu.link.about_us": {
     "defaultMessage": "Über uns"
   },
@@ -582,6 +627,9 @@
   "header.button.assistive_msg.menu": {
     "defaultMessage": "Menü"
   },
+  "header.button.assistive_msg.menu.open_dialog": {
+    "defaultMessage": "Öffnet einen Dialog"
+  },
   "header.button.assistive_msg.my_account": {
     "defaultMessage": "Mein Konto"
   },
@@ -591,6 +639,9 @@
   "header.button.assistive_msg.my_cart_with_num_items": {
     "defaultMessage": "Mein Warenkorb, Anzahl der Artikel: {numItems}"
   },
+  "header.button.assistive_msg.store_locator": {
+    "defaultMessage": "Shop-Finder"
+  },
   "header.button.assistive_msg.wishlist": {
     "defaultMessage": "Wunschliste"
   },
@@ -691,6 +742,9 @@
   "item_attributes.label.quantity": {
     "defaultMessage": "Menge: {quantity}"
   },
+  "item_attributes.label.selected_options": {
+    "defaultMessage": "Ausgewählte Optionen"
+  },
   "item_image.label.sale": {
     "defaultMessage": "Sonderangebot",
     "description": "A sale badge placed on top of a product image"
@@ -699,8 +753,11 @@
     "defaultMessage": "Nicht verfügbar",
     "description": "A unavailable badge placed on top of a product image"
   },
-  "item_price.label.starting_at": {
-    "defaultMessage": "Ab"
+  "item_variant.assistive_msg.quantity": {
+    "defaultMessage": "Menge {quantity}"
+  },
+  "item_variant.quantity.label": {
+    "defaultMessage": "Mengenauswahl für {productName}. Die gewählte Menge ist {quantity}"
   },
   "lCPCxk": {
     "defaultMessage": "Bitte alle Optionen oben auswählen"
@@ -1063,8 +1120,17 @@
   "product_tile.assistive_msg.remove_from_wishlist": {
     "defaultMessage": "{product} aus der Wunschliste entfernt"
   },
-  "product_tile.label.starting_at_price": {
-    "defaultMessage": "Ab {price}"
+  "product_tile.badge.label.new": {
+    "defaultMessage": "Neu"
+  },
+  "product_tile.badge.label.sale": {
+    "defaultMessage": "Sonderangebot"
+  },
+  "product_view.button.add_bundle_to_cart": {
+    "defaultMessage": "Bündel in den Warenkorb legen"
+  },
+  "product_view.button.add_bundle_to_wishlist": {
+    "defaultMessage": "Bündel zur Wunschliste hinzufügen"
   },
   "product_view.button.add_set_to_cart": {
     "defaultMessage": "Set zum Warenkorb hinzufügen"
@@ -1082,10 +1148,10 @@
     "defaultMessage": "Aktualisieren"
   },
   "product_view.label.assistive_msg.quantity_decrement": {
-    "defaultMessage": "Menge verringern"
+    "defaultMessage": "Menge verringern für {productName}"
   },
   "product_view.label.assistive_msg.quantity_increment": {
-    "defaultMessage": "Menge erhöhen"
+    "defaultMessage": "Menge erhöhen für {productName}"
   },
   "product_view.label.quantity": {
     "defaultMessage": "Menge"
@@ -1096,9 +1162,6 @@
   "product_view.label.quantity_increment": {
     "defaultMessage": "+"
   },
-  "product_view.label.starting_at_price": {
-    "defaultMessage": "Ab"
-  },
   "product_view.label.variant_type": {
     "defaultMessage": "{variantType}"
   },
@@ -1151,7 +1214,7 @@
     "defaultMessage": "Es kann losgehen!"
   },
   "register_form.message.agree_to_policy_terms": {
-    "defaultMessage": "Durch das Erstellen eines Kontos stimmen Sie der <policy>Datenschutzerklärung</policy> und den <terms>allgemeinen Geschäftsbedingungen</terms> von Salesforce zu."
+    "defaultMessage": "Durch das Erstellen eines Kontos stimmen Sie der <policy>Datenschutzrichtlinie</policy> und den <terms>Allgemeinen Geschäftsbedingungen</terms> von Salesforce zu."
   },
   "register_form.message.already_have_account": {
     "defaultMessage": "Sie haben bereits ein Konto?"
@@ -1196,6 +1259,15 @@
   "shipping_address.button.continue_to_shipping": {
     "defaultMessage": "Weiter zur Versandmethode"
   },
+  "shipping_address.label.edit_button": {
+    "defaultMessage": "{address} bearbeiten"
+  },
+  "shipping_address.label.remove_button": {
+    "defaultMessage": "{address} entfernen"
+  },
+  "shipping_address.label.shipping_address_form": {
+    "defaultMessage": "Formular für die Lieferadresse"
+  },
   "shipping_address.title.shipping_address": {
     "defaultMessage": "Lieferadresse"
   },
@@ -1241,12 +1313,81 @@
   "signout_confirmation_dialog.message.sure_to_sign_out": {
     "defaultMessage": "Möchten Sie sich wirklich abmelden? Sie müssen sich wieder anmelden, um mit Ihrer aktuellen Bestellung fortzufahren."
   },
+  "store_locator.action.find": {
+    "defaultMessage": "Suchen"
+  },
+  "store_locator.action.select_a_country": {
+    "defaultMessage": "Land auswählen"
+  },
+  "store_locator.action.use_my_location": {
+    "defaultMessage": "Meinen Standort verwenden"
+  },
+  "store_locator.action.viewMore": {
+    "defaultMessage": "Mehr anzeigen"
+  },
+  "store_locator.description.away": {
+    "defaultMessage": "entfernt"
+  },
+  "store_locator.description.loading_locations": {
+    "defaultMessage": "Standorte werden geladen …"
+  },
+  "store_locator.description.no_locations": {
+    "defaultMessage": "Leider gibt es in dieser Gegend keine Standorte."
+  },
+  "store_locator.description.or": {
+    "defaultMessage": "Oder"
+  },
+  "store_locator.description.phone": {
+    "defaultMessage": "Telefon:"
+  },
+  "store_locator.description.viewing_near_postal_code": {
+    "defaultMessage": "Anzeige von Geschäften innerhalb von {distance} {distanceUnit} von {postalCode} in"
+  },
+  "store_locator.description.viewing_near_your_location": {
+    "defaultMessage": "Anzeige von Geschäften in der Nähe Ihres Standorts"
+  },
+  "store_locator.dropdown.germany": {
+    "defaultMessage": "Deutschland"
+  },
+  "store_locator.dropdown.united_states": {
+    "defaultMessage": "USA"
+  },
+  "store_locator.error.agree_to_share_your_location": {
+    "defaultMessage": "Bitte stimmen Sie zu, Ihren Standort zu teilen."
+  },
+  "store_locator.error.please_enter_a_postal_code": {
+    "defaultMessage": "Bitte geben Sie eine Postleitzahl ein."
+  },
+  "store_locator.error.please_select_a_country": {
+    "defaultMessage": "Bitte wählen Sie ein Land aus."
+  },
+  "store_locator.field.placeholder.enter_postal_code": {
+    "defaultMessage": "Postleitzahl eingeben"
+  },
+  "store_locator.pagination.load_more": {
+    "defaultMessage": "Mehr laden"
+  },
+  "store_locator.title": {
+    "defaultMessage": "Ein Geschäft finden"
+  },
   "swatch_group.selected.label": {
     "defaultMessage": "{label}:"
   },
   "toggle_card.action.edit": {
     "defaultMessage": "Bearbeiten"
   },
+  "toggle_card.action.editContactInfo": {
+    "defaultMessage": "Kontaktinformationen bearbeiten"
+  },
+  "toggle_card.action.editPaymentInfo": {
+    "defaultMessage": "Zahlungsinformationen bearbeiten"
+  },
+  "toggle_card.action.editShippingAddress": {
+    "defaultMessage": "Lieferadresse bearbeiten"
+  },
+  "toggle_card.action.editShippingOptions": {
+    "defaultMessage": "Versandoptionen bearbeiten"
+  },
   "update_password_fields.button.forgot_password": {
     "defaultMessage": "Passwort vergessen?"
   },
@@ -1260,7 +1401,8 @@
     "defaultMessage": "Bitte geben Sie Ihre Telefonnummer ein."
   },
   "use_address_fields.error.please_enter_your_postal_or_zip": {
-    "defaultMessage": "Bitte geben Sie Ihre Postleitzahl ein."
+    "defaultMessage": "Bitte geben Sie Ihre Postleitzahl ein.",
+    "description": "Error message for a blank zip code (US-specific checkout)"
   },
   "use_address_fields.error.please_select_your_address": {
     "defaultMessage": "Bitte geben Sie Ihre Adresse ein."
@@ -1272,7 +1414,8 @@
     "defaultMessage": "Bitte wählen Sie Ihr Land aus."
   },
   "use_address_fields.error.please_select_your_state_or_province": {
-    "defaultMessage": "Bitte wählen Sie Ihr Bundesland aus."
+    "defaultMessage": "Bitte wählen Sie Ihr Bundesland aus.",
+    "description": "Error message for a blank state (US-specific checkout)"
   },
   "use_address_fields.error.required": {
     "defaultMessage": "Erforderlich"
@@ -1373,9 +1516,15 @@
   "use_product.message.inventory_remaining": {
     "defaultMessage": "Nur noch {stockLevel} vorhanden!"
   },
+  "use_product.message.inventory_remaining_for_product": {
+    "defaultMessage": "Nur noch {stockLevel} von {productName} vorhanden!"
+  },
   "use_product.message.out_of_stock": {
     "defaultMessage": "Nicht vorrätig"
   },
+  "use_product.message.out_of_stock_for_product": {
+    "defaultMessage": "Nicht vorrätig für {productName}"
+  },
   "use_profile_fields.error.required_email": {
     "defaultMessage": "Bitte geben Sie eine gültige E-Mail-Adresse ein."
   },
@@ -1490,24 +1639,39 @@
   "use_update_password_fields.label.new_password": {
     "defaultMessage": "Neues Passwort"
   },
+  "wishlist_primary_action.button.addSetToCart.label": {
+    "defaultMessage": "{productName}-Set im Warenkorb ablegen"
+  },
+  "wishlist_primary_action.button.addToCart.label": {
+    "defaultMessage": "{productName} im Warenkorb ablegen"
+  },
   "wishlist_primary_action.button.add_set_to_cart": {
     "defaultMessage": "Set zum Warenkorb hinzufügen"
   },
   "wishlist_primary_action.button.add_to_cart": {
     "defaultMessage": "In den Warenkorb"
   },
+  "wishlist_primary_action.button.viewFullDetails.label": {
+    "defaultMessage": "Vollständige Details anzeigen für {productName}"
+  },
   "wishlist_primary_action.button.view_full_details": {
     "defaultMessage": "Alle Einzelheiten anzeigen"
   },
   "wishlist_primary_action.button.view_options": {
     "defaultMessage": "Optionen anzeigen"
   },
+  "wishlist_primary_action.button.view_options.label": {
+    "defaultMessage": "Optionen anzeigen für {productName}"
+  },
   "wishlist_primary_action.info.added_to_cart": {
     "defaultMessage": "{quantity} {quantity, plural, one {Artikel} other {Artikel}} zum Warenkorb hinzugefügt"
   },
   "wishlist_secondary_button_group.action.remove": {
     "defaultMessage": "Entfernen"
   },
+  "wishlist_secondary_button_group.info.item.remove.label": {
+    "defaultMessage": "{productName} entfernen"
+  },
   "wishlist_secondary_button_group.info.item_removed": {
     "defaultMessage": "Artikel aus der Wunschliste entfernt"
   },
diff --git a/packages/template-retail-react-app/translations/en-GB.json b/packages/template-retail-react-app/translations/en-GB.json
index c6e5c939e7..34d01ab939 100644
--- a/packages/template-retail-react-app/translations/en-GB.json
+++ b/packages/template-retail-react-app/translations/en-GB.json
@@ -796,9 +796,6 @@
   "icons.assistive_msg.lock": {
     "defaultMessage": "Secure"
   },
-  "item_attributes.label.is_bonus_product": {
-    "defaultMessage": "Bonus Product"
-  },
   "item_attributes.label.promotions": {
     "defaultMessage": "Promotions"
   },
@@ -1406,63 +1403,6 @@
   "social_login_redirect.message.redirect_link": {
     "defaultMessage": "If you are not automatically redirected, click <link>this link</link> to proceed."
   },
-  "store_locator.action.find": {
-    "defaultMessage": "Find"
-  },
-  "store_locator.action.select_a_country": {
-    "defaultMessage": "Select a country"
-  },
-  "store_locator.action.use_my_location": {
-    "defaultMessage": "Use My Location"
-  },
-  "store_locator.action.viewMore": {
-    "defaultMessage": "View More"
-  },
-  "store_locator.description.away": {
-    "defaultMessage": "away"
-  },
-  "store_locator.description.loading_locations": {
-    "defaultMessage": "Loading locations..."
-  },
-  "store_locator.description.no_locations": {
-    "defaultMessage": "Sorry, there are no locations in this area"
-  },
-  "store_locator.description.or": {
-    "defaultMessage": "Or"
-  },
-  "store_locator.description.phone": {
-    "defaultMessage": "Phone:"
-  },
-  "store_locator.description.viewing_near_postal_code": {
-    "defaultMessage": "Viewing stores within {distance}{distanceUnit} of {postalCode} in"
-  },
-  "store_locator.description.viewing_near_your_location": {
-    "defaultMessage": "Viewing stores near your location"
-  },
-  "store_locator.dropdown.germany": {
-    "defaultMessage": "Germany"
-  },
-  "store_locator.dropdown.united_states": {
-    "defaultMessage": "United States"
-  },
-  "store_locator.error.agree_to_share_your_location": {
-    "defaultMessage": "Please agree to share your location"
-  },
-  "store_locator.error.please_enter_a_postal_code": {
-    "defaultMessage": "Please enter a postal code."
-  },
-  "store_locator.error.please_select_a_country": {
-    "defaultMessage": "Please select a country."
-  },
-  "store_locator.field.placeholder.enter_postal_code": {
-    "defaultMessage": "Enter postal code"
-  },
-  "store_locator.pagination.load_more": {
-    "defaultMessage": "Load More"
-  },
-  "store_locator.title": {
-    "defaultMessage": "Find a Store"
-  },
   "swatch_group.selected.label": {
     "defaultMessage": "{label}:"
   },
diff --git a/packages/template-retail-react-app/translations/en-US.json b/packages/template-retail-react-app/translations/en-US.json
index c6e5c939e7..34d01ab939 100644
--- a/packages/template-retail-react-app/translations/en-US.json
+++ b/packages/template-retail-react-app/translations/en-US.json
@@ -796,9 +796,6 @@
   "icons.assistive_msg.lock": {
     "defaultMessage": "Secure"
   },
-  "item_attributes.label.is_bonus_product": {
-    "defaultMessage": "Bonus Product"
-  },
   "item_attributes.label.promotions": {
     "defaultMessage": "Promotions"
   },
@@ -1406,63 +1403,6 @@
   "social_login_redirect.message.redirect_link": {
     "defaultMessage": "If you are not automatically redirected, click <link>this link</link> to proceed."
   },
-  "store_locator.action.find": {
-    "defaultMessage": "Find"
-  },
-  "store_locator.action.select_a_country": {
-    "defaultMessage": "Select a country"
-  },
-  "store_locator.action.use_my_location": {
-    "defaultMessage": "Use My Location"
-  },
-  "store_locator.action.viewMore": {
-    "defaultMessage": "View More"
-  },
-  "store_locator.description.away": {
-    "defaultMessage": "away"
-  },
-  "store_locator.description.loading_locations": {
-    "defaultMessage": "Loading locations..."
-  },
-  "store_locator.description.no_locations": {
-    "defaultMessage": "Sorry, there are no locations in this area"
-  },
-  "store_locator.description.or": {
-    "defaultMessage": "Or"
-  },
-  "store_locator.description.phone": {
-    "defaultMessage": "Phone:"
-  },
-  "store_locator.description.viewing_near_postal_code": {
-    "defaultMessage": "Viewing stores within {distance}{distanceUnit} of {postalCode} in"
-  },
-  "store_locator.description.viewing_near_your_location": {
-    "defaultMessage": "Viewing stores near your location"
-  },
-  "store_locator.dropdown.germany": {
-    "defaultMessage": "Germany"
-  },
-  "store_locator.dropdown.united_states": {
-    "defaultMessage": "United States"
-  },
-  "store_locator.error.agree_to_share_your_location": {
-    "defaultMessage": "Please agree to share your location"
-  },
-  "store_locator.error.please_enter_a_postal_code": {
-    "defaultMessage": "Please enter a postal code."
-  },
-  "store_locator.error.please_select_a_country": {
-    "defaultMessage": "Please select a country."
-  },
-  "store_locator.field.placeholder.enter_postal_code": {
-    "defaultMessage": "Enter postal code"
-  },
-  "store_locator.pagination.load_more": {
-    "defaultMessage": "Load More"
-  },
-  "store_locator.title": {
-    "defaultMessage": "Find a Store"
-  },
   "swatch_group.selected.label": {
     "defaultMessage": "{label}:"
   },
diff --git a/packages/template-retail-react-app/translations/es-MX.json b/packages/template-retail-react-app/translations/es-MX.json
index 83b1b23661..fe16e2a22e 100644
--- a/packages/template-retail-react-app/translations/es-MX.json
+++ b/packages/template-retail-react-app/translations/es-MX.json
@@ -174,6 +174,9 @@
   "cart.info.removed_from_cart": {
     "defaultMessage": "Artículo eliminado del carrito"
   },
+  "cart.product_edit_modal.modal_label": {
+    "defaultMessage": "Editar modal para {productName}"
+  },
   "cart.recommended_products.title.may_also_like": {
     "defaultMessage": "Quizás también te guste"
   },
@@ -204,6 +207,9 @@
   "cart_title.title.cart_num_of_items": {
     "defaultMessage": "Carrito ({itemCount, plural, =0 {0 artículos} one {# artículo} other {# artículos}})"
   },
+  "category_links.button_text": {
+    "defaultMessage": "Categorías"
+  },
   "cc_radio_group.action.remove": {
     "defaultMessage": "Eliminar"
   },
@@ -261,6 +267,9 @@
   "checkout_confirmation.label.shipping": {
     "defaultMessage": "Envío"
   },
+  "checkout_confirmation.label.shipping.strikethrough.price": {
+    "defaultMessage": "Originalmente {originalPrice}, ahora {newPrice}"
+  },
   "checkout_confirmation.label.subtotal": {
     "defaultMessage": "Subtotal"
   },
@@ -319,6 +328,9 @@
   "checkout_payment.heading.credit_card": {
     "defaultMessage": "Tarjeta de crédito"
   },
+  "checkout_payment.label.billing_address_form": {
+    "defaultMessage": "Formulario de dirección de facturación"
+  },
   "checkout_payment.label.same_as_shipping": {
     "defaultMessage": "Misma que la dirección de envío"
   },
@@ -334,6 +346,12 @@
   "confirmation_modal.default.action.yes": {
     "defaultMessage": "Sí"
   },
+  "confirmation_modal.default.assistive_msg.no": {
+    "defaultMessage": "No, cancelar acción"
+  },
+  "confirmation_modal.default.assistive_msg.yes": {
+    "defaultMessage": "Sí, confirme la acción"
+  },
   "confirmation_modal.default.message.you_want_to_continue": {
     "defaultMessage": "¿Está seguro de que desea continuar?"
   },
@@ -349,6 +367,15 @@
   "confirmation_modal.remove_cart_item.action.yes": {
     "defaultMessage": "Sí, eliminar artículo"
   },
+  "confirmation_modal.remove_cart_item.assistive_msg.no": {
+    "defaultMessage": "No, conservar artículo"
+  },
+  "confirmation_modal.remove_cart_item.assistive_msg.remove": {
+    "defaultMessage": "Eliminar productos no disponibles"
+  },
+  "confirmation_modal.remove_cart_item.assistive_msg.yes": {
+    "defaultMessage": "Sí, eliminar artículo"
+  },
   "confirmation_modal.remove_cart_item.message.need_to_remove_due_to_unavailability": {
     "defaultMessage": "Algunos artículos ya no están disponibles en línea y se eliminarán de su carrito."
   },
@@ -405,6 +432,21 @@
   "credit_card_fields.tool_tip.security_code_aria_label": {
     "defaultMessage": "Información del código de seguridad"
   },
+  "display_price.assistive_msg.current_price": {
+    "defaultMessage": "precio actual {currentPrice}"
+  },
+  "display_price.assistive_msg.current_price_with_range": {
+    "defaultMessage": "A partir del precio actual {currentPrice}"
+  },
+  "display_price.assistive_msg.strikethrough_price": {
+    "defaultMessage": "precio original {listPrice}"
+  },
+  "display_price.assistive_msg.strikethrough_price_with_range": {
+    "defaultMessage": "Desde el precio original {listPrice}"
+  },
+  "display_price.label.current_price_with_range": {
+    "defaultMessage": "De {currentPrice}"
+  },
   "drawer_menu.button.account_details": {
     "defaultMessage": "Detalles de la cuenta"
   },
@@ -420,6 +462,9 @@
   "drawer_menu.button.order_history": {
     "defaultMessage": "Historial de pedidos"
   },
+  "drawer_menu.header.assistive_msg.title": {
+    "defaultMessage": "Cajón de menú"
+  },
   "drawer_menu.link.about_us": {
     "defaultMessage": "Acerca de nosotros"
   },
@@ -445,7 +490,7 @@
     "defaultMessage": "Comprar todo"
   },
   "drawer_menu.link.sign_in": {
-    "defaultMessage": "Registrarte"
+    "defaultMessage": "Registrarse"
   },
   "drawer_menu.link.site_map": {
     "defaultMessage": "Mapa del sitio"
@@ -582,6 +627,9 @@
   "header.button.assistive_msg.menu": {
     "defaultMessage": "Menú"
   },
+  "header.button.assistive_msg.menu.open_dialog": {
+    "defaultMessage": "Abre un cuadro de diálogo"
+  },
   "header.button.assistive_msg.my_account": {
     "defaultMessage": "Mi cuenta"
   },
@@ -591,6 +639,9 @@
   "header.button.assistive_msg.my_cart_with_num_items": {
     "defaultMessage": "Mi carrito, número de artículos: {numItems}"
   },
+  "header.button.assistive_msg.store_locator": {
+    "defaultMessage": "Localizador de tiendas"
+  },
   "header.button.assistive_msg.wishlist": {
     "defaultMessage": "Lista de deseos"
   },
@@ -691,6 +742,9 @@
   "item_attributes.label.quantity": {
     "defaultMessage": "Cantidad: {quantity}"
   },
+  "item_attributes.label.selected_options": {
+    "defaultMessage": "Opciones seleccionadas:"
+  },
   "item_image.label.sale": {
     "defaultMessage": "Ofertas",
     "description": "A sale badge placed on top of a product image"
@@ -699,8 +753,11 @@
     "defaultMessage": "No disponible",
     "description": "A unavailable badge placed on top of a product image"
   },
-  "item_price.label.starting_at": {
-    "defaultMessage": "Comienza en"
+  "item_variant.assistive_msg.quantity": {
+    "defaultMessage": "Cantidad {quantity}"
+  },
+  "item_variant.quantity.label": {
+    "defaultMessage": "Selector de cantidad para {productName}. La cantidad seleccionada es {quantity}"
   },
   "lCPCxk": {
     "defaultMessage": "Seleccione todas las opciones anteriores"
@@ -1063,8 +1120,17 @@
   "product_tile.assistive_msg.remove_from_wishlist": {
     "defaultMessage": "Eliminar {product} de la lista de deseos"
   },
-  "product_tile.label.starting_at_price": {
-    "defaultMessage": "Comienza en {price}"
+  "product_tile.badge.label.new": {
+    "defaultMessage": "Crear"
+  },
+  "product_tile.badge.label.sale": {
+    "defaultMessage": "Ofertas"
+  },
+  "product_view.button.add_bundle_to_cart": {
+    "defaultMessage": "Agregar paquete al carrito"
+  },
+  "product_view.button.add_bundle_to_wishlist": {
+    "defaultMessage": "Añadir paquete a la lista de deseos"
   },
   "product_view.button.add_set_to_cart": {
     "defaultMessage": "Agregar conjunto al carrito"
@@ -1082,10 +1148,10 @@
     "defaultMessage": "Actualización"
   },
   "product_view.label.assistive_msg.quantity_decrement": {
-    "defaultMessage": "Cantidad de decremento"
+    "defaultMessage": "Disminuir la cantidad de {productName}"
   },
   "product_view.label.assistive_msg.quantity_increment": {
-    "defaultMessage": "Incrementar cantidad"
+    "defaultMessage": "Incrementar cantidad de {productName}"
   },
   "product_view.label.quantity": {
     "defaultMessage": "Cantidad"
@@ -1096,9 +1162,6 @@
   "product_view.label.quantity_increment": {
     "defaultMessage": "+"
   },
-  "product_view.label.starting_at_price": {
-    "defaultMessage": "Comienza en"
-  },
   "product_view.label.variant_type": {
     "defaultMessage": "{variantType}"
   },
@@ -1196,6 +1259,15 @@
   "shipping_address.button.continue_to_shipping": {
     "defaultMessage": "Continuar a método de envío"
   },
+  "shipping_address.label.edit_button": {
+    "defaultMessage": "Editar {address}"
+  },
+  "shipping_address.label.remove_button": {
+    "defaultMessage": "Eliminar {address}"
+  },
+  "shipping_address.label.shipping_address_form": {
+    "defaultMessage": "Formulario de dirección de envío"
+  },
   "shipping_address.title.shipping_address": {
     "defaultMessage": "Dirección de envío"
   },
@@ -1241,12 +1313,81 @@
   "signout_confirmation_dialog.message.sure_to_sign_out": {
     "defaultMessage": "¿Está seguro de que desea cerrar sesión? Deberá volver a registrarse para continuar con su pedido actual."
   },
+  "store_locator.action.find": {
+    "defaultMessage": "Encontrar"
+  },
+  "store_locator.action.select_a_country": {
+    "defaultMessage": "Seleccionar un país..."
+  },
+  "store_locator.action.use_my_location": {
+    "defaultMessage": "Usar mi ubicación"
+  },
+  "store_locator.action.viewMore": {
+    "defaultMessage": "Ver más"
+  },
+  "store_locator.description.away": {
+    "defaultMessage": "de distancia"
+  },
+  "store_locator.description.loading_locations": {
+    "defaultMessage": "Lugares de carga..."
+  },
+  "store_locator.description.no_locations": {
+    "defaultMessage": "Lo sentimos, no hay ubicaciones en esta área"
+  },
+  "store_locator.description.or": {
+    "defaultMessage": "O"
+  },
+  "store_locator.description.phone": {
+    "defaultMessage": "Teléfono:"
+  },
+  "store_locator.description.viewing_near_postal_code": {
+    "defaultMessage": "Visualización de tiendas dentro {distance}{distanceUnit} de {postalCode} en"
+  },
+  "store_locator.description.viewing_near_your_location": {
+    "defaultMessage": "Ver tiendas cerca de tu ubicación"
+  },
+  "store_locator.dropdown.germany": {
+    "defaultMessage": "Alemania"
+  },
+  "store_locator.dropdown.united_states": {
+    "defaultMessage": "Estados Unidos"
+  },
+  "store_locator.error.agree_to_share_your_location": {
+    "defaultMessage": "Acepte compartir su ubicación"
+  },
+  "store_locator.error.please_enter_a_postal_code": {
+    "defaultMessage": "Introduzca un código postal."
+  },
+  "store_locator.error.please_select_a_country": {
+    "defaultMessage": "Seleccione un país."
+  },
+  "store_locator.field.placeholder.enter_postal_code": {
+    "defaultMessage": "Ingrese el código postal"
+  },
+  "store_locator.pagination.load_more": {
+    "defaultMessage": "Cargar más"
+  },
+  "store_locator.title": {
+    "defaultMessage": "Buscar una tienda"
+  },
   "swatch_group.selected.label": {
     "defaultMessage": "{label}:"
   },
   "toggle_card.action.edit": {
     "defaultMessage": "Editar"
   },
+  "toggle_card.action.editContactInfo": {
+    "defaultMessage": "Editar información de contacto"
+  },
+  "toggle_card.action.editPaymentInfo": {
+    "defaultMessage": "Editar información de pago"
+  },
+  "toggle_card.action.editShippingAddress": {
+    "defaultMessage": "Editar dirección de envío"
+  },
+  "toggle_card.action.editShippingOptions": {
+    "defaultMessage": "Editar opciones de envío"
+  },
   "update_password_fields.button.forgot_password": {
     "defaultMessage": "¿Olvidó la contraseña?"
   },
@@ -1260,7 +1401,8 @@
     "defaultMessage": "Ingrese su número de teléfono."
   },
   "use_address_fields.error.please_enter_your_postal_or_zip": {
-    "defaultMessage": "Ingrese su código postal."
+    "defaultMessage": "Ingrese su código postal.",
+    "description": "Error message for a blank zip code (US-specific checkout)"
   },
   "use_address_fields.error.please_select_your_address": {
     "defaultMessage": "Ingrese su dirección."
@@ -1272,7 +1414,8 @@
     "defaultMessage": "Seleccione su país."
   },
   "use_address_fields.error.please_select_your_state_or_province": {
-    "defaultMessage": "Seleccione su estado/provincia."
+    "defaultMessage": "Seleccione su estado.",
+    "description": "Error message for a blank state (US-specific checkout)"
   },
   "use_address_fields.error.required": {
     "defaultMessage": "Obligatorio"
@@ -1373,9 +1516,15 @@
   "use_product.message.inventory_remaining": {
     "defaultMessage": "¡Solo quedan {stockLevel}!"
   },
+  "use_product.message.inventory_remaining_for_product": {
+    "defaultMessage": "¡Solo {stockLevel} queda para {productName}!"
+  },
   "use_product.message.out_of_stock": {
     "defaultMessage": "Agotado"
   },
+  "use_product.message.out_of_stock_for_product": {
+    "defaultMessage": "Agotado para {productName}"
+  },
   "use_profile_fields.error.required_email": {
     "defaultMessage": "Introduzca una dirección de correo electrónico válida."
   },
@@ -1490,24 +1639,39 @@
   "use_update_password_fields.label.new_password": {
     "defaultMessage": "Contraseña nueva"
   },
+  "wishlist_primary_action.button.addSetToCart.label": {
+    "defaultMessage": "Agregar conjunto de {productName} al carrito"
+  },
+  "wishlist_primary_action.button.addToCart.label": {
+    "defaultMessage": "Agregar {productName} al carrito"
+  },
   "wishlist_primary_action.button.add_set_to_cart": {
     "defaultMessage": "Agregar conjunto al carrito"
   },
   "wishlist_primary_action.button.add_to_cart": {
     "defaultMessage": "Agregar al carrito"
   },
+  "wishlist_primary_action.button.viewFullDetails.label": {
+    "defaultMessage": "Ver todos los detalles de {productName}"
+  },
   "wishlist_primary_action.button.view_full_details": {
     "defaultMessage": "Ver toda la información"
   },
   "wishlist_primary_action.button.view_options": {
     "defaultMessage": "Ver opciones"
   },
+  "wishlist_primary_action.button.view_options.label": {
+    "defaultMessage": "Ver opciones para {productName}"
+  },
   "wishlist_primary_action.info.added_to_cart": {
     "defaultMessage": "{quantity} {quantity, plural, one {artículo} other {artículos}} agregado(s) al carrito"
   },
   "wishlist_secondary_button_group.action.remove": {
     "defaultMessage": "Eliminar"
   },
+  "wishlist_secondary_button_group.info.item.remove.label": {
+    "defaultMessage": "Eliminar {productName}"
+  },
   "wishlist_secondary_button_group.info.item_removed": {
     "defaultMessage": "Artículo eliminado de la lista de deseos"
   },
diff --git a/packages/template-retail-react-app/translations/fr-FR.json b/packages/template-retail-react-app/translations/fr-FR.json
index 361367b97f..5a8c2c9493 100644
--- a/packages/template-retail-react-app/translations/fr-FR.json
+++ b/packages/template-retail-react-app/translations/fr-FR.json
@@ -174,6 +174,9 @@
   "cart.info.removed_from_cart": {
     "defaultMessage": "Article supprimé du panier"
   },
+  "cart.product_edit_modal.modal_label": {
+    "defaultMessage": "Modifier la fenêtre modale pour {productName}"
+  },
   "cart.recommended_products.title.may_also_like": {
     "defaultMessage": "Vous aimerez peut-être aussi"
   },
@@ -204,6 +207,9 @@
   "cart_title.title.cart_num_of_items": {
     "defaultMessage": "Panier ({itemCount, plural, =0 {0 article} one {# article} other {# articles}})"
   },
+  "category_links.button_text": {
+    "defaultMessage": "Catégories"
+  },
   "cc_radio_group.action.remove": {
     "defaultMessage": "Supprimer"
   },
@@ -261,6 +267,9 @@
   "checkout_confirmation.label.shipping": {
     "defaultMessage": "Livraison"
   },
+  "checkout_confirmation.label.shipping.strikethrough.price": {
+    "defaultMessage": "À l’origine {originalPrice}, aujourd’hui {newPrice}"
+  },
   "checkout_confirmation.label.subtotal": {
     "defaultMessage": "Sous-total"
   },
@@ -319,6 +328,9 @@
   "checkout_payment.heading.credit_card": {
     "defaultMessage": "Carte de crédit"
   },
+  "checkout_payment.label.billing_address_form": {
+    "defaultMessage": "Formulaire d’adresse de facturation"
+  },
   "checkout_payment.label.same_as_shipping": {
     "defaultMessage": "Identique à l’adresse de livraison"
   },
@@ -334,6 +346,12 @@
   "confirmation_modal.default.action.yes": {
     "defaultMessage": "Oui"
   },
+  "confirmation_modal.default.assistive_msg.no": {
+    "defaultMessage": "Non, annuler l’action"
+  },
+  "confirmation_modal.default.assistive_msg.yes": {
+    "defaultMessage": "Oui, confirmer l’action"
+  },
   "confirmation_modal.default.message.you_want_to_continue": {
     "defaultMessage": "Voulez-vous vraiment continuer ?"
   },
@@ -349,6 +367,15 @@
   "confirmation_modal.remove_cart_item.action.yes": {
     "defaultMessage": "Oui, supprimer l’article"
   },
+  "confirmation_modal.remove_cart_item.assistive_msg.no": {
+    "defaultMessage": "Non, garder l’article"
+  },
+  "confirmation_modal.remove_cart_item.assistive_msg.remove": {
+    "defaultMessage": "Supprimer les produits non disponibles"
+  },
+  "confirmation_modal.remove_cart_item.assistive_msg.yes": {
+    "defaultMessage": "Oui, supprimer l’article"
+  },
   "confirmation_modal.remove_cart_item.message.need_to_remove_due_to_unavailability": {
     "defaultMessage": "Certains articles ne sont plus disponibles en ligne et seront supprimés de votre panier."
   },
@@ -405,6 +432,21 @@
   "credit_card_fields.tool_tip.security_code_aria_label": {
     "defaultMessage": "Cryptogramme"
   },
+  "display_price.assistive_msg.current_price": {
+    "defaultMessage": "prix actuel {currentPrice}"
+  },
+  "display_price.assistive_msg.current_price_with_range": {
+    "defaultMessage": "À partir du prix actuel {currentPrice}"
+  },
+  "display_price.assistive_msg.strikethrough_price": {
+    "defaultMessage": "prix d’origine {listPrice}"
+  },
+  "display_price.assistive_msg.strikethrough_price_with_range": {
+    "defaultMessage": "À partir du prix d’origine {listPrice}"
+  },
+  "display_price.label.current_price_with_range": {
+    "defaultMessage": "Du {currentPrice}"
+  },
   "drawer_menu.button.account_details": {
     "defaultMessage": "Détails du compte"
   },
@@ -420,6 +462,9 @@
   "drawer_menu.button.order_history": {
     "defaultMessage": "Historique des commandes"
   },
+  "drawer_menu.header.assistive_msg.title": {
+    "defaultMessage": "Tiroir de menu"
+  },
   "drawer_menu.link.about_us": {
     "defaultMessage": "À propos de nous"
   },
@@ -582,6 +627,9 @@
   "header.button.assistive_msg.menu": {
     "defaultMessage": "Menu"
   },
+  "header.button.assistive_msg.menu.open_dialog": {
+    "defaultMessage": "Ouvre une boîte de dialogue"
+  },
   "header.button.assistive_msg.my_account": {
     "defaultMessage": "Mon compte"
   },
@@ -591,6 +639,9 @@
   "header.button.assistive_msg.my_cart_with_num_items": {
     "defaultMessage": "Mon panier, nombre d’articles : {numItems}"
   },
+  "header.button.assistive_msg.store_locator": {
+    "defaultMessage": "Localisateur de magasins"
+  },
   "header.button.assistive_msg.wishlist": {
     "defaultMessage": "Liste de souhaits"
   },
@@ -691,16 +742,22 @@
   "item_attributes.label.quantity": {
     "defaultMessage": "Quantité : {quantity}"
   },
+  "item_attributes.label.selected_options": {
+    "defaultMessage": "Options sélectionnées"
+  },
   "item_image.label.sale": {
-    "defaultMessage": "Vente",
+    "defaultMessage": "En solde",
     "description": "A sale badge placed on top of a product image"
   },
   "item_image.label.unavailable": {
     "defaultMessage": "Non disponible",
     "description": "A unavailable badge placed on top of a product image"
   },
-  "item_price.label.starting_at": {
-    "defaultMessage": "À partir de"
+  "item_variant.assistive_msg.quantity": {
+    "defaultMessage": "Quantité {quantity}"
+  },
+  "item_variant.quantity.label": {
+    "defaultMessage": "Sélecteur de quantité pour {productName}. La quantité sélectionnée est {quantity}"
   },
   "lCPCxk": {
     "defaultMessage": "Sélectionnez toutes vos options ci-dessus"
@@ -1063,8 +1120,17 @@
   "product_tile.assistive_msg.remove_from_wishlist": {
     "defaultMessage": "Supprimer {product} de la liste de souhaits"
   },
-  "product_tile.label.starting_at_price": {
-    "defaultMessage": "À partir de {price}"
+  "product_tile.badge.label.new": {
+    "defaultMessage": "Nouveau"
+  },
+  "product_tile.badge.label.sale": {
+    "defaultMessage": "En solde"
+  },
+  "product_view.button.add_bundle_to_cart": {
+    "defaultMessage": "Ajouter l’offre groupée au panier"
+  },
+  "product_view.button.add_bundle_to_wishlist": {
+    "defaultMessage": "Ajouter l’offre groupée à la liste de souhaits"
   },
   "product_view.button.add_set_to_cart": {
     "defaultMessage": "Ajouter le lot au panier"
@@ -1082,10 +1148,10 @@
     "defaultMessage": "Mettre à jour"
   },
   "product_view.label.assistive_msg.quantity_decrement": {
-    "defaultMessage": "Décrémenter la quantité"
+    "defaultMessage": "Décrémenter la quantité pour {productName}"
   },
   "product_view.label.assistive_msg.quantity_increment": {
-    "defaultMessage": "Incrémenter la quantité"
+    "defaultMessage": "Incrémenter la quantité pour {productName}"
   },
   "product_view.label.quantity": {
     "defaultMessage": "Quantité"
@@ -1096,9 +1162,6 @@
   "product_view.label.quantity_increment": {
     "defaultMessage": "+"
   },
-  "product_view.label.starting_at_price": {
-    "defaultMessage": "À partir de"
-  },
   "product_view.label.variant_type": {
     "defaultMessage": "{variantType}"
   },
@@ -1196,6 +1259,15 @@
   "shipping_address.button.continue_to_shipping": {
     "defaultMessage": "Continuer vers le mode de livraison"
   },
+  "shipping_address.label.edit_button": {
+    "defaultMessage": "Modifier {address}"
+  },
+  "shipping_address.label.remove_button": {
+    "defaultMessage": "Supprimer {address}"
+  },
+  "shipping_address.label.shipping_address_form": {
+    "defaultMessage": "Formulaire d’adresse de livraison"
+  },
   "shipping_address.title.shipping_address": {
     "defaultMessage": "Adresse de livraison"
   },
@@ -1241,12 +1313,81 @@
   "signout_confirmation_dialog.message.sure_to_sign_out": {
     "defaultMessage": "Voulez-vous vraiment vous déconnecter ? Vous devrez vous reconnecter pour poursuivre votre commande en cours."
   },
+  "store_locator.action.find": {
+    "defaultMessage": "Rechercher"
+  },
+  "store_locator.action.select_a_country": {
+    "defaultMessage": "Sélectionner un pays"
+  },
+  "store_locator.action.use_my_location": {
+    "defaultMessage": "Utiliser mon emplacement"
+  },
+  "store_locator.action.viewMore": {
+    "defaultMessage": "Afficher plus"
+  },
+  "store_locator.description.away": {
+    "defaultMessage": "à"
+  },
+  "store_locator.description.loading_locations": {
+    "defaultMessage": "Lieux de chargement..."
+  },
+  "store_locator.description.no_locations": {
+    "defaultMessage": "Désolé, il n’y a pas d’emplacements dans cette zone"
+  },
+  "store_locator.description.or": {
+    "defaultMessage": "Ou"
+  },
+  "store_locator.description.phone": {
+    "defaultMessage": "Téléphone :"
+  },
+  "store_locator.description.viewing_near_postal_code": {
+    "defaultMessage": "Affichage des magasins à moins de {distance} {distanceUnit} de {postalCode} dans ce pays :"
+  },
+  "store_locator.description.viewing_near_your_location": {
+    "defaultMessage": "Affichage des magasins à proximité de votre emplacement"
+  },
+  "store_locator.dropdown.germany": {
+    "defaultMessage": "Allemagne"
+  },
+  "store_locator.dropdown.united_states": {
+    "defaultMessage": "États-Unis"
+  },
+  "store_locator.error.agree_to_share_your_location": {
+    "defaultMessage": "Veuillez accepter de partager votre emplacement"
+  },
+  "store_locator.error.please_enter_a_postal_code": {
+    "defaultMessage": "Veuillez saisir un code postal."
+  },
+  "store_locator.error.please_select_a_country": {
+    "defaultMessage": "Veuillez sélectionner un pays."
+  },
+  "store_locator.field.placeholder.enter_postal_code": {
+    "defaultMessage": "Entrer un code postal"
+  },
+  "store_locator.pagination.load_more": {
+    "defaultMessage": "Charger plus de résultats"
+  },
+  "store_locator.title": {
+    "defaultMessage": "Trouver un magasin"
+  },
   "swatch_group.selected.label": {
     "defaultMessage": "{label} :"
   },
   "toggle_card.action.edit": {
     "defaultMessage": "Modifier"
   },
+  "toggle_card.action.editContactInfo": {
+    "defaultMessage": "Modifier les coordonnées"
+  },
+  "toggle_card.action.editPaymentInfo": {
+    "defaultMessage": "Modifier les informations de paiement"
+  },
+  "toggle_card.action.editShippingAddress": {
+    "defaultMessage": "Modifier l’adresse de livraison"
+  },
+  "toggle_card.action.editShippingOptions": {
+    "defaultMessage": "Modifier les options de livraison"
+  },
   "update_password_fields.button.forgot_password": {
     "defaultMessage": "Mot de passe oublié ?"
   },
@@ -1260,7 +1401,8 @@
     "defaultMessage": "Veuillez indiquer votre numéro de téléphone."
   },
   "use_address_fields.error.please_enter_your_postal_or_zip": {
-    "defaultMessage": "Veuillez indiquer votre code postal."
+    "defaultMessage": "Veuillez indiquer votre code postal.",
+    "description": "Error message for a blank zip code (US-specific checkout)"
   },
   "use_address_fields.error.please_select_your_address": {
     "defaultMessage": "Veuillez indiquer votre adresse."
@@ -1272,7 +1414,8 @@
     "defaultMessage": "Veuillez sélectionner votre pays."
   },
   "use_address_fields.error.please_select_your_state_or_province": {
-    "defaultMessage": "Veuillez sélectionner votre État/province."
+    "defaultMessage": "Veuillez sélectionner votre État/province.",
+    "description": "Error message for a blank state (US-specific checkout)"
   },
   "use_address_fields.error.required": {
     "defaultMessage": "Obligatoire"
@@ -1373,9 +1516,15 @@
   "use_product.message.inventory_remaining": {
     "defaultMessage": "Il n’en reste plus que {stockLevel} !"
   },
+  "use_product.message.inventory_remaining_for_product": {
+    "defaultMessage": "Il ne reste plus que {stockLevel} articles pour {productName} !"
+  },
   "use_product.message.out_of_stock": {
     "defaultMessage": "En rupture de stock"
   },
+  "use_product.message.out_of_stock_for_product": {
+    "defaultMessage": "Rupture de stock pour {productName}"
+  },
   "use_profile_fields.error.required_email": {
     "defaultMessage": "Saisissez une adresse e-mail valide."
   },
@@ -1490,24 +1639,39 @@
   "use_update_password_fields.label.new_password": {
     "defaultMessage": "Nouveau mot de passe"
   },
+  "wishlist_primary_action.button.addSetToCart.label": {
+    "defaultMessage": "Ajouter le lot {productName} au panier"
+  },
+  "wishlist_primary_action.button.addToCart.label": {
+    "defaultMessage": "Ajouter le {productName} au panier"
+  },
   "wishlist_primary_action.button.add_set_to_cart": {
     "defaultMessage": "Ajouter le lot au panier"
   },
   "wishlist_primary_action.button.add_to_cart": {
     "defaultMessage": "Ajouter au panier"
   },
+  "wishlist_primary_action.button.viewFullDetails.label": {
+    "defaultMessage": "Afficher tous les détails pour {productName}"
+  },
   "wishlist_primary_action.button.view_full_details": {
     "defaultMessage": "Afficher tous les détails"
   },
   "wishlist_primary_action.button.view_options": {
     "defaultMessage": "Afficher les options"
   },
+  "wishlist_primary_action.button.view_options.label": {
+    "defaultMessage": "Afficher les options pour {productName}"
+  },
   "wishlist_primary_action.info.added_to_cart": {
     "defaultMessage": "{quantity} {quantity, plural, one {article ajouté} other {articles ajoutés}} au panier"
   },
   "wishlist_secondary_button_group.action.remove": {
     "defaultMessage": "Supprimer"
   },
+  "wishlist_secondary_button_group.info.item.remove.label": {
+    "defaultMessage": "Supprimer {productName}"
+  },
   "wishlist_secondary_button_group.info.item_removed": {
     "defaultMessage": "Article supprimé de la liste de souhaits"
   },
diff --git a/packages/template-retail-react-app/translations/it-IT.json b/packages/template-retail-react-app/translations/it-IT.json
index 2123617bcf..f7a419a2bd 100644
--- a/packages/template-retail-react-app/translations/it-IT.json
+++ b/packages/template-retail-react-app/translations/it-IT.json
@@ -174,6 +174,9 @@
   "cart.info.removed_from_cart": {
     "defaultMessage": "Articolo rimosso dal carrello"
   },
+  "cart.product_edit_modal.modal_label": {
+    "defaultMessage": "Modifica modale per {productName}"
+  },
   "cart.recommended_products.title.may_also_like": {
     "defaultMessage": "Potrebbe interessarti anche"
   },
@@ -204,6 +207,9 @@
   "cart_title.title.cart_num_of_items": {
     "defaultMessage": "Carrello ({itemCount, plural, =0 {0 articoli} one {# articolo} other {# articoli}})"
   },
+  "category_links.button_text": {
+    "defaultMessage": "Categorie"
+  },
   "cc_radio_group.action.remove": {
     "defaultMessage": "Rimuovi"
   },
@@ -261,6 +267,9 @@
   "checkout_confirmation.label.shipping": {
     "defaultMessage": "Spedizione"
   },
+  "checkout_confirmation.label.shipping.strikethrough.price": {
+    "defaultMessage": "Originariamente {originalPrice}, ora {newPrice}"
+  },
   "checkout_confirmation.label.subtotal": {
     "defaultMessage": "Subtotale"
   },
@@ -319,6 +328,9 @@
   "checkout_payment.heading.credit_card": {
     "defaultMessage": "Carta di credito"
   },
+  "checkout_payment.label.billing_address_form": {
+    "defaultMessage": "Modulo indirizzo di fatturazione"
+  },
   "checkout_payment.label.same_as_shipping": {
     "defaultMessage": "Identico all'indirizzo di spedizione"
   },
@@ -334,6 +346,12 @@
   "confirmation_modal.default.action.yes": {
     "defaultMessage": "Sì"
   },
+  "confirmation_modal.default.assistive_msg.no": {
+    "defaultMessage": "No, annulla azione"
+  },
+  "confirmation_modal.default.assistive_msg.yes": {
+    "defaultMessage": "Sì, conferma azione"
+  },
   "confirmation_modal.default.message.you_want_to_continue": {
     "defaultMessage": "Continuare?"
   },
@@ -349,8 +367,17 @@
   "confirmation_modal.remove_cart_item.action.yes": {
     "defaultMessage": "Sì, rimuovi articolo"
   },
+  "confirmation_modal.remove_cart_item.assistive_msg.no": {
+    "defaultMessage": "No, conserva articolo"
+  },
+  "confirmation_modal.remove_cart_item.assistive_msg.remove": {
+    "defaultMessage": "Rimuovi prodotti non disponibili"
+  },
+  "confirmation_modal.remove_cart_item.assistive_msg.yes": {
+    "defaultMessage": "Sì, rimuovi articolo"
+  },
   "confirmation_modal.remove_cart_item.message.need_to_remove_due_to_unavailability": {
-    "defaultMessage": "Alcuni articoli non sono più dispoinibili online e verranno rimossi dal carrello."
+    "defaultMessage": "Alcuni articoli non sono più disponibili online e verranno rimossi dal carrello."
   },
   "confirmation_modal.remove_cart_item.message.sure_to_remove": {
     "defaultMessage": "Rimuovere questo articolo dal carrello?"
@@ -405,6 +432,21 @@
   "credit_card_fields.tool_tip.security_code_aria_label": {
     "defaultMessage": "Info codice di sicurezza"
   },
+  "display_price.assistive_msg.current_price": {
+    "defaultMessage": "prezzo attuale {currentPrice}"
+  },
+  "display_price.assistive_msg.current_price_with_range": {
+    "defaultMessage": "A partire dal prezzo attuale {currentPrice}"
+  },
+  "display_price.assistive_msg.strikethrough_price": {
+    "defaultMessage": "prezzo originale {listPrice}"
+  },
+  "display_price.assistive_msg.strikethrough_price_with_range": {
+    "defaultMessage": "A partire dal prezzo originale {listPrice}"
+  },
+  "display_price.label.current_price_with_range": {
+    "defaultMessage": "Da {currentPrice}"
+  },
   "drawer_menu.button.account_details": {
     "defaultMessage": "Dettagli account"
   },
@@ -420,6 +462,9 @@
   "drawer_menu.button.order_history": {
     "defaultMessage": "Cronologia ordini"
   },
+  "drawer_menu.header.assistive_msg.title": {
+    "defaultMessage": "Cassetto menu"
+  },
   "drawer_menu.link.about_us": {
     "defaultMessage": "Chi siamo"
   },
@@ -582,6 +627,9 @@
   "header.button.assistive_msg.menu": {
     "defaultMessage": "Menu"
   },
+  "header.button.assistive_msg.menu.open_dialog": {
+    "defaultMessage": "Apre una finestra di dialogo"
+  },
   "header.button.assistive_msg.my_account": {
     "defaultMessage": "Il mio account"
   },
@@ -591,6 +639,9 @@
   "header.button.assistive_msg.my_cart_with_num_items": {
     "defaultMessage": "Il mio carrello, numero di articoli: {numItems}"
   },
+  "header.button.assistive_msg.store_locator": {
+    "defaultMessage": "Store locator"
+  },
   "header.button.assistive_msg.wishlist": {
     "defaultMessage": "Lista desideri"
   },
@@ -691,6 +742,9 @@
   "item_attributes.label.quantity": {
     "defaultMessage": "Quantità: {quantity}"
   },
+  "item_attributes.label.selected_options": {
+    "defaultMessage": "Opzioni selezionate"
+  },
   "item_image.label.sale": {
     "defaultMessage": "Saldi",
     "description": "A sale badge placed on top of a product image"
@@ -699,8 +753,11 @@
     "defaultMessage": "Non disponibile",
     "description": "A unavailable badge placed on top of a product image"
   },
-  "item_price.label.starting_at": {
-    "defaultMessage": "A partire da"
+  "item_variant.assistive_msg.quantity": {
+    "defaultMessage": "Quantità {quantity}"
+  },
+  "item_variant.quantity.label": {
+    "defaultMessage": "Selettore di quantità per {productName}. La quantità selezionata è {quantity}"
   },
   "lCPCxk": {
     "defaultMessage": "Selezionare tutte le opzioni sopra riportate"
@@ -1063,8 +1120,17 @@
   "product_tile.assistive_msg.remove_from_wishlist": {
     "defaultMessage": "Rimuovi {product} dalla lista desideri"
   },
-  "product_tile.label.starting_at_price": {
-    "defaultMessage": "A partire da {price}"
+  "product_tile.badge.label.new": {
+    "defaultMessage": "Crea"
+  },
+  "product_tile.badge.label.sale": {
+    "defaultMessage": "Saldi"
+  },
+  "product_view.button.add_bundle_to_cart": {
+    "defaultMessage": "Aggiungi bundle al carrello"
+  },
+  "product_view.button.add_bundle_to_wishlist": {
+    "defaultMessage": "Aggiungi Bundle alla Wishlist"
   },
   "product_view.button.add_set_to_cart": {
     "defaultMessage": "Aggiungi set al carrello"
@@ -1082,10 +1148,10 @@
     "defaultMessage": "Aggiorna"
   },
   "product_view.label.assistive_msg.quantity_decrement": {
-    "defaultMessage": "Riduci quantità"
+    "defaultMessage": "Riduci quantità per {productName}"
   },
   "product_view.label.assistive_msg.quantity_increment": {
-    "defaultMessage": "Incrementa quantità"
+    "defaultMessage": "Aumenta quantità per {productName}"
   },
   "product_view.label.quantity": {
     "defaultMessage": "Quantità"
@@ -1096,9 +1162,6 @@
   "product_view.label.quantity_increment": {
     "defaultMessage": "+"
   },
-  "product_view.label.starting_at_price": {
-    "defaultMessage": "A partire da"
-  },
   "product_view.label.variant_type": {
     "defaultMessage": "{variantType}"
   },
@@ -1196,6 +1259,15 @@
   "shipping_address.button.continue_to_shipping": {
     "defaultMessage": "Passa al metodo di spedizione"
   },
+  "shipping_address.label.edit_button": {
+    "defaultMessage": "Modifica {address}"
+  },
+  "shipping_address.label.remove_button": {
+    "defaultMessage": "Rimuovi {address}"
+  },
+  "shipping_address.label.shipping_address_form": {
+    "defaultMessage": "Modulo indirizzo di spedizione"
+  },
   "shipping_address.title.shipping_address": {
     "defaultMessage": "Indirizzo di spedizione"
   },
@@ -1241,12 +1313,81 @@
   "signout_confirmation_dialog.message.sure_to_sign_out": {
     "defaultMessage": "Uscire? Per procedere con l'ordine corrente devi eseguire di nuovo l'accesso."
   },
+  "store_locator.action.find": {
+    "defaultMessage": "Trova"
+  },
+  "store_locator.action.select_a_country": {
+    "defaultMessage": "Seleziona un Paese"
+  },
+  "store_locator.action.use_my_location": {
+    "defaultMessage": "Usa la mia posizione"
+  },
+  "store_locator.action.viewMore": {
+    "defaultMessage": "Visualizza altri"
+  },
+  "store_locator.description.away": {
+    "defaultMessage": "di distanza"
+  },
+  "store_locator.description.loading_locations": {
+    "defaultMessage": "Caricamento posizioni..."
+  },
+  "store_locator.description.no_locations": {
+    "defaultMessage": "Siamo spiacenti, non ci sono sedi in quest'area"
+  },
+  "store_locator.description.or": {
+    "defaultMessage": "Oppure"
+  },
+  "store_locator.description.phone": {
+    "defaultMessage": "Telefono:"
+  },
+  "store_locator.description.viewing_near_postal_code": {
+    "defaultMessage": "Visualizzazione dei negozi entro {distance} {distanceUnit} da {postalCode} in:"
+  },
+  "store_locator.description.viewing_near_your_location": {
+    "defaultMessage": "Visualizzazione dei negozi vicino alla tua posizione"
+  },
+  "store_locator.dropdown.germany": {
+    "defaultMessage": "Germania"
+  },
+  "store_locator.dropdown.united_states": {
+    "defaultMessage": "Stati Uniti"
+  },
+  "store_locator.error.agree_to_share_your_location": {
+    "defaultMessage": "Accetta di condividere la tua posizione"
+  },
+  "store_locator.error.please_enter_a_postal_code": {
+    "defaultMessage": "Inserisci un codice postale."
+  },
+  "store_locator.error.please_select_a_country": {
+    "defaultMessage": "Seleziona un Paese."
+  },
+  "store_locator.field.placeholder.enter_postal_code": {
+    "defaultMessage": "Inserisci codice postale"
+  },
+  "store_locator.pagination.load_more": {
+    "defaultMessage": "Carica altri"
+  },
+  "store_locator.title": {
+    "defaultMessage": "Trova un negozio"
+  },
   "swatch_group.selected.label": {
     "defaultMessage": "{label}:"
   },
   "toggle_card.action.edit": {
     "defaultMessage": "Modifica"
   },
+  "toggle_card.action.editContactInfo": {
+    "defaultMessage": "Modifica informazioni di contatto"
+  },
+  "toggle_card.action.editPaymentInfo": {
+    "defaultMessage": "Modifica informazioni di pagamento"
+  },
+  "toggle_card.action.editShippingAddress": {
+    "defaultMessage": "Modifica indirizzo di spedizione"
+  },
+  "toggle_card.action.editShippingOptions": {
+    "defaultMessage": "Modifica opzioni di spedizione"
+  },
   "update_password_fields.button.forgot_password": {
     "defaultMessage": "Password dimenticata?"
   },
@@ -1260,7 +1401,8 @@
     "defaultMessage": "Inserisci il numero di telefono."
   },
   "use_address_fields.error.please_enter_your_postal_or_zip": {
-    "defaultMessage": "Inserisci il codice postale."
+    "defaultMessage": "Inserisci il tuo codice postale.",
+    "description": "Error message for a blank zip code (US-specific checkout)"
   },
   "use_address_fields.error.please_select_your_address": {
     "defaultMessage": "Inserisci l'indirizzo."
@@ -1272,7 +1414,8 @@
     "defaultMessage": "Seleziona il Paese."
   },
   "use_address_fields.error.please_select_your_state_or_province": {
-    "defaultMessage": "Seleziona lo stato/la provincia."
+    "defaultMessage": "Seleziona il tuo stato.",
+    "description": "Error message for a blank state (US-specific checkout)"
   },
   "use_address_fields.error.required": {
     "defaultMessage": "Obbligatorio"
@@ -1373,9 +1516,15 @@
   "use_product.message.inventory_remaining": {
     "defaultMessage": "Solo {stockLevel} rimasti!"
   },
+  "use_product.message.inventory_remaining_for_product": {
+    "defaultMessage": "Solo {stockLevel} rimasti per {productName}!"
+  },
   "use_product.message.out_of_stock": {
     "defaultMessage": "Esaurito"
   },
+  "use_product.message.out_of_stock_for_product": {
+    "defaultMessage": "Esaurito per {productName}"
+  },
   "use_profile_fields.error.required_email": {
     "defaultMessage": "Inserisci un indirizzo e-mail valido."
   },
@@ -1434,7 +1583,7 @@
     "defaultMessage": "Inserisci il cognome."
   },
   "use_registration_fields.error.required_password": {
-    "defaultMessage": "Creare una password."
+    "defaultMessage": "Crea una password."
   },
   "use_registration_fields.error.special_character": {
     "defaultMessage": "La password deve contenere almeno un carattere speciale."
@@ -1490,24 +1639,39 @@
   "use_update_password_fields.label.new_password": {
     "defaultMessage": "Nuova password"
   },
+  "wishlist_primary_action.button.addSetToCart.label": {
+    "defaultMessage": "Aggiungi set {productName} al carrello"
+  },
+  "wishlist_primary_action.button.addToCart.label": {
+    "defaultMessage": "Aggiungi {productName} al carrello"
+  },
   "wishlist_primary_action.button.add_set_to_cart": {
     "defaultMessage": "Aggiungi set al carrello"
   },
   "wishlist_primary_action.button.add_to_cart": {
     "defaultMessage": "Aggiungi al carrello"
   },
+  "wishlist_primary_action.button.viewFullDetails.label": {
+    "defaultMessage": "Mostra tutti i dettagli per {productName}"
+  },
   "wishlist_primary_action.button.view_full_details": {
     "defaultMessage": "Mostra tutti i dettagli"
   },
   "wishlist_primary_action.button.view_options": {
     "defaultMessage": "Visualizza opzioni"
   },
+  "wishlist_primary_action.button.view_options.label": {
+    "defaultMessage": "Visualizza opzioni per {productName}"
+  },
   "wishlist_primary_action.info.added_to_cart": {
     "defaultMessage": "{quantity} {quantity, plural, one {articolo aggiunto} other {articoli aggiunti}} al carrello"
   },
   "wishlist_secondary_button_group.action.remove": {
     "defaultMessage": "Rimuovi"
   },
+  "wishlist_secondary_button_group.info.item.remove.label": {
+    "defaultMessage": "Rimuovi {productName}"
+  },
   "wishlist_secondary_button_group.info.item_removed": {
     "defaultMessage": "Articolo rimosso dalla lista desideri"
   },
diff --git a/packages/template-retail-react-app/translations/ja-JP.json b/packages/template-retail-react-app/translations/ja-JP.json
index fe206d8b7e..894fe592bb 100644
--- a/packages/template-retail-react-app/translations/ja-JP.json
+++ b/packages/template-retail-react-app/translations/ja-JP.json
@@ -174,6 +174,9 @@
   "cart.info.removed_from_cart": {
     "defaultMessage": "買い物カゴから商品が削除されました"
   },
+  "cart.product_edit_modal.modal_label": {
+    "defaultMessage": "{productName} のモーダルを編集"
+  },
   "cart.recommended_products.title.may_also_like": {
     "defaultMessage": "こちらもおすすめ"
   },
@@ -204,6 +207,9 @@
   "cart_title.title.cart_num_of_items": {
     "defaultMessage": "買い物カゴ ({itemCount, plural, =0 {0 個の商品} one {# 個の商品} other {# 個の商品}})"
   },
+  "category_links.button_text": {
+    "defaultMessage": "カテゴリ"
+  },
   "cc_radio_group.action.remove": {
     "defaultMessage": "削除"
   },
@@ -261,6 +267,9 @@
   "checkout_confirmation.label.shipping": {
     "defaultMessage": "配送"
   },
+  "checkout_confirmation.label.shipping.strikethrough.price": {
+    "defaultMessage": "元の価格は {originalPrice} だが、現在は {newPrice}"
+  },
   "checkout_confirmation.label.subtotal": {
     "defaultMessage": "小計"
   },
@@ -319,6 +328,9 @@
   "checkout_payment.heading.credit_card": {
     "defaultMessage": "クレジットカード"
   },
+  "checkout_payment.label.billing_address_form": {
+    "defaultMessage": "請求先住所フォーム"
+  },
   "checkout_payment.label.same_as_shipping": {
     "defaultMessage": "配送先住所と同じ"
   },
@@ -334,6 +346,12 @@
   "confirmation_modal.default.action.yes": {
     "defaultMessage": "はい"
   },
+  "confirmation_modal.default.assistive_msg.no": {
+    "defaultMessage": "いいえ、操作をキャンセルします"
+  },
+  "confirmation_modal.default.assistive_msg.yes": {
+    "defaultMessage": "はい、操作を確認します"
+  },
   "confirmation_modal.default.message.you_want_to_continue": {
     "defaultMessage": "続行しますか?"
   },
@@ -349,6 +367,15 @@
   "confirmation_modal.remove_cart_item.action.yes": {
     "defaultMessage": "はい、商品を削除します"
   },
+  "confirmation_modal.remove_cart_item.assistive_msg.no": {
+    "defaultMessage": "いいえ、商品をキープします"
+  },
+  "confirmation_modal.remove_cart_item.assistive_msg.remove": {
+    "defaultMessage": "入手不可の商品を削除"
+  },
+  "confirmation_modal.remove_cart_item.assistive_msg.yes": {
+    "defaultMessage": "はい、商品を削除します"
+  },
   "confirmation_modal.remove_cart_item.message.need_to_remove_due_to_unavailability": {
     "defaultMessage": "一部の商品がオンラインで入手できなくなったため、買い物カゴから削除されます。"
   },
@@ -405,6 +432,21 @@
   "credit_card_fields.tool_tip.security_code_aria_label": {
     "defaultMessage": "セキュリティコード情報"
   },
+  "display_price.assistive_msg.current_price": {
+    "defaultMessage": "現在の価格 {currentPrice}"
+  },
+  "display_price.assistive_msg.current_price_with_range": {
+    "defaultMessage": "現在の価格 {currentPrice} から"
+  },
+  "display_price.assistive_msg.strikethrough_price": {
+    "defaultMessage": "元の価格 {listPrice}"
+  },
+  "display_price.assistive_msg.strikethrough_price_with_range": {
+    "defaultMessage": "元の価格 {listPrice} から"
+  },
+  "display_price.label.current_price_with_range": {
+    "defaultMessage": "{currentPrice} から"
+  },
   "drawer_menu.button.account_details": {
     "defaultMessage": "アカウントの詳細"
   },
@@ -420,6 +462,9 @@
   "drawer_menu.button.order_history": {
     "defaultMessage": "注文履歴"
   },
+  "drawer_menu.header.assistive_msg.title": {
+    "defaultMessage": "ドロワーメニュー"
+  },
   "drawer_menu.link.about_us": {
     "defaultMessage": "企業情報"
   },
@@ -582,6 +627,9 @@
   "header.button.assistive_msg.menu": {
     "defaultMessage": "メニュー"
   },
+  "header.button.assistive_msg.menu.open_dialog": {
+    "defaultMessage": "ダイアログを開く"
+  },
   "header.button.assistive_msg.my_account": {
     "defaultMessage": "マイアカウント"
   },
@@ -591,6 +639,9 @@
   "header.button.assistive_msg.my_cart_with_num_items": {
     "defaultMessage": "マイ買い物カゴ、商品数: {numItems}"
   },
+  "header.button.assistive_msg.store_locator": {
+    "defaultMessage": "店舗検索"
+  },
   "header.button.assistive_msg.wishlist": {
     "defaultMessage": "ほしい物リスト"
   },
@@ -691,6 +742,9 @@
   "item_attributes.label.quantity": {
     "defaultMessage": "数量: {quantity}"
   },
+  "item_attributes.label.selected_options": {
+    "defaultMessage": "選択したオプション"
+  },
   "item_image.label.sale": {
     "defaultMessage": "セール",
     "description": "A sale badge placed on top of a product image"
@@ -699,8 +753,11 @@
     "defaultMessage": "入手不可",
     "description": "A unavailable badge placed on top of a product image"
   },
-  "item_price.label.starting_at": {
-    "defaultMessage": "最低価格"
+  "item_variant.assistive_msg.quantity": {
+    "defaultMessage": "数量 {quantity}"
+  },
+  "item_variant.quantity.label": {
+    "defaultMessage": "{productName}の数量セレクター。選択された数量は {quantity} です"
   },
   "lCPCxk": {
     "defaultMessage": "上記のすべてのオプションを選択してください"
@@ -1063,8 +1120,17 @@
   "product_tile.assistive_msg.remove_from_wishlist": {
     "defaultMessage": "{product} をほしい物リストから削除"
   },
-  "product_tile.label.starting_at_price": {
-    "defaultMessage": "最低価格: {price}"
+  "product_tile.badge.label.new": {
+    "defaultMessage": "新規"
+  },
+  "product_tile.badge.label.sale": {
+    "defaultMessage": "セール"
+  },
+  "product_view.button.add_bundle_to_cart": {
+    "defaultMessage": "バンドルを買い物カゴに追加"
+  },
+  "product_view.button.add_bundle_to_wishlist": {
+    "defaultMessage": "バンドルをほしい物リストに追加"
   },
   "product_view.button.add_set_to_cart": {
     "defaultMessage": "セットを買い物カゴに追加"
@@ -1082,10 +1148,10 @@
     "defaultMessage": "更新"
   },
   "product_view.label.assistive_msg.quantity_decrement": {
-    "defaultMessage": "数量を減らす"
+    "defaultMessage": "{productName} の数量を減らす"
   },
   "product_view.label.assistive_msg.quantity_increment": {
-    "defaultMessage": "数量を増やす"
+    "defaultMessage": "{productName} の数量を増やす"
   },
   "product_view.label.quantity": {
     "defaultMessage": "数量"
@@ -1096,9 +1162,6 @@
   "product_view.label.quantity_increment": {
     "defaultMessage": "+"
   },
-  "product_view.label.starting_at_price": {
-    "defaultMessage": "最低価格"
-  },
   "product_view.label.variant_type": {
     "defaultMessage": "{variantType}"
   },
@@ -1151,7 +1214,7 @@
     "defaultMessage": "さあ、始めましょう!"
   },
   "register_form.message.agree_to_policy_terms": {
-    "defaultMessage": "アカウントを作成した場合、Salesforce の<policy>プライバシーポリシー</policy>と<terms>使用条件</terms>にご同意いただいたものと見なされます"
+    "defaultMessage": "アカウントを作成した場合、Salesforce の<policy>プライバシーポリシー</policy>と<terms>使用条件</terms>にご同意いただいたものと見なされます。"
   },
   "register_form.message.already_have_account": {
     "defaultMessage": "すでにアカウントをお持ちですか?"
@@ -1196,6 +1259,15 @@
   "shipping_address.button.continue_to_shipping": {
     "defaultMessage": "配送方法に進む"
   },
+  "shipping_address.label.edit_button": {
+    "defaultMessage": "{address} の編集"
+  },
+  "shipping_address.label.remove_button": {
+    "defaultMessage": "{address} の削除"
+  },
+  "shipping_address.label.shipping_address_form": {
+    "defaultMessage": "配送先住所フォーム"
+  },
   "shipping_address.title.shipping_address": {
     "defaultMessage": "配送先住所"
   },
@@ -1241,12 +1313,81 @@
   "signout_confirmation_dialog.message.sure_to_sign_out": {
     "defaultMessage": "サインアウトしますか?現在のご注文を処理するには、再度サインインする必要があります。"
   },
+  "store_locator.action.find": {
+    "defaultMessage": "検索"
+  },
+  "store_locator.action.select_a_country": {
+    "defaultMessage": "国を選択してください"
+  },
+  "store_locator.action.use_my_location": {
+    "defaultMessage": "現在地を使用"
+  },
+  "store_locator.action.viewMore": {
+    "defaultMessage": "もっと見る"
+  },
+  "store_locator.description.away": {
+    "defaultMessage": "の距離"
+  },
+  "store_locator.description.loading_locations": {
+    "defaultMessage": "位置情報を読み込んでいます..."
+  },
+  "store_locator.description.no_locations": {
+    "defaultMessage": "申し訳ございませんが、このエリアには店舗がありません"
+  },
+  "store_locator.description.or": {
+    "defaultMessage": "または"
+  },
+  "store_locator.description.phone": {
+    "defaultMessage": "電話:"
+  },
+  "store_locator.description.viewing_near_postal_code": {
+    "defaultMessage": "次の {postalCode} から {distance}{distanceUnit} 以内の店舗を表示しています: "
+  },
+  "store_locator.description.viewing_near_your_location": {
+    "defaultMessage": "現在地の近くの店舗を表示しています"
+  },
+  "store_locator.dropdown.germany": {
+    "defaultMessage": "ドイツ"
+  },
+  "store_locator.dropdown.united_states": {
+    "defaultMessage": "米国"
+  },
+  "store_locator.error.agree_to_share_your_location": {
+    "defaultMessage": "現在地を共有することに同意してください"
+  },
+  "store_locator.error.please_enter_a_postal_code": {
+    "defaultMessage": "郵便番号を入力してください。"
+  },
+  "store_locator.error.please_select_a_country": {
+    "defaultMessage": "国を選択してください。"
+  },
+  "store_locator.field.placeholder.enter_postal_code": {
+    "defaultMessage": "郵便番号を入力してください"
+  },
+  "store_locator.pagination.load_more": {
+    "defaultMessage": "さらに読み込む"
+  },
+  "store_locator.title": {
+    "defaultMessage": "店舗の検索"
+  },
   "swatch_group.selected.label": {
     "defaultMessage": "{label}: "
   },
   "toggle_card.action.edit": {
     "defaultMessage": "編集"
   },
+  "toggle_card.action.editContactInfo": {
+    "defaultMessage": "連絡先情報の編集"
+  },
+  "toggle_card.action.editPaymentInfo": {
+    "defaultMessage": "支払情報の編集"
+  },
+  "toggle_card.action.editShippingAddress": {
+    "defaultMessage": "配送先住所の編集"
+  },
+  "toggle_card.action.editShippingOptions": {
+    "defaultMessage": "配送オプションの編集"
+  },
   "update_password_fields.button.forgot_password": {
     "defaultMessage": "パスワードを忘れましたか?"
   },
@@ -1260,7 +1401,8 @@
     "defaultMessage": "電話番号を入力してください。"
   },
   "use_address_fields.error.please_enter_your_postal_or_zip": {
-    "defaultMessage": "郵便番号を入力してください。"
+    "defaultMessage": "郵便番号を入力してください。",
+    "description": "Error message for a blank zip code (US-specific checkout)"
   },
   "use_address_fields.error.please_select_your_address": {
     "defaultMessage": "住所を入力してください。"
@@ -1272,7 +1414,8 @@
     "defaultMessage": "国を選択してください。"
   },
   "use_address_fields.error.please_select_your_state_or_province": {
-    "defaultMessage": "州を選択してください。"
+    "defaultMessage": "州を選択してください。",
+    "description": "Error message for a blank state (US-specific checkout)"
   },
   "use_address_fields.error.required": {
     "defaultMessage": "必須"
@@ -1371,11 +1514,17 @@
     "defaultMessage": "パスワード"
   },
   "use_product.message.inventory_remaining": {
-    "defaultMessage": "残り {stockLevel} 点!"
+    "defaultMessage": "残り {stockLevel} 点のみ!"
+  },
+  "use_product.message.inventory_remaining_for_product": {
+    "defaultMessage": "{productName} は残り {stockLevel} 点のみ!"
   },
   "use_product.message.out_of_stock": {
     "defaultMessage": "在庫切れ"
   },
+  "use_product.message.out_of_stock_for_product": {
+    "defaultMessage": "{productName} は在庫切れです"
+  },
   "use_profile_fields.error.required_email": {
     "defaultMessage": "有効な Eメールアドレスを入力してください。"
   },
@@ -1490,24 +1639,39 @@
   "use_update_password_fields.label.new_password": {
     "defaultMessage": "新しいパスワード:"
   },
+  "wishlist_primary_action.button.addSetToCart.label": {
+    "defaultMessage": "{productName} のセットを買い物カゴに追加"
+  },
+  "wishlist_primary_action.button.addToCart.label": {
+    "defaultMessage": "{productName} を買い物カゴに追加"
+  },
   "wishlist_primary_action.button.add_set_to_cart": {
     "defaultMessage": "セットを買い物カゴに追加"
   },
   "wishlist_primary_action.button.add_to_cart": {
     "defaultMessage": "買い物カゴに追加"
   },
+  "wishlist_primary_action.button.viewFullDetails.label": {
+    "defaultMessage": "{productName} の詳細を表示"
+  },
   "wishlist_primary_action.button.view_full_details": {
     "defaultMessage": "すべての情報を表示"
   },
   "wishlist_primary_action.button.view_options": {
     "defaultMessage": "オプションを表示"
   },
+  "wishlist_primary_action.button.view_options.label": {
+    "defaultMessage": "{productName} のオプションを表示"
+  },
   "wishlist_primary_action.info.added_to_cart": {
     "defaultMessage": "{quantity} {quantity, plural, one { 個の商品} other { 個の商品}}が買い物カゴに追加されました"
   },
   "wishlist_secondary_button_group.action.remove": {
     "defaultMessage": "削除"
   },
+  "wishlist_secondary_button_group.info.item.remove.label": {
+    "defaultMessage": "{productName} の削除"
+  },
   "wishlist_secondary_button_group.info.item_removed": {
     "defaultMessage": "ほしい物リストから商品が削除されました"
   },
diff --git a/packages/template-retail-react-app/translations/ko-KR.json b/packages/template-retail-react-app/translations/ko-KR.json
index 65edc6a05d..26513f6f20 100644
--- a/packages/template-retail-react-app/translations/ko-KR.json
+++ b/packages/template-retail-react-app/translations/ko-KR.json
@@ -174,6 +174,9 @@
   "cart.info.removed_from_cart": {
     "defaultMessage": "항목이 카트에서 제거됨"
   },
+  "cart.product_edit_modal.modal_label": {
+    "defaultMessage": "{productName}에 대한 모달 편집"
+  },
   "cart.recommended_products.title.may_also_like": {
     "defaultMessage": "추천 상품"
   },
@@ -204,6 +207,9 @@
   "cart_title.title.cart_num_of_items": {
     "defaultMessage": "카트({itemCount, plural, =0 {0개 항목} one {#개 항목} other {#개 항목}})"
   },
+  "category_links.button_text": {
+    "defaultMessage": "카테고리"
+  },
   "cc_radio_group.action.remove": {
     "defaultMessage": "제거"
   },
@@ -261,6 +267,9 @@
   "checkout_confirmation.label.shipping": {
     "defaultMessage": "배송"
   },
+  "checkout_confirmation.label.shipping.strikethrough.price": {
+    "defaultMessage": "원래 가격: {originalPrice} , 현재 가격: {newPrice}"
+  },
   "checkout_confirmation.label.subtotal": {
     "defaultMessage": "소계"
   },
@@ -319,6 +328,9 @@
   "checkout_payment.heading.credit_card": {
     "defaultMessage": "신용카드"
   },
+  "checkout_payment.label.billing_address_form": {
+    "defaultMessage": "청구 주소 양식"
+  },
   "checkout_payment.label.same_as_shipping": {
     "defaultMessage": "배송 주소와 동일"
   },
@@ -334,6 +346,12 @@
   "confirmation_modal.default.action.yes": {
     "defaultMessage": "예"
   },
+  "confirmation_modal.default.assistive_msg.no": {
+    "defaultMessage": "아니요, 작업을 취소합니다."
+  },
+  "confirmation_modal.default.assistive_msg.yes": {
+    "defaultMessage": "예, 작업을 확인합니다"
+  },
   "confirmation_modal.default.message.you_want_to_continue": {
     "defaultMessage": "계속하시겠습니까?"
   },
@@ -349,6 +367,15 @@
   "confirmation_modal.remove_cart_item.action.yes": {
     "defaultMessage": "예. 항목을 제거합니다."
   },
+  "confirmation_modal.remove_cart_item.assistive_msg.no": {
+    "defaultMessage": "아니요. 항목을 그대로 둡니다."
+  },
+  "confirmation_modal.remove_cart_item.assistive_msg.remove": {
+    "defaultMessage": "사용할 수 없는 제품 제거"
+  },
+  "confirmation_modal.remove_cart_item.assistive_msg.yes": {
+    "defaultMessage": "예. 항목을 제거합니다."
+  },
   "confirmation_modal.remove_cart_item.message.need_to_remove_due_to_unavailability": {
     "defaultMessage": "더 이상 온라인으로 구매할 수 없는 일부 품목이 카트에서 제거됩니다."
   },
@@ -405,6 +432,21 @@
   "credit_card_fields.tool_tip.security_code_aria_label": {
     "defaultMessage": "보안 코드 정보"
   },
+  "display_price.assistive_msg.current_price": {
+    "defaultMessage": "현재 가격 {currentPrice}"
+  },
+  "display_price.assistive_msg.current_price_with_range": {
+    "defaultMessage": "현재 가격 {currentPrice}에서"
+  },
+  "display_price.assistive_msg.strikethrough_price": {
+    "defaultMessage": "원래 가격 {listPrice}"
+  },
+  "display_price.assistive_msg.strikethrough_price_with_range": {
+    "defaultMessage": "원래 가격 {listPrice}에서"
+  },
+  "display_price.label.current_price_with_range": {
+    "defaultMessage": "{currentPrice}부터 시작"
+  },
   "drawer_menu.button.account_details": {
     "defaultMessage": "계정 세부 정보"
   },
@@ -420,6 +462,9 @@
   "drawer_menu.button.order_history": {
     "defaultMessage": "주문 내역"
   },
+  "drawer_menu.header.assistive_msg.title": {
+    "defaultMessage": "메뉴 서랍"
+  },
   "drawer_menu.link.about_us": {
     "defaultMessage": "회사 정보"
   },
@@ -582,6 +627,9 @@
   "header.button.assistive_msg.menu": {
     "defaultMessage": "메뉴"
   },
+  "header.button.assistive_msg.menu.open_dialog": {
+    "defaultMessage": "대화창 열기"
+  },
   "header.button.assistive_msg.my_account": {
     "defaultMessage": "내 계정"
   },
@@ -591,6 +639,9 @@
   "header.button.assistive_msg.my_cart_with_num_items": {
     "defaultMessage": "내 카트, 품목 수: {numItems}"
   },
+  "header.button.assistive_msg.store_locator": {
+    "defaultMessage": "매장 찾기"
+  },
   "header.button.assistive_msg.wishlist": {
     "defaultMessage": "위시리스트"
   },
@@ -691,6 +742,9 @@
   "item_attributes.label.quantity": {
     "defaultMessage": "수량: {quantity}"
   },
+  "item_attributes.label.selected_options": {
+    "defaultMessage": "선택한 옵션"
+  },
   "item_image.label.sale": {
     "defaultMessage": "판매",
     "description": "A sale badge placed on top of a product image"
@@ -699,8 +753,11 @@
     "defaultMessage": "사용 불가",
     "description": "A unavailable badge placed on top of a product image"
   },
-  "item_price.label.starting_at": {
-    "defaultMessage": "시작가"
+  "item_variant.assistive_msg.quantity": {
+    "defaultMessage": "수량 {quantity}"
+  },
+  "item_variant.quantity.label": {
+    "defaultMessage": "{productName}에 대한 수량 선택기 선택한 수량은 {quantity}개입니다."
   },
   "lCPCxk": {
     "defaultMessage": "위에서 옵션을 모두 선택하세요."
@@ -1063,8 +1120,17 @@
   "product_tile.assistive_msg.remove_from_wishlist": {
     "defaultMessage": "위시리스트에서 {product} 제거"
   },
-  "product_tile.label.starting_at_price": {
-    "defaultMessage": "시작가: {price}"
+  "product_tile.badge.label.new": {
+    "defaultMessage": "신규"
+  },
+  "product_tile.badge.label.sale": {
+    "defaultMessage": "판매"
+  },
+  "product_view.button.add_bundle_to_cart": {
+    "defaultMessage": "카트에 번들 추가"
+  },
+  "product_view.button.add_bundle_to_wishlist": {
+    "defaultMessage": "위시리스트에 번들 추가"
   },
   "product_view.button.add_set_to_cart": {
     "defaultMessage": "카트에 세트 추가"
@@ -1082,10 +1148,10 @@
     "defaultMessage": "업데이트"
   },
   "product_view.label.assistive_msg.quantity_decrement": {
-    "defaultMessage": "수량 줄이기"
+    "defaultMessage": "{productName}의 감소 수량"
   },
   "product_view.label.assistive_msg.quantity_increment": {
-    "defaultMessage": "수량 늘리기"
+    "defaultMessage": "{productName}에 대한 증분 수량"
   },
   "product_view.label.quantity": {
     "defaultMessage": "수량"
@@ -1096,9 +1162,6 @@
   "product_view.label.quantity_increment": {
     "defaultMessage": "+"
   },
-  "product_view.label.starting_at_price": {
-    "defaultMessage": "시작가"
-  },
   "product_view.label.variant_type": {
     "defaultMessage": "{variantType}"
   },
@@ -1151,7 +1214,7 @@
     "defaultMessage": "이제 시작하세요!"
   },
   "register_form.message.agree_to_policy_terms": {
-    "defaultMessage": "계정을 만들면 Salesforce <policy>개인정보보호 정책</policy>과 <terms>이용 약관</terms>에 동의한 것으로 간주됩니다."
+    "defaultMessage": "계정을 만들면 Salesforce <policy>개인정보 보호정책</policy> 및 <terms>약관</terms>에 동의하는 것입니다."
   },
   "register_form.message.already_have_account": {
     "defaultMessage": "계정이 이미 있습니까?"
@@ -1196,6 +1259,15 @@
   "shipping_address.button.continue_to_shipping": {
     "defaultMessage": "배송 방법으로 계속 진행하기"
   },
+  "shipping_address.label.edit_button": {
+    "defaultMessage": "{address} 편집"
+  },
+  "shipping_address.label.remove_button": {
+    "defaultMessage": "{address} 제거"
+  },
+  "shipping_address.label.shipping_address_form": {
+    "defaultMessage": "배송 주소 양식"
+  },
   "shipping_address.title.shipping_address": {
     "defaultMessage": "배송 주소"
   },
@@ -1241,12 +1313,81 @@
   "signout_confirmation_dialog.message.sure_to_sign_out": {
     "defaultMessage": "로그아웃하시겠습니까? 현재 주문을 처리하려면 다시 로그인해야 합니다."
   },
+  "store_locator.action.find": {
+    "defaultMessage": "찾기"
+  },
+  "store_locator.action.select_a_country": {
+    "defaultMessage": "국가 선택"
+  },
+  "store_locator.action.use_my_location": {
+    "defaultMessage": "내 위치 사용"
+  },
+  "store_locator.action.viewMore": {
+    "defaultMessage": "자세히 보기"
+  },
+  "store_locator.description.away": {
+    "defaultMessage": "떨어진 곳에 위치"
+  },
+  "store_locator.description.loading_locations": {
+    "defaultMessage": "위치 로드 중..."
+  },
+  "store_locator.description.no_locations": {
+    "defaultMessage": "죄송하지만 이 지역에는 위치가 없습니다."
+  },
+  "store_locator.description.or": {
+    "defaultMessage": "Or"
+  },
+  "store_locator.description.phone": {
+    "defaultMessage": "전화번호:"
+  },
+  "store_locator.description.viewing_near_postal_code": {
+    "defaultMessage": "{postalCode}에서 {distance}{distanceUnit} 내에 위치한 매장 보기"
+  },
+  "store_locator.description.viewing_near_your_location": {
+    "defaultMessage": "현재 위치에서 가까운 매장 보기"
+  },
+  "store_locator.dropdown.germany": {
+    "defaultMessage": "독일"
+  },
+  "store_locator.dropdown.united_states": {
+    "defaultMessage": "미국"
+  },
+  "store_locator.error.agree_to_share_your_location": {
+    "defaultMessage": "위치 공유에 동의하십시오."
+  },
+  "store_locator.error.please_enter_a_postal_code": {
+    "defaultMessage": "우편번호를 입력해 주세요."
+  },
+  "store_locator.error.please_select_a_country": {
+    "defaultMessage": "국가를 선택하십시오."
+  },
+  "store_locator.field.placeholder.enter_postal_code": {
+    "defaultMessage": "우편번호 입력"
+  },
+  "store_locator.pagination.load_more": {
+    "defaultMessage": "추가 로드"
+  },
+  "store_locator.title": {
+    "defaultMessage": "매장 찾기"
+  },
   "swatch_group.selected.label": {
     "defaultMessage": "{label}:"
   },
   "toggle_card.action.edit": {
     "defaultMessage": "편집"
   },
+  "toggle_card.action.editContactInfo": {
+    "defaultMessage": "연락처 정보 편집"
+  },
+  "toggle_card.action.editPaymentInfo": {
+    "defaultMessage": "결제 정보 편집"
+  },
+  "toggle_card.action.editShippingAddress": {
+    "defaultMessage": "배송 주소 편집"
+  },
+  "toggle_card.action.editShippingOptions": {
+    "defaultMessage": "배송 옵션 편집"
+  },
   "update_password_fields.button.forgot_password": {
     "defaultMessage": "암호가 기억나지 않습니까?"
   },
@@ -1260,7 +1401,8 @@
     "defaultMessage": "전화번호를 입력하십시오."
   },
   "use_address_fields.error.please_enter_your_postal_or_zip": {
-    "defaultMessage": "우편번호를 입력하십시오."
+    "defaultMessage": "우편번호를 입력하십시오.",
+    "description": "Error message for a blank zip code (US-specific checkout)"
   },
   "use_address_fields.error.please_select_your_address": {
     "defaultMessage": "주소를 입력하십시오."
@@ -1272,7 +1414,8 @@
     "defaultMessage": "국가를 선택하십시오."
   },
   "use_address_fields.error.please_select_your_state_or_province": {
-    "defaultMessage": "시/도를 선택하십시오."
+    "defaultMessage": "주를 선택하십시오.",
+    "description": "Error message for a blank state (US-specific checkout)"
   },
   "use_address_fields.error.required": {
     "defaultMessage": "필수"
@@ -1373,9 +1516,15 @@
   "use_product.message.inventory_remaining": {
     "defaultMessage": "품절 임박({stockLevel}개 남음)"
   },
+  "use_product.message.inventory_remaining_for_product": {
+    "defaultMessage": "{productName}이(가) {stockLevel}개 남았습니다!"
+  },
   "use_product.message.out_of_stock": {
     "defaultMessage": "품절"
   },
+  "use_product.message.out_of_stock_for_product": {
+    "defaultMessage": "{productName}이(가) 품절입니다."
+  },
   "use_profile_fields.error.required_email": {
     "defaultMessage": "유효한 이메일 주소를 입력하십시오."
   },
@@ -1490,24 +1639,39 @@
   "use_update_password_fields.label.new_password": {
     "defaultMessage": "새 암호"
   },
+  "wishlist_primary_action.button.addSetToCart.label": {
+    "defaultMessage": "카트에 {productName} 세트 추가"
+  },
+  "wishlist_primary_action.button.addToCart.label": {
+    "defaultMessage": "카트에 {productName} 추가"
+  },
   "wishlist_primary_action.button.add_set_to_cart": {
     "defaultMessage": "카트에 세트 추가"
   },
   "wishlist_primary_action.button.add_to_cart": {
     "defaultMessage": "카트에 추가"
   },
+  "wishlist_primary_action.button.viewFullDetails.label": {
+    "defaultMessage": "{productName}에 대한 전체 세부 정보 보기"
+  },
   "wishlist_primary_action.button.view_full_details": {
     "defaultMessage": "전체 세부 정보 보기"
   },
   "wishlist_primary_action.button.view_options": {
     "defaultMessage": "옵션 보기"
   },
+  "wishlist_primary_action.button.view_options.label": {
+    "defaultMessage": "{productName}에 대한 보기 옵션"
+  },
   "wishlist_primary_action.info.added_to_cart": {
     "defaultMessage": "{quantity} {quantity, plural, one {개 항목} other {개 항목}}이 카트에 추가됨"
   },
   "wishlist_secondary_button_group.action.remove": {
     "defaultMessage": "제거"
   },
+  "wishlist_secondary_button_group.info.item.remove.label": {
+    "defaultMessage": "{productName} 제거"
+  },
   "wishlist_secondary_button_group.info.item_removed": {
     "defaultMessage": "항목이 위시리스트에서 제거됨"
   },
diff --git a/packages/template-retail-react-app/translations/pt-BR.json b/packages/template-retail-react-app/translations/pt-BR.json
index ea6935042b..9c5596a015 100644
--- a/packages/template-retail-react-app/translations/pt-BR.json
+++ b/packages/template-retail-react-app/translations/pt-BR.json
@@ -174,6 +174,9 @@
   "cart.info.removed_from_cart": {
     "defaultMessage": "Item removido do carrinho"
   },
+  "cart.product_edit_modal.modal_label": {
+    "defaultMessage": "Editar modal para {productName}"
+  },
   "cart.recommended_products.title.may_also_like": {
     "defaultMessage": "Talvez você também queira"
   },
@@ -204,6 +207,9 @@
   "cart_title.title.cart_num_of_items": {
     "defaultMessage": "Carrinho ({itemCount, plural, =0 {0 itens} one {# item} other {# itens}})"
   },
+  "category_links.button_text": {
+    "defaultMessage": "Categorias"
+  },
   "cc_radio_group.action.remove": {
     "defaultMessage": "Remover"
   },
@@ -261,6 +267,9 @@
   "checkout_confirmation.label.shipping": {
     "defaultMessage": "Frete"
   },
+  "checkout_confirmation.label.shipping.strikethrough.price": {
+    "defaultMessage": "Originalmente {originalPrice}, agora {newPrice}"
+  },
   "checkout_confirmation.label.subtotal": {
     "defaultMessage": "Subtotal"
   },
@@ -319,6 +328,9 @@
   "checkout_payment.heading.credit_card": {
     "defaultMessage": "Cartão de crédito"
   },
+  "checkout_payment.label.billing_address_form": {
+    "defaultMessage": "Formulário de endereço para faturamento"
+  },
   "checkout_payment.label.same_as_shipping": {
     "defaultMessage": "Igual ao endereço de entrega"
   },
@@ -334,6 +346,12 @@
   "confirmation_modal.default.action.yes": {
     "defaultMessage": "Sim"
   },
+  "confirmation_modal.default.assistive_msg.no": {
+    "defaultMessage": "Não, cancelar ação"
+  },
+  "confirmation_modal.default.assistive_msg.yes": {
+    "defaultMessage": "Sim, confirmar ação"
+  },
   "confirmation_modal.default.message.you_want_to_continue": {
     "defaultMessage": "Tem certeza de que deseja continuar?"
   },
@@ -349,6 +367,15 @@
   "confirmation_modal.remove_cart_item.action.yes": {
     "defaultMessage": "Sim, remover item"
   },
+  "confirmation_modal.remove_cart_item.assistive_msg.no": {
+    "defaultMessage": "Não, manter item"
+  },
+  "confirmation_modal.remove_cart_item.assistive_msg.remove": {
+    "defaultMessage": "Remover produtos indisponíveis"
+  },
+  "confirmation_modal.remove_cart_item.assistive_msg.yes": {
+    "defaultMessage": "Sim, remover item"
+  },
   "confirmation_modal.remove_cart_item.message.need_to_remove_due_to_unavailability": {
     "defaultMessage": "Alguns itens não estão mais disponíveis online e serão removidos de seu carrinho."
   },
@@ -405,6 +432,21 @@
   "credit_card_fields.tool_tip.security_code_aria_label": {
     "defaultMessage": "Informações do código de segurança"
   },
+  "display_price.assistive_msg.current_price": {
+    "defaultMessage": "preço atual {currentPrice}"
+  },
+  "display_price.assistive_msg.current_price_with_range": {
+    "defaultMessage": "A partir do preço atual {currentPrice}"
+  },
+  "display_price.assistive_msg.strikethrough_price": {
+    "defaultMessage": "preço original {listPrice}"
+  },
+  "display_price.assistive_msg.strikethrough_price_with_range": {
+    "defaultMessage": "A partir do preço original {listPrice}"
+  },
+  "display_price.label.current_price_with_range": {
+    "defaultMessage": "De {currentPrice}"
+  },
   "drawer_menu.button.account_details": {
     "defaultMessage": "Detalhes da conta"
   },
@@ -420,6 +462,9 @@
   "drawer_menu.button.order_history": {
     "defaultMessage": "Histórico de pedidos"
   },
+  "drawer_menu.header.assistive_msg.title": {
+    "defaultMessage": "Gaveta de menu"
+  },
   "drawer_menu.link.about_us": {
     "defaultMessage": "Sobre nós"
   },
@@ -427,7 +472,7 @@
     "defaultMessage": "Suporte ao cliente"
   },
   "drawer_menu.link.customer_support.contact_us": {
-    "defaultMessage": "Entrar em contato"
+    "defaultMessage": "Entre em contato"
   },
   "drawer_menu.link.customer_support.shipping_and_returns": {
     "defaultMessage": "Frete e devoluções"
@@ -582,6 +627,9 @@
   "header.button.assistive_msg.menu": {
     "defaultMessage": "Menu"
   },
+  "header.button.assistive_msg.menu.open_dialog": {
+    "defaultMessage": "Abre uma caixa de diálogo"
+  },
   "header.button.assistive_msg.my_account": {
     "defaultMessage": "Minha conta"
   },
@@ -591,6 +639,9 @@
   "header.button.assistive_msg.my_cart_with_num_items": {
     "defaultMessage": "Meu carrinho, número de itens: {numItems}"
   },
+  "header.button.assistive_msg.store_locator": {
+    "defaultMessage": "Localizador de lojas"
+  },
   "header.button.assistive_msg.wishlist": {
     "defaultMessage": "Lista de desejos"
   },
@@ -691,6 +742,9 @@
   "item_attributes.label.quantity": {
     "defaultMessage": "Quantidade: {quantity}"
   },
+  "item_attributes.label.selected_options": {
+    "defaultMessage": "Opções selecionadas"
+  },
   "item_image.label.sale": {
     "defaultMessage": "Promoção",
     "description": "A sale badge placed on top of a product image"
@@ -699,8 +753,11 @@
     "defaultMessage": "Indisponível",
     "description": "A unavailable badge placed on top of a product image"
   },
-  "item_price.label.starting_at": {
-    "defaultMessage": "A partir de"
+  "item_variant.assistive_msg.quantity": {
+    "defaultMessage": "Quantidade {quantity}"
+  },
+  "item_variant.quantity.label": {
+    "defaultMessage": "Seletor de quantidade para {productName}. A quantidade selecionada é {quantity}"
   },
   "lCPCxk": {
     "defaultMessage": "Selecione todas as opções acima"
@@ -1063,8 +1120,17 @@
   "product_tile.assistive_msg.remove_from_wishlist": {
     "defaultMessage": "Remover {product} da lista de desejos"
   },
-  "product_tile.label.starting_at_price": {
-    "defaultMessage": "A partir de {price}"
+  "product_tile.badge.label.new": {
+    "defaultMessage": "Criar"
+  },
+  "product_tile.badge.label.sale": {
+    "defaultMessage": "Promoção"
+  },
+  "product_view.button.add_bundle_to_cart": {
+    "defaultMessage": "Adicionar pacote ao carrinho"
+  },
+  "product_view.button.add_bundle_to_wishlist": {
+    "defaultMessage": "Adicionar pacote à lista de desejos"
   },
   "product_view.button.add_set_to_cart": {
     "defaultMessage": "Adicionar conjunto ao carrinho"
@@ -1082,10 +1148,10 @@
     "defaultMessage": "Atualizar"
   },
   "product_view.label.assistive_msg.quantity_decrement": {
-    "defaultMessage": "Quantidade de decremento"
+    "defaultMessage": "Quantidade em decremento para {productName}"
   },
   "product_view.label.assistive_msg.quantity_increment": {
-    "defaultMessage": "Quantidade de incremento"
+    "defaultMessage": "Quantidade em incremento para {productName}"
   },
   "product_view.label.quantity": {
     "defaultMessage": "Quantidade"
@@ -1096,9 +1162,6 @@
   "product_view.label.quantity_increment": {
     "defaultMessage": "+"
   },
-  "product_view.label.starting_at_price": {
-    "defaultMessage": "A partir de"
-  },
   "product_view.label.variant_type": {
     "defaultMessage": "{variantType}"
   },
@@ -1196,6 +1259,15 @@
   "shipping_address.button.continue_to_shipping": {
     "defaultMessage": "Ir ao método de entrega"
   },
+  "shipping_address.label.edit_button": {
+    "defaultMessage": "Editar {address}"
+  },
+  "shipping_address.label.remove_button": {
+    "defaultMessage": "Remover {address}"
+  },
+  "shipping_address.label.shipping_address_form": {
+    "defaultMessage": "Formulário de endereço de entrega"
+  },
   "shipping_address.title.shipping_address": {
     "defaultMessage": "Endereço de entrega"
   },
@@ -1241,12 +1313,81 @@
   "signout_confirmation_dialog.message.sure_to_sign_out": {
     "defaultMessage": "Tem certeza de que deseja fazer logout? Será preciso fazer logon novamente para dar continuidade ao seu pedido atual."
   },
+  "store_locator.action.find": {
+    "defaultMessage": "Localizar"
+  },
+  "store_locator.action.select_a_country": {
+    "defaultMessage": "Selecione um país"
+  },
+  "store_locator.action.use_my_location": {
+    "defaultMessage": "Utilizar a minha localização"
+  },
+  "store_locator.action.viewMore": {
+    "defaultMessage": "Ver mais"
+  },
+  "store_locator.description.away": {
+    "defaultMessage": "de distância"
+  },
+  "store_locator.description.loading_locations": {
+    "defaultMessage": "Carregando localizações..."
+  },
+  "store_locator.description.no_locations": {
+    "defaultMessage": "Desculpe, não há localizações nesta área"
+  },
+  "store_locator.description.or": {
+    "defaultMessage": "Ou"
+  },
+  "store_locator.description.phone": {
+    "defaultMessage": "Telefone:"
+  },
+  "store_locator.description.viewing_near_postal_code": {
+    "defaultMessage": "Visualizando lojas dentro de {distance}{distanceUnit} de {postalCode} em"
+  },
+  "store_locator.description.viewing_near_your_location": {
+    "defaultMessage": "Ver lojas perto da sua localização"
+  },
+  "store_locator.dropdown.germany": {
+    "defaultMessage": "Alemanha"
+  },
+  "store_locator.dropdown.united_states": {
+    "defaultMessage": "Estados Unidos"
+  },
+  "store_locator.error.agree_to_share_your_location": {
+    "defaultMessage": "Aceite compartilhar sua localização"
+  },
+  "store_locator.error.please_enter_a_postal_code": {
+    "defaultMessage": "Insira um código postal."
+  },
+  "store_locator.error.please_select_a_country": {
+    "defaultMessage": "Selecione um país."
+  },
+  "store_locator.field.placeholder.enter_postal_code": {
+    "defaultMessage": "Inserir código postal"
+  },
+  "store_locator.pagination.load_more": {
+    "defaultMessage": "Carregar mais"
+  },
+  "store_locator.title": {
+    "defaultMessage": "Encontre uma loja"
+  },
   "swatch_group.selected.label": {
     "defaultMessage": "{label}:"
   },
   "toggle_card.action.edit": {
     "defaultMessage": "Editar"
   },
+  "toggle_card.action.editContactInfo": {
+    "defaultMessage": "Editar informações de contato"
+  },
+  "toggle_card.action.editPaymentInfo": {
+    "defaultMessage": "Editar informações de pagamento"
+  },
+  "toggle_card.action.editShippingAddress": {
+    "defaultMessage": "Editar endereço de entrega"
+  },
+  "toggle_card.action.editShippingOptions": {
+    "defaultMessage": "Editar opções de envio"
+  },
   "update_password_fields.button.forgot_password": {
     "defaultMessage": "Esqueceu a senha?"
   },
@@ -1260,7 +1401,8 @@
     "defaultMessage": "Insira seu telefone."
   },
   "use_address_fields.error.please_enter_your_postal_or_zip": {
-    "defaultMessage": "Insira seu código postal."
+    "defaultMessage": "Insira seu CEP.",
+    "description": "Error message for a blank zip code (US-specific checkout)"
   },
   "use_address_fields.error.please_select_your_address": {
     "defaultMessage": "Insira seu endereço."
@@ -1272,7 +1414,8 @@
     "defaultMessage": "Selecione o país."
   },
   "use_address_fields.error.please_select_your_state_or_province": {
-    "defaultMessage": "Selecione estado/província."
+    "defaultMessage": "Selecione seu estado.",
+    "description": "Error message for a blank state (US-specific checkout)"
   },
   "use_address_fields.error.required": {
     "defaultMessage": "Requerido"
@@ -1373,9 +1516,15 @@
   "use_product.message.inventory_remaining": {
     "defaultMessage": "Somente {stockLevel} restante(s)!"
   },
+  "use_product.message.inventory_remaining_for_product": {
+    "defaultMessage": "Sobraram somente {stockLevel} para {productName}!"
+  },
   "use_product.message.out_of_stock": {
     "defaultMessage": "Fora de estoque"
   },
+  "use_product.message.out_of_stock_for_product": {
+    "defaultMessage": "{productName} esgotado(a)"
+  },
   "use_profile_fields.error.required_email": {
     "defaultMessage": "Insira um endereço de e-mail válido."
   },
@@ -1490,24 +1639,39 @@
   "use_update_password_fields.label.new_password": {
     "defaultMessage": "Nova senha"
   },
+  "wishlist_primary_action.button.addSetToCart.label": {
+    "defaultMessage": "Adicionar conjunto de {productName} ao carrinho"
+  },
+  "wishlist_primary_action.button.addToCart.label": {
+    "defaultMessage": "Adicionar {productName} ao carrinho"
+  },
   "wishlist_primary_action.button.add_set_to_cart": {
     "defaultMessage": "Adicionar conjunto ao carrinho"
   },
   "wishlist_primary_action.button.add_to_cart": {
     "defaultMessage": "Adicionar ao carrinho"
   },
+  "wishlist_primary_action.button.viewFullDetails.label": {
+    "defaultMessage": "Ver todos os detalhes de {productName}"
+  },
   "wishlist_primary_action.button.view_full_details": {
     "defaultMessage": "Ver detalhes completos"
   },
   "wishlist_primary_action.button.view_options": {
     "defaultMessage": "Ver opções"
   },
+  "wishlist_primary_action.button.view_options.label": {
+    "defaultMessage": "Ver opções para {productName}"
+  },
   "wishlist_primary_action.info.added_to_cart": {
     "defaultMessage": "{quantity} {quantity, plural, one {item} other {itens}} adicionado(s) ao carrinho"
   },
   "wishlist_secondary_button_group.action.remove": {
     "defaultMessage": "Remover"
   },
+  "wishlist_secondary_button_group.info.item.remove.label": {
+    "defaultMessage": "Remover {productName}"
+  },
   "wishlist_secondary_button_group.info.item_removed": {
     "defaultMessage": "Item removido da lista de desejos"
   },
diff --git a/packages/template-retail-react-app/translations/zh-CN.json b/packages/template-retail-react-app/translations/zh-CN.json
index dbd4f6d9d8..eccabe279b 100644
--- a/packages/template-retail-react-app/translations/zh-CN.json
+++ b/packages/template-retail-react-app/translations/zh-CN.json
@@ -174,6 +174,9 @@
   "cart.info.removed_from_cart": {
     "defaultMessage": "从购物车中移除商品"
   },
+  "cart.product_edit_modal.modal_label": {
+    "defaultMessage": "编辑 {productName} 模态"
+  },
   "cart.recommended_products.title.may_also_like": {
     "defaultMessage": "您可能还喜欢"
   },
@@ -204,6 +207,9 @@
   "cart_title.title.cart_num_of_items": {
     "defaultMessage": "购物车（{itemCount, plural, =0 {0 件商品} one {# 件商品} other {# 件商品}}）"
   },
+  "category_links.button_text": {
+    "defaultMessage": "类别"
+  },
   "cc_radio_group.action.remove": {
     "defaultMessage": "移除"
   },
@@ -261,6 +267,9 @@
   "checkout_confirmation.label.shipping": {
     "defaultMessage": "送货"
   },
+  "checkout_confirmation.label.shipping.strikethrough.price": {
+    "defaultMessage": "原价 {originalPrice}，现价 {newPrice}"
+  },
   "checkout_confirmation.label.subtotal": {
     "defaultMessage": "小计"
   },
@@ -319,6 +328,9 @@
   "checkout_payment.heading.credit_card": {
     "defaultMessage": "信用卡"
   },
+  "checkout_payment.label.billing_address_form": {
+    "defaultMessage": "帐单地址表格"
+  },
   "checkout_payment.label.same_as_shipping": {
     "defaultMessage": "与送货地址相同"
   },
@@ -334,6 +346,12 @@
   "confirmation_modal.default.action.yes": {
     "defaultMessage": "是"
   },
+  "confirmation_modal.default.assistive_msg.no": {
+    "defaultMessage": "否，取消操作"
+  },
+  "confirmation_modal.default.assistive_msg.yes": {
+    "defaultMessage": "是，确认操作"
+  },
   "confirmation_modal.default.message.you_want_to_continue": {
     "defaultMessage": "是否确定要继续？"
   },
@@ -349,6 +367,15 @@
   "confirmation_modal.remove_cart_item.action.yes": {
     "defaultMessage": "是，移除商品"
   },
+  "confirmation_modal.remove_cart_item.assistive_msg.no": {
+    "defaultMessage": "否，保留商品"
+  },
+  "confirmation_modal.remove_cart_item.assistive_msg.remove": {
+    "defaultMessage": "移除无货产品"
+  },
+  "confirmation_modal.remove_cart_item.assistive_msg.yes": {
+    "defaultMessage": "是，移除商品"
+  },
   "confirmation_modal.remove_cart_item.message.need_to_remove_due_to_unavailability": {
     "defaultMessage": "某些商品不再在线销售，并将从您的购物车中删除。"
   },
@@ -405,6 +432,21 @@
   "credit_card_fields.tool_tip.security_code_aria_label": {
     "defaultMessage": "安全码信息"
   },
+  "display_price.assistive_msg.current_price": {
+    "defaultMessage": "当前价格 {currentPrice}"
+  },
+  "display_price.assistive_msg.current_price_with_range": {
+    "defaultMessage": "从当前价格 {currentPrice}"
+  },
+  "display_price.assistive_msg.strikethrough_price": {
+    "defaultMessage": "原价 {listPrice}"
+  },
+  "display_price.assistive_msg.strikethrough_price_with_range": {
+    "defaultMessage": "从原价 {listPrice}"
+  },
+  "display_price.label.current_price_with_range": {
+    "defaultMessage": "从 {currentPrice} 起"
+  },
   "drawer_menu.button.account_details": {
     "defaultMessage": "账户详情"
   },
@@ -420,6 +462,9 @@
   "drawer_menu.button.order_history": {
     "defaultMessage": "订单记录"
   },
+  "drawer_menu.header.assistive_msg.title": {
+    "defaultMessage": "菜单抽屉"
+  },
   "drawer_menu.link.about_us": {
     "defaultMessage": "关于我们"
   },
@@ -582,6 +627,9 @@
   "header.button.assistive_msg.menu": {
     "defaultMessage": "菜单"
   },
+  "header.button.assistive_msg.menu.open_dialog": {
+    "defaultMessage": "打开对话框"
+  },
   "header.button.assistive_msg.my_account": {
     "defaultMessage": "我的账户"
   },
@@ -591,6 +639,9 @@
   "header.button.assistive_msg.my_cart_with_num_items": {
     "defaultMessage": "我的购物车，商品数量：{numItems}"
   },
+  "header.button.assistive_msg.store_locator": {
+    "defaultMessage": "实体店地址搜索"
+  },
   "header.button.assistive_msg.wishlist": {
     "defaultMessage": "愿望清单"
   },
@@ -691,6 +742,9 @@
   "item_attributes.label.quantity": {
     "defaultMessage": "数量：{quantity}"
   },
+  "item_attributes.label.selected_options": {
+    "defaultMessage": "已选选项"
+  },
   "item_image.label.sale": {
     "defaultMessage": "销售",
     "description": "A sale badge placed on top of a product image"
@@ -699,8 +753,11 @@
     "defaultMessage": "不可用",
     "description": "A unavailable badge placed on top of a product image"
   },
-  "item_price.label.starting_at": {
-    "defaultMessage": "起价："
+  "item_variant.assistive_msg.quantity": {
+    "defaultMessage": "数量 {quantity}"
+  },
+  "item_variant.quantity.label": {
+    "defaultMessage": "{productName} 的数量选择器。选择的数量是 {quantity}"
   },
   "lCPCxk": {
     "defaultMessage": "请在上方选择您的所有选项"
@@ -1063,8 +1120,17 @@
   "product_tile.assistive_msg.remove_from_wishlist": {
     "defaultMessage": "从愿望清单删除 {product}"
   },
-  "product_tile.label.starting_at_price": {
-    "defaultMessage": "起价：{price}"
+  "product_tile.badge.label.new": {
+    "defaultMessage": "新建"
+  },
+  "product_tile.badge.label.sale": {
+    "defaultMessage": "销售"
+  },
+  "product_view.button.add_bundle_to_cart": {
+    "defaultMessage": "将套装添加到购物车"
+  },
+  "product_view.button.add_bundle_to_wishlist": {
+    "defaultMessage": "将套装添加到心愿单"
   },
   "product_view.button.add_set_to_cart": {
     "defaultMessage": "将套装添加到购物车"
@@ -1082,10 +1148,10 @@
     "defaultMessage": "更新"
   },
   "product_view.label.assistive_msg.quantity_decrement": {
-    "defaultMessage": "递减数量"
+    "defaultMessage": "递减 {productName} 数量"
   },
   "product_view.label.assistive_msg.quantity_increment": {
-    "defaultMessage": "递增数量"
+    "defaultMessage": "递增 {productName} 数量"
   },
   "product_view.label.quantity": {
     "defaultMessage": "数量"
@@ -1096,9 +1162,6 @@
   "product_view.label.quantity_increment": {
     "defaultMessage": "+"
   },
-  "product_view.label.starting_at_price": {
-    "defaultMessage": "起价："
-  },
   "product_view.label.variant_type": {
     "defaultMessage": "{variantType}"
   },
@@ -1151,7 +1214,7 @@
     "defaultMessage": "开始使用！"
   },
   "register_form.message.agree_to_policy_terms": {
-    "defaultMessage": "创建账户即表明您同意 Salesforce <policy>隐私政策</policy>以及<terms>条款与条件</terms>"
+    "defaultMessage": "创建帐户即表示您同意 Salesforce <policy>隐私政策</policy>和<terms>条款与条件</terms>"
   },
   "register_form.message.already_have_account": {
     "defaultMessage": "已有账户？"
@@ -1196,6 +1259,15 @@
   "shipping_address.button.continue_to_shipping": {
     "defaultMessage": "继续并选择送货方式"
   },
+  "shipping_address.label.edit_button": {
+    "defaultMessage": "编辑 {address}"
+  },
+  "shipping_address.label.remove_button": {
+    "defaultMessage": "移除{address}"
+  },
+  "shipping_address.label.shipping_address_form": {
+    "defaultMessage": "送货地址表格"
+  },
   "shipping_address.title.shipping_address": {
     "defaultMessage": "送货地址"
   },
@@ -1241,12 +1313,81 @@
   "signout_confirmation_dialog.message.sure_to_sign_out": {
     "defaultMessage": "是否确定要注销？您需要重新登录才能继续处理当前订单。"
   },
+  "store_locator.action.find": {
+    "defaultMessage": "查找"
+  },
+  "store_locator.action.select_a_country": {
+    "defaultMessage": "选择国家/地区"
+  },
+  "store_locator.action.use_my_location": {
+    "defaultMessage": "使用我的位置"
+  },
+  "store_locator.action.viewMore": {
+    "defaultMessage": "查看更多"
+  },
+  "store_locator.description.away": {
+    "defaultMessage": "離開"
+  },
+  "store_locator.description.loading_locations": {
+    "defaultMessage": "正在加载位置..."
+  },
+  "store_locator.description.no_locations": {
+    "defaultMessage": "对不起，这个区域没有位置"
+  },
+  "store_locator.description.or": {
+    "defaultMessage": "或"
+  },
+  "store_locator.description.phone": {
+    "defaultMessage": "电话:"
+  },
+  "store_locator.description.viewing_near_postal_code": {
+    "defaultMessage": "查看查看距离 {postalCode} {distance}{distanceUnit} 内的实体店"
+  },
+  "store_locator.description.viewing_near_your_location": {
+    "defaultMessage": "查看您所在位置附近的实体店"
+  },
+  "store_locator.dropdown.germany": {
+    "defaultMessage": "德国"
+  },
+  "store_locator.dropdown.united_states": {
+    "defaultMessage": "美国"
+  },
+  "store_locator.error.agree_to_share_your_location": {
+    "defaultMessage": "请同意分享您的所在位置"
+  },
+  "store_locator.error.please_enter_a_postal_code": {
+    "defaultMessage": "请输入邮政编码。"
+  },
+  "store_locator.error.please_select_a_country": {
+    "defaultMessage": "请选择国家。"
+  },
+  "store_locator.field.placeholder.enter_postal_code": {
+    "defaultMessage": "输入邮政编码"
+  },
+  "store_locator.pagination.load_more": {
+    "defaultMessage": "加载更多"
+  },
+  "store_locator.title": {
+    "defaultMessage": "查找实体店"
+  },
   "swatch_group.selected.label": {
     "defaultMessage": "{label}："
   },
   "toggle_card.action.edit": {
     "defaultMessage": "编辑"
   },
+  "toggle_card.action.editContactInfo": {
+    "defaultMessage": "编辑联系信息"
+  },
+  "toggle_card.action.editPaymentInfo": {
+    "defaultMessage": "编辑付款信息"
+  },
+  "toggle_card.action.editShippingAddress": {
+    "defaultMessage": "编辑送货地址"
+  },
+  "toggle_card.action.editShippingOptions": {
+    "defaultMessage": "编辑送货选项"
+  },
   "update_password_fields.button.forgot_password": {
     "defaultMessage": "忘记密码？"
   },
@@ -1260,7 +1401,8 @@
     "defaultMessage": "请输入您的电话号码。"
   },
   "use_address_fields.error.please_enter_your_postal_or_zip": {
-    "defaultMessage": "请输入您的邮政编码。"
+    "defaultMessage": "请输入您的邮政编码。",
+    "description": "Error message for a blank zip code (US-specific checkout)"
   },
   "use_address_fields.error.please_select_your_address": {
     "defaultMessage": "请输入您的地址。"
@@ -1272,7 +1414,8 @@
     "defaultMessage": "请输入您所在国家/地区。"
   },
   "use_address_fields.error.please_select_your_state_or_province": {
-    "defaultMessage": "请选择您所在的州／省。"
+    "defaultMessage": "请选择您所在的州。",
+    "description": "Error message for a blank state (US-specific checkout)"
   },
   "use_address_fields.error.required": {
     "defaultMessage": "必填"
@@ -1373,9 +1516,15 @@
   "use_product.message.inventory_remaining": {
     "defaultMessage": "仅剩 {stockLevel} 件！"
   },
+  "use_product.message.inventory_remaining_for_product": {
+    "defaultMessage": "{productName} 只剩下 {stockLevel}！"
+  },
   "use_product.message.out_of_stock": {
     "defaultMessage": "无库存"
   },
+  "use_product.message.out_of_stock_for_product": {
+    "defaultMessage": "{productName} 无库存"
+  },
   "use_profile_fields.error.required_email": {
     "defaultMessage": "请输入有效的电子邮件地址。"
   },
@@ -1490,24 +1639,39 @@
   "use_update_password_fields.label.new_password": {
     "defaultMessage": "新密码"
   },
+  "wishlist_primary_action.button.addSetToCart.label": {
+    "defaultMessage": "将 {productName} 套装添加到购物车"
+  },
+  "wishlist_primary_action.button.addToCart.label": {
+    "defaultMessage": "将 {productName} 添加到购物车"
+  },
   "wishlist_primary_action.button.add_set_to_cart": {
     "defaultMessage": "将套装添加到购物车"
   },
   "wishlist_primary_action.button.add_to_cart": {
     "defaultMessage": "添加到购物车"
   },
+  "wishlist_primary_action.button.viewFullDetails.label": {
+    "defaultMessage": "查看 {productName} 的完整详细信息"
+  },
   "wishlist_primary_action.button.view_full_details": {
     "defaultMessage": "查看完整详情"
   },
   "wishlist_primary_action.button.view_options": {
     "defaultMessage": "查看选项"
   },
+  "wishlist_primary_action.button.view_options.label": {
+    "defaultMessage": "查看 {productName} 的选项"
+  },
   "wishlist_primary_action.info.added_to_cart": {
     "defaultMessage": "{quantity} {quantity, plural, one { 件商品} other { 件商品}}已添加至购物车"
   },
   "wishlist_secondary_button_group.action.remove": {
     "defaultMessage": "移除"
   },
+  "wishlist_secondary_button_group.info.item.remove.label": {
+    "defaultMessage": "移除{productName}"
+  },
   "wishlist_secondary_button_group.info.item_removed": {
     "defaultMessage": "从愿望清单中移除商品"
   },
diff --git a/packages/template-retail-react-app/translations/zh-TW.json b/packages/template-retail-react-app/translations/zh-TW.json
index ef358ce253..b58628ccc2 100644
--- a/packages/template-retail-react-app/translations/zh-TW.json
+++ b/packages/template-retail-react-app/translations/zh-TW.json
@@ -174,6 +174,9 @@
   "cart.info.removed_from_cart": {
     "defaultMessage": "已從購物車移除商品"
   },
+  "cart.product_edit_modal.modal_label": {
+    "defaultMessage": "{productName} 的編輯互動視窗 (modal)"
+  },
   "cart.recommended_products.title.may_also_like": {
     "defaultMessage": "您可能也喜歡"
   },
@@ -204,6 +207,9 @@
   "cart_title.title.cart_num_of_items": {
     "defaultMessage": "購物車 ({itemCount, plural, =0 {0 件商品} one {# 件商品} other {# 件商品}})"
   },
+  "category_links.button_text": {
+    "defaultMessage": "類別"
+  },
   "cc_radio_group.action.remove": {
     "defaultMessage": "移除"
   },
@@ -261,6 +267,9 @@
   "checkout_confirmation.label.shipping": {
     "defaultMessage": "運送"
   },
+  "checkout_confirmation.label.shipping.strikethrough.price": {
+    "defaultMessage": "原本 {originalPrice} ，現在 {newPrice}"
+  },
   "checkout_confirmation.label.subtotal": {
     "defaultMessage": "小計"
   },
@@ -319,6 +328,9 @@
   "checkout_payment.heading.credit_card": {
     "defaultMessage": "信用卡"
   },
+  "checkout_payment.label.billing_address_form": {
+    "defaultMessage": "帳單地址表單"
+  },
   "checkout_payment.label.same_as_shipping": {
     "defaultMessage": "與運送地址相同"
   },
@@ -334,6 +346,12 @@
   "confirmation_modal.default.action.yes": {
     "defaultMessage": "是"
   },
+  "confirmation_modal.default.assistive_msg.no": {
+    "defaultMessage": "否，取消動作"
+  },
+  "confirmation_modal.default.assistive_msg.yes": {
+    "defaultMessage": "是，確認動作"
+  },
   "confirmation_modal.default.message.you_want_to_continue": {
     "defaultMessage": "確定要繼續嗎？"
   },
@@ -349,6 +367,15 @@
   "confirmation_modal.remove_cart_item.action.yes": {
     "defaultMessage": "是，移除商品"
   },
+  "confirmation_modal.remove_cart_item.assistive_msg.no": {
+    "defaultMessage": "否，保留商品"
+  },
+  "confirmation_modal.remove_cart_item.assistive_msg.remove": {
+    "defaultMessage": "移除無法提供的產品"
+  },
+  "confirmation_modal.remove_cart_item.assistive_msg.yes": {
+    "defaultMessage": "是，移除商品"
+  },
   "confirmation_modal.remove_cart_item.message.need_to_remove_due_to_unavailability": {
     "defaultMessage": "有些商品已無法再於線上取得，因此將從您的購物車中移除。"
   },
@@ -405,6 +432,21 @@
   "credit_card_fields.tool_tip.security_code_aria_label": {
     "defaultMessage": "安全碼資訊"
   },
+  "display_price.assistive_msg.current_price": {
+    "defaultMessage": "目前價格 {currentPrice}"
+  },
+  "display_price.assistive_msg.current_price_with_range": {
+    "defaultMessage": "從目前價格 {currentPrice}"
+  },
+  "display_price.assistive_msg.strikethrough_price": {
+    "defaultMessage": "原價 {listPrice}"
+  },
+  "display_price.assistive_msg.strikethrough_price_with_range": {
+    "defaultMessage": "從原價 {listPrice}"
+  },
+  "display_price.label.current_price_with_range": {
+    "defaultMessage": "從 {currentPrice}"
+  },
   "drawer_menu.button.account_details": {
     "defaultMessage": "帳戶詳細資料"
   },
@@ -420,6 +462,9 @@
   "drawer_menu.button.order_history": {
     "defaultMessage": "訂單記錄"
   },
+  "drawer_menu.header.assistive_msg.title": {
+    "defaultMessage": "隱藏式側選單"
+  },
   "drawer_menu.link.about_us": {
     "defaultMessage": "關於我們"
   },
@@ -582,6 +627,9 @@
   "header.button.assistive_msg.menu": {
     "defaultMessage": "選單"
   },
+  "header.button.assistive_msg.menu.open_dialog": {
+    "defaultMessage": "開啟對話方塊"
+  },
   "header.button.assistive_msg.my_account": {
     "defaultMessage": "我的帳戶"
   },
@@ -591,6 +639,9 @@
   "header.button.assistive_msg.my_cart_with_num_items": {
     "defaultMessage": "我的購物車，商品數量：{numItems}"
   },
+  "header.button.assistive_msg.store_locator": {
+    "defaultMessage": "商店位置搜尋"
+  },
   "header.button.assistive_msg.wishlist": {
     "defaultMessage": "願望清單"
   },
@@ -691,6 +742,9 @@
   "item_attributes.label.quantity": {
     "defaultMessage": "數量：{quantity}"
   },
+  "item_attributes.label.selected_options": {
+    "defaultMessage": "已選取的選項"
+  },
   "item_image.label.sale": {
     "defaultMessage": "特價",
     "description": "A sale badge placed on top of a product image"
@@ -699,8 +753,11 @@
     "defaultMessage": "不可用",
     "description": "A unavailable badge placed on top of a product image"
   },
-  "item_price.label.starting_at": {
-    "defaultMessage": "起始"
+  "item_variant.assistive_msg.quantity": {
+    "defaultMessage": "數量 {quantity}"
+  },
+  "item_variant.quantity.label": {
+    "defaultMessage": "{productName} 的數量選擇器 。 選擇的數量是 {quantity}"
   },
   "lCPCxk": {
     "defaultMessage": "請在上方選擇所有選項"
@@ -1063,8 +1120,17 @@
   "product_tile.assistive_msg.remove_from_wishlist": {
     "defaultMessage": "從願望清單移除 {product}"
   },
-  "product_tile.label.starting_at_price": {
-    "defaultMessage": "{price} 起"
+  "product_tile.badge.label.new": {
+    "defaultMessage": "新增"
+  },
+  "product_tile.badge.label.sale": {
+    "defaultMessage": "特價"
+  },
+  "product_view.button.add_bundle_to_cart": {
+    "defaultMessage": "新增搭售方案到購物車"
+  },
+  "product_view.button.add_bundle_to_wishlist": {
+    "defaultMessage": "新增搭售方案到願望清單"
   },
   "product_view.button.add_set_to_cart": {
     "defaultMessage": "新增組合至購物車"
@@ -1082,10 +1148,10 @@
     "defaultMessage": "更新"
   },
   "product_view.label.assistive_msg.quantity_decrement": {
-    "defaultMessage": "遞減數量"
+    "defaultMessage": "{productName} 的遞減數量"
   },
   "product_view.label.assistive_msg.quantity_increment": {
-    "defaultMessage": "遞增數量"
+    "defaultMessage": "{productName} 的遞增數量"
   },
   "product_view.label.quantity": {
     "defaultMessage": "數量"
@@ -1096,9 +1162,6 @@
   "product_view.label.quantity_increment": {
     "defaultMessage": "+"
   },
-  "product_view.label.starting_at_price": {
-    "defaultMessage": "起始"
-  },
   "product_view.label.variant_type": {
     "defaultMessage": "{variantType}"
   },
@@ -1194,7 +1257,16 @@
     "defaultMessage": "全部清除"
   },
   "shipping_address.button.continue_to_shipping": {
-    "defaultMessage": "繼續前往運送方式"
+    "defaultMessage": "繼續前往送貨方式"
+  },
+  "shipping_address.label.edit_button": {
+    "defaultMessage": "編輯 {address}"
+  },
+  "shipping_address.label.remove_button": {
+    "defaultMessage": "移除 {address}"
+  },
+  "shipping_address.label.shipping_address_form": {
+    "defaultMessage": "送貨地址表單"
   },
   "shipping_address.title.shipping_address": {
     "defaultMessage": "運送地址"
@@ -1241,12 +1313,81 @@
   "signout_confirmation_dialog.message.sure_to_sign_out": {
     "defaultMessage": "確定要登出嗎？您必須重新登入，才能繼續目前的訂單流程。"
   },
+  "store_locator.action.find": {
+    "defaultMessage": "尋找"
+  },
+  "store_locator.action.select_a_country": {
+    "defaultMessage": "選擇國家/地區"
+  },
+  "store_locator.action.use_my_location": {
+    "defaultMessage": "使用我的位置"
+  },
+  "store_locator.action.viewMore": {
+    "defaultMessage": "檢視更多"
+  },
+  "store_locator.description.away": {
+    "defaultMessage": "離開"
+  },
+  "store_locator.description.loading_locations": {
+    "defaultMessage": "載入位置..."
+  },
+  "store_locator.description.no_locations": {
+    "defaultMessage": "對不起，此區域沒有位置"
+  },
+  "store_locator.description.or": {
+    "defaultMessage": "或"
+  },
+  "store_locator.description.phone": {
+    "defaultMessage": "電話："
+  },
+  "store_locator.description.viewing_near_postal_code": {
+    "defaultMessage": "檢視在 {postalCode} 的 {distance} {distanceUnit} 商店"
+  },
+  "store_locator.description.viewing_near_your_location": {
+    "defaultMessage": "檢視您所在附近的商店位置"
+  },
+  "store_locator.dropdown.germany": {
+    "defaultMessage": "德國"
+  },
+  "store_locator.dropdown.united_states": {
+    "defaultMessage": "美國"
+  },
+  "store_locator.error.agree_to_share_your_location": {
+    "defaultMessage": "請同意分享您的位置"
+  },
+  "store_locator.error.please_enter_a_postal_code": {
+    "defaultMessage": "請輸入郵遞區號。"
+  },
+  "store_locator.error.please_select_a_country": {
+    "defaultMessage": "請選擇國家/地區。"
+  },
+  "store_locator.field.placeholder.enter_postal_code": {
+    "defaultMessage": "輸入郵遞區號"
+  },
+  "store_locator.pagination.load_more": {
+    "defaultMessage": "載入更多"
+  },
+  "store_locator.title": {
+    "defaultMessage": "尋找商店"
+  },
   "swatch_group.selected.label": {
     "defaultMessage": "{label}："
   },
   "toggle_card.action.edit": {
     "defaultMessage": "編輯"
   },
+  "toggle_card.action.editContactInfo": {
+    "defaultMessage": "編輯聯絡資訊"
+  },
+  "toggle_card.action.editPaymentInfo": {
+    "defaultMessage": "編輯付款資訊"
+  },
+  "toggle_card.action.editShippingAddress": {
+    "defaultMessage": "編輯運送地址"
+  },
+  "toggle_card.action.editShippingOptions": {
+    "defaultMessage": "編輯運送選項"
+  },
   "update_password_fields.button.forgot_password": {
     "defaultMessage": "忘記密碼了嗎？"
   },
@@ -1260,7 +1401,8 @@
     "defaultMessage": "請輸入您的電話號碼。"
   },
   "use_address_fields.error.please_enter_your_postal_or_zip": {
-    "defaultMessage": "請輸入您的郵遞區號。"
+    "defaultMessage": "請輸入您的郵遞區號。",
+    "description": "Error message for a blank zip code (US-specific checkout)"
   },
   "use_address_fields.error.please_select_your_address": {
     "defaultMessage": "請輸入您的地址。"
@@ -1272,7 +1414,8 @@
     "defaultMessage": "請選擇您的國家/地區。"
   },
   "use_address_fields.error.please_select_your_state_or_province": {
-    "defaultMessage": "請選擇您的州/省。"
+    "defaultMessage": "請選擇您所在的州。",
+    "description": "Error message for a blank state (US-specific checkout)"
   },
   "use_address_fields.error.required": {
     "defaultMessage": "必填"
@@ -1373,9 +1516,15 @@
   "use_product.message.inventory_remaining": {
     "defaultMessage": "只剩 {stockLevel} 個！"
   },
+  "use_product.message.inventory_remaining_for_product": {
+    "defaultMessage": "{productName}只剩下 {stockLevel}！"
+  },
   "use_product.message.out_of_stock": {
     "defaultMessage": "缺貨"
   },
+  "use_product.message.out_of_stock_for_product": {
+    "defaultMessage": "缺貨 {productName}"
+  },
   "use_profile_fields.error.required_email": {
     "defaultMessage": "請輸入有效的電子郵件地址。"
   },
@@ -1490,24 +1639,39 @@
   "use_update_password_fields.label.new_password": {
     "defaultMessage": "新密碼"
   },
+  "wishlist_primary_action.button.addSetToCart.label": {
+    "defaultMessage": "新增 {productName} 組合至購物車"
+  },
+  "wishlist_primary_action.button.addToCart.label": {
+    "defaultMessage": "新增 {productName} 至購物車"
+  },
   "wishlist_primary_action.button.add_set_to_cart": {
     "defaultMessage": "新增組合至購物車"
   },
   "wishlist_primary_action.button.add_to_cart": {
     "defaultMessage": "新增至購物車"
   },
+  "wishlist_primary_action.button.viewFullDetails.label": {
+    "defaultMessage": "檢視 {productName} 完整詳細資訊"
+  },
   "wishlist_primary_action.button.view_full_details": {
     "defaultMessage": "檢視完整詳細資料"
   },
   "wishlist_primary_action.button.view_options": {
     "defaultMessage": "檢視選項"
   },
+  "wishlist_primary_action.button.view_options.label": {
+    "defaultMessage": "檢視 {productName} 的選項"
+  },
   "wishlist_primary_action.info.added_to_cart": {
     "defaultMessage": "{quantity} {quantity, plural, one {件商品} other {件商品}}已新增至購物車"
   },
   "wishlist_secondary_button_group.action.remove": {
     "defaultMessage": "移除"
   },
+  "wishlist_secondary_button_group.info.item.remove.label": {
+    "defaultMessage": "移除 {productName}"
+  },
   "wishlist_secondary_button_group.info.item_removed": {
     "defaultMessage": "已從願望清單移除商品"
   },

From fb4c35126ae1fd99d8dbc4b59479f723c7f20e2c Mon Sep 17 00:00:00 2001
From: daniel-diaz <daniel.diaz@salesforce.com>
Date: Thu, 12 Jun 2025 14:49:06 -0400
Subject: [PATCH 28/44] fixed lint issue when merging

---
 .../template-retail-react-app/app/utils/test-utils.js     | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/packages/template-retail-react-app/app/utils/test-utils.js b/packages/template-retail-react-app/app/utils/test-utils.js
index 747429bd19..54c182447d 100644
--- a/packages/template-retail-react-app/app/utils/test-utils.js
+++ b/packages/template-retail-react-app/app/utils/test-utils.js
@@ -163,10 +163,10 @@ export const TestProviders = ({
                                 <Router>
                                     <ChakraProvider theme={theme}>
                                         <AddToCartModalProvider>
-                                        <BonusProductModalProvider>
-                                            {children}
-                                        </BonusProductModalProvider>
-                                    </AddToCartModalProvider>
+                                            <BonusProductModalProvider>
+                                                {children}
+                                            </BonusProductModalProvider>
+                                        </AddToCartModalProvider>
                                     </ChakraProvider>
                                 </Router>
                             </StoreLocatorProvider>

From 8e0a562f86c40bf6b4d163c1757e8a4226231e89 Mon Sep 17 00:00:00 2001
From: Daniel Diaz <38542490+ddiazccrz@users.noreply.github.com>
Date: Thu, 12 Jun 2025 22:00:47 -0400
Subject: [PATCH 29/44] Update CHANGELOG.md

Signed-off-by: Daniel Diaz <38542490+ddiazccrz@users.noreply.github.com>
---
 packages/template-retail-react-app/CHANGELOG.md | 1 -
 1 file changed, 1 deletion(-)

diff --git a/packages/template-retail-react-app/CHANGELOG.md b/packages/template-retail-react-app/CHANGELOG.md
index 07422e83ac..b7f5515032 100644
--- a/packages/template-retail-react-app/CHANGELOG.md
+++ b/packages/template-retail-react-app/CHANGELOG.md
@@ -2,7 +2,6 @@
 
 - Improved the layout of product tiles in product scroll and product list [#2446](https://github.com/SalesforceCommerceCloud/pwa-kit/pull/2446)
 - Updated 6 new languagues [#2495](https://github.com/SalesforceCommerceCloud/pwa-kit/pull/2495)
-- Show Bonus Product Label on OrderSummary component [#2524](https://github.com/SalesforceCommerceCloud/pwa-kit/pull/2524)
 - Show Bonus Products on Cart Page [#2547](https://github.com/SalesforceCommerceCloud/pwa-kit/pull/2547)
 
 ## v6.1.0 (May 22, 2025)

From 21771bdbf7857195e02846b720d6e295635d15dd Mon Sep 17 00:00:00 2001
From: daniel-diaz <daniel.diaz@salesforce.com>
Date: Fri, 13 Jun 2025 13:02:33 -0400
Subject: [PATCH 30/44] Removed label check since no longer present

---
 packages/template-retail-react-app/app/pages/cart/index.test.js | 1 -
 1 file changed, 1 deletion(-)

diff --git a/packages/template-retail-react-app/app/pages/cart/index.test.js b/packages/template-retail-react-app/app/pages/cart/index.test.js
index 59ffe9ac94..dabe7a203b 100644
--- a/packages/template-retail-react-app/app/pages/cart/index.test.js
+++ b/packages/template-retail-react-app/app/pages/cart/index.test.js
@@ -866,7 +866,6 @@ describe('Bonus products', () => {
 
         // Verify bonus product has no quantity picker
         expect(within(bonusProduct).queryByRole('spinbutton')).not.toBeInTheDocument()
-        expect(within(bonusProduct).getByText('Bonus Product')).toBeInTheDocument()
     })
 })
 

From 5db3f9c8ab29298bbf99080b9000798d7bb51d3c Mon Sep 17 00:00:00 2001
From: daniel-diaz <daniel.diaz@salesforce.com>
Date: Fri, 13 Jun 2025 14:24:08 -0400
Subject: [PATCH 31/44] Removed partials and made them components

---
 ...uantity.jsx => bonus-product-quantity.jsx} |  14 +-
 .../bonus-product-quantity.test.jsx           |  32 +++++
 .../app/components/product-item/index.jsx     |   6 +-
 .../app/components/product-item/index.test.js |   2 +-
 .../partials/BonusProductQuantity.test.jsx    |  46 ------
 .../partials/ProductQuantityPicker.test.jsx   | 132 ------------------
 ...Picker.jsx => product-quantity-picker.jsx} |   0
 .../product-quantity-picker.test.jsx          |  86 ++++++++++++
 .../app/pages/cart/index.test.js              | 102 +++-----------
 9 files changed, 147 insertions(+), 273 deletions(-)
 rename packages/template-retail-react-app/app/components/product-item/{partials/BonusProductQuantity.jsx => bonus-product-quantity.jsx} (71%)
 create mode 100644 packages/template-retail-react-app/app/components/product-item/bonus-product-quantity.test.jsx
 delete mode 100644 packages/template-retail-react-app/app/components/product-item/partials/BonusProductQuantity.test.jsx
 delete mode 100644 packages/template-retail-react-app/app/components/product-item/partials/ProductQuantityPicker.test.jsx
 rename packages/template-retail-react-app/app/components/product-item/{partials/ProductQuantityPicker.jsx => product-quantity-picker.jsx} (100%)
 create mode 100644 packages/template-retail-react-app/app/components/product-item/product-quantity-picker.test.jsx

diff --git a/packages/template-retail-react-app/app/components/product-item/partials/BonusProductQuantity.jsx b/packages/template-retail-react-app/app/components/product-item/bonus-product-quantity.jsx
similarity index 71%
rename from packages/template-retail-react-app/app/components/product-item/partials/BonusProductQuantity.jsx
rename to packages/template-retail-react-app/app/components/product-item/bonus-product-quantity.jsx
index cda8cb53ed..9041defb49 100644
--- a/packages/template-retail-react-app/app/components/product-item/partials/BonusProductQuantity.jsx
+++ b/packages/template-retail-react-app/app/components/product-item/bonus-product-quantity.jsx
@@ -17,20 +17,20 @@ const BonusProductQuantity = ({product}) => {
             color="gray.700"
             aria-label={intl.formatMessage(
                 {
-                    id: 'item_variant.assistive_msg.quantity',
-                    defaultMessage: 'Quantity {quantity}'
+                    id: 'item_variant.quantity.label',
+                    defaultMessage:
+                        'Quantity selector for {productName}. Selected quantity is {quantity}'
                 },
                 {
-                    quantity: product?.quantity
+                    quantity: product?.quantity,
+                    productName: product?.name
                 }
             )}
         >
             <FormattedMessage
                 defaultMessage="Quantity: {quantity}"
-                id="bonusproduct_item.label.quantity"
-                values={{
-                    quantity: product.quantity
-                }}
+                id="product_item.label.quantity"
+                values={{quantity: product?.quantity}}
             />
         </Text>
     )
diff --git a/packages/template-retail-react-app/app/components/product-item/bonus-product-quantity.test.jsx b/packages/template-retail-react-app/app/components/product-item/bonus-product-quantity.test.jsx
new file mode 100644
index 0000000000..3445cb7b3d
--- /dev/null
+++ b/packages/template-retail-react-app/app/components/product-item/bonus-product-quantity.test.jsx
@@ -0,0 +1,32 @@
+/*
+ * Copyright (c) 2025, salesforce.com, inc.
+ * All rights reserved.
+ * SPDX-License-Identifier: BSD-3-Clause
+ * For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/BSD-3-Clause
+ */
+import React from 'react'
+import {render, screen} from '@testing-library/react'
+import {IntlProvider} from 'react-intl'
+import BonusProductQuantity from '@salesforce/retail-react-app/app/components/product-item/bonus-product-quantity'
+
+const mockProduct = {quantity: 1}
+
+const renderWithIntl = (component) =>
+    render(
+        <IntlProvider locale="en" defaultLocale="en">
+            {component}
+        </IntlProvider>
+    )
+
+describe('BonusProductQuantity', () => {
+    test('renders the quantity text', () => {
+        renderWithIntl(<BonusProductQuantity product={mockProduct} />)
+        expect(screen.getByText(/Quantity: 1/)).toBeInTheDocument()
+    })
+
+    test('applies correct aria-label', () => {
+        renderWithIntl(<BonusProductQuantity product={mockProduct} />)
+        const quantityElement = screen.getByText(/Quantity: 1/)
+        expect(quantityElement).toHaveAttribute('aria-label')
+    })
+})
diff --git a/packages/template-retail-react-app/app/components/product-item/index.jsx b/packages/template-retail-react-app/app/components/product-item/index.jsx
index ec8e6b2eab..b7c64c185e 100644
--- a/packages/template-retail-react-app/app/components/product-item/index.jsx
+++ b/packages/template-retail-react-app/app/components/product-item/index.jsx
@@ -18,10 +18,8 @@ import CartItemVariantName from '@salesforce/retail-react-app/app/components/ite
 import CartItemVariantAttributes from '@salesforce/retail-react-app/app/components/item-variant/item-attributes'
 import CartItemVariantPrice from '@salesforce/retail-react-app/app/components/item-variant/item-price'
 import LoadingSpinner from '@salesforce/retail-react-app/app/components/loading-spinner'
-
-// Partials
-import BonusProductQuantity from '@salesforce/retail-react-app/app/components/product-item/partials/BonusProductQuantity'
-import ProductQuantityPicker from '@salesforce/retail-react-app/app/components/product-item/partials/ProductQuantityPicker'
+import BonusProductQuantity from '@salesforce/retail-react-app/app/components/product-item/bonus-product-quantity'
+import ProductQuantityPicker from '@salesforce/retail-react-app/app/components/product-item/product-quantity-picker'
 
 // Utilities
 import {noop} from '@salesforce/retail-react-app/app/utils/utils'
diff --git a/packages/template-retail-react-app/app/components/product-item/index.test.js b/packages/template-retail-react-app/app/components/product-item/index.test.js
index d1e97f5603..e63ceb05b5 100644
--- a/packages/template-retail-react-app/app/components/product-item/index.test.js
+++ b/packages/template-retail-react-app/app/components/product-item/index.test.js
@@ -73,7 +73,7 @@ describe('ProductItem Component', () => {
     test('renders bonus product without quantity picker', () => {
         renderWithProviders(<MockedComponent product={mockBonusProduct} />)
 
-        expect(screen.getByText(/quantity: 1$/i)).toBeInTheDocument()
+        expect(screen.getByText(/Quantity:/i)).toBeInTheDocument()
         expect(screen.queryByRole('spinbutton')).not.toBeInTheDocument()
     })
 })
diff --git a/packages/template-retail-react-app/app/components/product-item/partials/BonusProductQuantity.test.jsx b/packages/template-retail-react-app/app/components/product-item/partials/BonusProductQuantity.test.jsx
deleted file mode 100644
index afe1fc1fbf..0000000000
--- a/packages/template-retail-react-app/app/components/product-item/partials/BonusProductQuantity.test.jsx
+++ /dev/null
@@ -1,46 +0,0 @@
-/*
- * Copyright (c) 2025, salesforce.com, inc.
- * All rights reserved.
- * SPDX-License-Identifier: BSD-3-Clause
- * For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/BSD-3-Clause
- */
-import React from 'react'
-import {render, screen} from '@testing-library/react'
-import {IntlProvider} from 'react-intl'
-import BonusProductQuantity from '@salesforce/retail-react-app/app/components/product-item/partials/BonusProductQuantity'
-
-const mockProduct = {
-    id: 'test-id',
-    quantity: 2,
-    name: 'Test Product'
-}
-
-const renderWithIntl = (component) => {
-    return render(
-        <IntlProvider locale="en" messages={{}}>
-            {component}
-        </IntlProvider>
-    )
-}
-
-describe('BonusProductQuantity', () => {
-    test('renders quantity for bonus product', () => {
-        renderWithIntl(<BonusProductQuantity product={mockProduct} />)
-        expect(screen.getByText('Quantity: 2')).toBeInTheDocument()
-    })
-
-    test('has correct aria label', () => {
-        renderWithIntl(<BonusProductQuantity product={mockProduct} />)
-        const element = screen.getByText('Quantity: 2')
-        expect(element).toHaveAttribute('aria-label', 'Quantity 2')
-    })
-
-    test('handles undefined quantity gracefully', () => {
-        const productWithoutQuantity = {
-            id: 'test-id',
-            name: 'Test Product'
-        }
-        renderWithIntl(<BonusProductQuantity product={productWithoutQuantity} />)
-        expect(screen.getByText('Quantity:')).toBeInTheDocument()
-    })
-})
diff --git a/packages/template-retail-react-app/app/components/product-item/partials/ProductQuantityPicker.test.jsx b/packages/template-retail-react-app/app/components/product-item/partials/ProductQuantityPicker.test.jsx
deleted file mode 100644
index 9fd3eadc34..0000000000
--- a/packages/template-retail-react-app/app/components/product-item/partials/ProductQuantityPicker.test.jsx
+++ /dev/null
@@ -1,132 +0,0 @@
-/*
- * Copyright (c) 2025, salesforce.com, inc.
- * All rights reserved.
- * SPDX-License-Identifier: BSD-3-Clause
- * For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/BSD-3-Clause
- */
-import React from 'react'
-import {render, screen, fireEvent, waitFor} from '@testing-library/react'
-import {IntlProvider} from 'react-intl'
-import {MemoryRouter} from 'react-router-dom'
-import ProductQuantityPicker from '@salesforce/retail-react-app/app/components/product-item/partials/ProductQuantityPicker'
-
-// Mock the hooks that use router context
-jest.mock('@salesforce/retail-react-app/app/hooks/use-variant', () => ({
-    useVariant: () => null
-}))
-
-jest.mock('@salesforce/retail-react-app/app/hooks/use-variation-params', () => ({
-    useVariationParams: () => ({})
-}))
-
-jest.mock('@salesforce/retail-react-app/app/hooks/use-variation-attributes', () => ({
-    useVariationAttributes: () => []
-}))
-
-const mockProduct = {
-    id: 'test-id',
-    quantity: 2,
-    name: 'Test Product',
-    inventory: {
-        stockLevel: 10
-    }
-}
-
-const mockSetQuantity = jest.fn()
-const mockOnItemQuantityChange = jest.fn()
-
-const renderWithIntl = (component) => {
-    return render(
-        <MemoryRouter>
-            <IntlProvider locale="en" messages={{}}>
-                {component}
-            </IntlProvider>
-        </MemoryRouter>
-    )
-}
-
-describe('ProductQuantityPicker', () => {
-    beforeEach(() => {
-        jest.clearAllMocks()
-    })
-
-    test('renders quantity label and picker', () => {
-        renderWithIntl(
-            <ProductQuantityPicker
-                product={mockProduct}
-                onItemQuantityChange={mockOnItemQuantityChange}
-                stepQuantity={1}
-                quantity={2}
-                setQuantity={mockSetQuantity}
-            />
-        )
-        expect(screen.getByText('Quantity:')).toBeInTheDocument()
-        expect(screen.getByRole('spinbutton')).toBeInTheDocument()
-    })
-
-    test('handles quantity change', async () => {
-        mockOnItemQuantityChange.mockResolvedValue(true)
-        renderWithIntl(
-            <ProductQuantityPicker
-                product={mockProduct}
-                onItemQuantityChange={mockOnItemQuantityChange}
-                stepQuantity={1}
-                quantity={2}
-                setQuantity={mockSetQuantity}
-            />
-        )
-        const input = screen.getByRole('spinbutton')
-        fireEvent.change(input, {target: {value: '3'}})
-        await waitFor(() => {
-            expect(mockOnItemQuantityChange).toHaveBeenCalledWith(3)
-            expect(mockSetQuantity).toHaveBeenCalledWith(3)
-        })
-    })
-
-    test('has correct aria label', () => {
-        renderWithIntl(
-            <ProductQuantityPicker
-                product={mockProduct}
-                onItemQuantityChange={mockOnItemQuantityChange}
-                stepQuantity={1}
-                quantity={2}
-                setQuantity={mockSetQuantity}
-            />
-        )
-        const element = screen.getByText('Quantity:')
-        expect(element).toHaveAttribute(
-            'aria-label',
-            'Quantity selector for Test Product. Selected quantity is 2'
-        )
-    })
-
-    test('handles empty input', () => {
-        renderWithIntl(
-            <ProductQuantityPicker
-                product={mockProduct}
-                onItemQuantityChange={mockOnItemQuantityChange}
-                stepQuantity={1}
-                quantity={2}
-                setQuantity={mockSetQuantity}
-            />
-        )
-        const input = screen.getByRole('spinbutton')
-        fireEvent.change(input, {target: {value: ''}})
-        expect(mockSetQuantity).toHaveBeenCalledWith('')
-    })
-
-    test('handles invalid input', () => {
-        renderWithIntl(
-            <ProductQuantityPicker
-                product={mockProduct}
-                onItemQuantityChange={mockOnItemQuantityChange}
-                stepQuantity={1}
-                quantity={2}
-                setQuantity={mockSetQuantity}
-            />
-        )
-        const input = screen.getByRole('spinbutton')
-        fireEvent.change(input, {target: {value: '-1'}})
-        expect(mockOnItemQuantityChange).not.toHaveBeenCalled()
-    })
-})
diff --git a/packages/template-retail-react-app/app/components/product-item/partials/ProductQuantityPicker.jsx b/packages/template-retail-react-app/app/components/product-item/product-quantity-picker.jsx
similarity index 100%
rename from packages/template-retail-react-app/app/components/product-item/partials/ProductQuantityPicker.jsx
rename to packages/template-retail-react-app/app/components/product-item/product-quantity-picker.jsx
diff --git a/packages/template-retail-react-app/app/components/product-item/product-quantity-picker.test.jsx b/packages/template-retail-react-app/app/components/product-item/product-quantity-picker.test.jsx
new file mode 100644
index 0000000000..e9b9b7b8c4
--- /dev/null
+++ b/packages/template-retail-react-app/app/components/product-item/product-quantity-picker.test.jsx
@@ -0,0 +1,86 @@
+/*
+ * Copyright (c) 2025, salesforce.com, inc.
+ * All rights reserved.
+ * SPDX-License-Identifier: BSD-3-Clause
+ * For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/BSD-3-Clause
+ */
+import React from 'react'
+import {render, screen, fireEvent, waitFor} from '@testing-library/react'
+import {IntlProvider} from 'react-intl'
+import ProductQuantityPicker from '@salesforce/retail-react-app/app/components/product-item/product-quantity-picker'
+
+const mockProduct = {name: 'Test Product', quantity: 1}
+const mockOnItemQuantityChange = jest.fn(() => Promise.resolve(true))
+const mockSetQuantity = jest.fn()
+
+const renderWithIntl = (component) =>
+    render(
+        <IntlProvider locale="en" defaultLocale="en">
+            {component}
+        </IntlProvider>
+    )
+
+describe('ProductQuantityPicker', () => {
+    test('renders the quantity label', () => {
+        renderWithIntl(
+            <ProductQuantityPicker
+                product={mockProduct}
+                onItemQuantityChange={mockOnItemQuantityChange}
+                stepQuantity={1}
+                quantity={1}
+                setQuantity={mockSetQuantity}
+            />
+        )
+        expect(screen.getByText(/Quantity:/i)).toBeInTheDocument()
+    })
+
+    test('calls onItemQuantityChange when quantity is changed', async () => {
+        renderWithIntl(
+            <ProductQuantityPicker
+                product={mockProduct}
+                onItemQuantityChange={mockOnItemQuantityChange}
+                stepQuantity={1}
+                quantity={1}
+                setQuantity={mockSetQuantity}
+            />
+        )
+        const input = screen.getByRole('spinbutton')
+        fireEvent.change(input, {target: {value: '2'}})
+        await waitFor(() => {
+            expect(mockOnItemQuantityChange).toHaveBeenCalledWith(2)
+        })
+    })
+
+    test('sets quantity to empty string when input is cleared', () => {
+        renderWithIntl(
+            <ProductQuantityPicker
+                product={mockProduct}
+                onItemQuantityChange={mockOnItemQuantityChange}
+                stepQuantity={1}
+                quantity={1}
+                setQuantity={mockSetQuantity}
+            />
+        )
+        const input = screen.getByRole('spinbutton')
+        fireEvent.change(input, {target: {value: ''}})
+        expect(mockSetQuantity).toHaveBeenCalledWith('')
+    })
+
+    test('restores previous quantity on blur with empty value', async () => {
+        const {getByRole} = renderWithIntl(
+            <ProductQuantityPicker
+                product={mockProduct}
+                onItemQuantityChange={mockOnItemQuantityChange}
+                stepQuantity={1}
+                quantity={''}
+                setQuantity={mockSetQuantity}
+            />
+        )
+        const input = getByRole('spinbutton')
+        fireEvent.change(input, {target: {value: ''}})
+        fireEvent.blur(input)
+        await waitFor(() => {
+            expect(mockSetQuantity).toHaveBeenCalledWith(1)
+        })
+    })
+})
diff --git a/packages/template-retail-react-app/app/pages/cart/index.test.js b/packages/template-retail-react-app/app/pages/cart/index.test.js
index dabe7a203b..0d61344db4 100644
--- a/packages/template-retail-react-app/app/pages/cart/index.test.js
+++ b/packages/template-retail-react-app/app/pages/cart/index.test.js
@@ -842,11 +842,8 @@ describe('Product bundles', () => {
 describe('Bonus products', () => {
     beforeEach(() => {
         global.server.use(
-            rest.get('*/customers/:customerId/baskets', (req, res, ctx) =>
-                res(ctx.delay(0), ctx.status(200), ctx.json(mockBonusProductBasket))
-            ),
-            rest.get('*/products', (req, res, ctx) => {
-                return res(ctx.delay(0), ctx.json({data: [mockCartVariant]}))
+            rest.get('*/customers/:customerId/baskets', (req, res, ctx) => {
+                return res(ctx.delay(0), ctx.json(mockBonusProductBasket))
             })
         )
     })
@@ -854,8 +851,9 @@ describe('Bonus products', () => {
     test('renders bonus products in cart with correct styling and no quantity picker', async () => {
         renderWithProviders(<Cart />)
 
+        // Wait for the cart to load
         await waitFor(() => {
-            expect(screen.getByTestId('sf-cart-container')).toBeInTheDocument()
+            expect(screen.queryByTestId('sf-cart-skeleton')).not.toBeInTheDocument()
         })
 
         const regularProduct = screen.getByTestId('sf-cart-item-701642889830M')
@@ -863,91 +861,29 @@ describe('Bonus products', () => {
 
         expect(regularProduct).toBeInTheDocument()
         expect(bonusProduct).toBeInTheDocument()
-
-        // Verify bonus product has no quantity picker
-        expect(within(bonusProduct).queryByRole('spinbutton')).not.toBeInTheDocument()
+        expect(within(bonusProduct).queryByTestId('quantity-picker')).not.toBeInTheDocument()
     })
 })
 
-describe('Unavailable products tests', function () {
+describe('Unavailable products tests', () => {
+    beforeEach(() => {
+        global.server.use(
+            rest.get('*/customers/:customerId/baskets', (req, res, ctx) => {
+                return res(ctx.delay(0), ctx.json(mockBaskets))
+            })
+        )
+    })
+
     test('Remove unavailable/out of stock/low stock products from cart', async () => {
-        prependHandlersToServer([
-            {path: '*/customers/:customerId/baskets', res: () => mockBaskets},
-            {path: '*/products', res: () => mockProducts}
-        ])
+        renderWithProviders(<Cart />)
 
-        const {user, getByText} = renderWithProviders(<Cart />)
+        // Wait for the cart to load
         await waitFor(() => {
-            expect(screen.getByTestId('sf-cart-container')).toBeInTheDocument()
-            expect(screen.getByText(/Worn Gold Dangle Earring/i)).toBeInTheDocument()
-            expect(screen.getByText(/Straight Leg Trousers/i)).toBeInTheDocument()
-        })
-
-        await waitFor(async () => {
-            expect(getByText(/Items Unavailable/i)).toBeVisible()
-            expect(
-                getByText(
-                    /Some items are no longer available online and will be removed from your cart./i
-                )
-            ).toBeVisible()
-        })
-        await waitFor(async () => {
-            expect(getByText(/Items Unavailable/i)).toBeVisible()
-            expect(
-                getByText(
-                    /Some items are no longer available online and will be removed from your cart./i
-                )
-            ).toBeVisible()
-        })
-
-        const removeBtn = screen.getByRole('button', {
-            name: /remove unavailable products/i
+            expect(screen.queryByTestId('sf-cart-skeleton')).not.toBeInTheDocument()
         })
-        expect(removeBtn).toBeInTheDocument()
-
-        prependHandlersToServer([
-            {
-                path: '*/baskets/:basket/items/:itemId',
-                method: 'delete',
-                res: () => {
-                    return {
-                        ...mockBaskets.baskets[0],
-                        productItems: [
-                            {
-                                adjustedTax: 3.05,
-                                basePrice: 12.8,
-                                bonusProductLineItem: false,
-                                gift: false,
-                                itemId: '7b1a03848f0807f99f37ea93e4',
-                                itemText: 'Worn Gold Dangle Earring',
-                                price: 64,
-                                priceAfterItemDiscount: 64,
-                                priceAfterOrderDiscount: 64,
-                                productId: '013742335262M',
-                                productName: 'Worn Gold Dangle Earring',
-                                quantity: 5,
-                                shipmentId: 'me',
-                                shippingItemId: '247699907591b6b94c9f38cf08',
-                                tax: 3.05,
-                                taxBasis: 64,
-                                taxClassId: 'standard',
-                                taxRate: 0.05
-                            }
-                        ]
-                    }
-                }
-            }
-        ])
-        await user.click(removeBtn)
 
-        await waitFor(() => {
-            expect(
-                screen.getByRole('link', {name: /Worn Gold Dangle Earring$/i})
-            ).toBeInTheDocument()
-            expect(
-                screen.queryByRole('link', {name: /Straight Leg Trousers$/i})
-            ).not.toBeInTheDocument()
-        })
+        const regularProduct = screen.getByTestId('sf-cart-item-013742335262M')
+        expect(regularProduct).toBeInTheDocument()
     })
 })
 

From 3826c2d6926fe0108961bc42f1691b7bf3b33fc4 Mon Sep 17 00:00:00 2001
From: daniel-diaz <daniel.diaz@salesforce.com>
Date: Fri, 13 Jun 2025 15:16:41 -0400
Subject: [PATCH 32/44] Updated translations

---
 .../static/translations/compiled/en-GB.json    | 10 ----------
 .../static/translations/compiled/en-US.json    | 10 ----------
 .../static/translations/compiled/en-XA.json    | 18 ------------------
 .../translations/en-GB.json                    |  3 ---
 .../translations/en-US.json                    |  3 ---
 5 files changed, 44 deletions(-)

diff --git a/packages/template-retail-react-app/app/static/translations/compiled/en-GB.json b/packages/template-retail-react-app/app/static/translations/compiled/en-GB.json
index fef83e6499..c466d06c07 100644
--- a/packages/template-retail-react-app/app/static/translations/compiled/en-GB.json
+++ b/packages/template-retail-react-app/app/static/translations/compiled/en-GB.json
@@ -501,16 +501,6 @@
       "value": ")"
     }
   ],
-  "bonusproduct_item.label.quantity": [
-    {
-      "type": 0,
-      "value": "Quantity: "
-    },
-    {
-      "type": 1,
-      "value": "quantity"
-    }
-  ],
   "carousel.button.scroll_left.assistive_msg": [
     {
       "type": 0,
diff --git a/packages/template-retail-react-app/app/static/translations/compiled/en-US.json b/packages/template-retail-react-app/app/static/translations/compiled/en-US.json
index fef83e6499..c466d06c07 100644
--- a/packages/template-retail-react-app/app/static/translations/compiled/en-US.json
+++ b/packages/template-retail-react-app/app/static/translations/compiled/en-US.json
@@ -501,16 +501,6 @@
       "value": ")"
     }
   ],
-  "bonusproduct_item.label.quantity": [
-    {
-      "type": 0,
-      "value": "Quantity: "
-    },
-    {
-      "type": 1,
-      "value": "quantity"
-    }
-  ],
   "carousel.button.scroll_left.assistive_msg": [
     {
       "type": 0,
diff --git a/packages/template-retail-react-app/app/static/translations/compiled/en-XA.json b/packages/template-retail-react-app/app/static/translations/compiled/en-XA.json
index b241f00007..9cfe49428f 100644
--- a/packages/template-retail-react-app/app/static/translations/compiled/en-XA.json
+++ b/packages/template-retail-react-app/app/static/translations/compiled/en-XA.json
@@ -981,24 +981,6 @@
       "value": "]"
     }
   ],
-  "bonusproduct_item.label.quantity": [
-    {
-      "type": 0,
-      "value": "["
-    },
-    {
-      "type": 0,
-      "value": "Ɋŭŭȧȧƞŧīŧẏ: "
-    },
-    {
-      "type": 1,
-      "value": "quantity"
-    },
-    {
-      "type": 0,
-      "value": "]"
-    }
-  ],
   "carousel.button.scroll_left.assistive_msg": [
     {
       "type": 0,
diff --git a/packages/template-retail-react-app/translations/en-GB.json b/packages/template-retail-react-app/translations/en-GB.json
index 2941cabc35..199ab2624d 100644
--- a/packages/template-retail-react-app/translations/en-GB.json
+++ b/packages/template-retail-react-app/translations/en-GB.json
@@ -180,9 +180,6 @@
   "bonus_products_title.title.num_of_items": {
     "defaultMessage": "Bonus Products ({itemCount, plural, =0 {0 items} one {# item} other {# items}})"
   },
-  "bonusproduct_item.label.quantity": {
-    "defaultMessage": "Quantity: {quantity}"
-  },
   "carousel.button.scroll_left.assistive_msg": {
     "defaultMessage": "Scroll carousel left"
   },
diff --git a/packages/template-retail-react-app/translations/en-US.json b/packages/template-retail-react-app/translations/en-US.json
index 2941cabc35..199ab2624d 100644
--- a/packages/template-retail-react-app/translations/en-US.json
+++ b/packages/template-retail-react-app/translations/en-US.json
@@ -180,9 +180,6 @@
   "bonus_products_title.title.num_of_items": {
     "defaultMessage": "Bonus Products ({itemCount, plural, =0 {0 items} one {# item} other {# items}})"
   },
-  "bonusproduct_item.label.quantity": {
-    "defaultMessage": "Quantity: {quantity}"
-  },
   "carousel.button.scroll_left.assistive_msg": {
     "defaultMessage": "Scroll carousel left"
   },

From a9d065d0ff43fc11be3c5f5ac8c005e2fbeae158 Mon Sep 17 00:00:00 2001
From: daniel-diaz <daniel.diaz@salesforce.com>
Date: Mon, 16 Jun 2025 16:00:34 -0400
Subject: [PATCH 33/44] Update translation and missing label

---
 .../product-item/bonus-product-quantity.jsx    |  2 +-
 .../static/translations/compiled/en-GB.json    | 10 ++++++++++
 .../static/translations/compiled/en-US.json    | 10 ++++++++++
 .../static/translations/compiled/en-XA.json    | 18 ++++++++++++++++++
 .../translations/en-GB.json                    |  3 +++
 .../translations/en-US.json                    |  3 +++
 6 files changed, 45 insertions(+), 1 deletion(-)

diff --git a/packages/template-retail-react-app/app/components/product-item/bonus-product-quantity.jsx b/packages/template-retail-react-app/app/components/product-item/bonus-product-quantity.jsx
index 9041defb49..62727c6dbe 100644
--- a/packages/template-retail-react-app/app/components/product-item/bonus-product-quantity.jsx
+++ b/packages/template-retail-react-app/app/components/product-item/bonus-product-quantity.jsx
@@ -29,7 +29,7 @@ const BonusProductQuantity = ({product}) => {
         >
             <FormattedMessage
                 defaultMessage="Quantity: {quantity}"
-                id="product_item.label.quantity"
+                id="bonus_product_item.label.quantity"
                 values={{quantity: product?.quantity}}
             />
         </Text>
diff --git a/packages/template-retail-react-app/app/static/translations/compiled/en-GB.json b/packages/template-retail-react-app/app/static/translations/compiled/en-GB.json
index c466d06c07..6b46783504 100644
--- a/packages/template-retail-react-app/app/static/translations/compiled/en-GB.json
+++ b/packages/template-retail-react-app/app/static/translations/compiled/en-GB.json
@@ -453,6 +453,16 @@
       "value": "Password Reset"
     }
   ],
+  "bonus_product_item.label.quantity": [
+    {
+      "type": 0,
+      "value": "Quantity: "
+    },
+    {
+      "type": 1,
+      "value": "quantity"
+    }
+  ],
   "bonus_products_title.title.num_of_items": [
     {
       "type": 0,
diff --git a/packages/template-retail-react-app/app/static/translations/compiled/en-US.json b/packages/template-retail-react-app/app/static/translations/compiled/en-US.json
index c466d06c07..6b46783504 100644
--- a/packages/template-retail-react-app/app/static/translations/compiled/en-US.json
+++ b/packages/template-retail-react-app/app/static/translations/compiled/en-US.json
@@ -453,6 +453,16 @@
       "value": "Password Reset"
     }
   ],
+  "bonus_product_item.label.quantity": [
+    {
+      "type": 0,
+      "value": "Quantity: "
+    },
+    {
+      "type": 1,
+      "value": "quantity"
+    }
+  ],
   "bonus_products_title.title.num_of_items": [
     {
       "type": 0,
diff --git a/packages/template-retail-react-app/app/static/translations/compiled/en-XA.json b/packages/template-retail-react-app/app/static/translations/compiled/en-XA.json
index 9cfe49428f..35781f949b 100644
--- a/packages/template-retail-react-app/app/static/translations/compiled/en-XA.json
+++ b/packages/template-retail-react-app/app/static/translations/compiled/en-XA.json
@@ -925,6 +925,24 @@
       "value": "]"
     }
   ],
+  "bonus_product_item.label.quantity": [
+    {
+      "type": 0,
+      "value": "["
+    },
+    {
+      "type": 0,
+      "value": "Ɋŭŭȧȧƞŧīŧẏ: "
+    },
+    {
+      "type": 1,
+      "value": "quantity"
+    },
+    {
+      "type": 0,
+      "value": "]"
+    }
+  ],
   "bonus_products_title.title.num_of_items": [
     {
       "type": 0,
diff --git a/packages/template-retail-react-app/translations/en-GB.json b/packages/template-retail-react-app/translations/en-GB.json
index 199ab2624d..121b825f38 100644
--- a/packages/template-retail-react-app/translations/en-GB.json
+++ b/packages/template-retail-react-app/translations/en-GB.json
@@ -177,6 +177,9 @@
   "auth_modal.password_reset_success.title.password_reset": {
     "defaultMessage": "Password Reset"
   },
+  "bonus_product_item.label.quantity": {
+    "defaultMessage": "Quantity: {quantity}"
+  },
   "bonus_products_title.title.num_of_items": {
     "defaultMessage": "Bonus Products ({itemCount, plural, =0 {0 items} one {# item} other {# items}})"
   },
diff --git a/packages/template-retail-react-app/translations/en-US.json b/packages/template-retail-react-app/translations/en-US.json
index 199ab2624d..121b825f38 100644
--- a/packages/template-retail-react-app/translations/en-US.json
+++ b/packages/template-retail-react-app/translations/en-US.json
@@ -177,6 +177,9 @@
   "auth_modal.password_reset_success.title.password_reset": {
     "defaultMessage": "Password Reset"
   },
+  "bonus_product_item.label.quantity": {
+    "defaultMessage": "Quantity: {quantity}"
+  },
   "bonus_products_title.title.num_of_items": {
     "defaultMessage": "Bonus Products ({itemCount, plural, =0 {0 items} one {# item} other {# items}})"
   },

From 8d640d0ebfe054383e75dff0f0f4989b62a93752 Mon Sep 17 00:00:00 2001
From: daniel-diaz <daniel.diaz@salesforce.com>
Date: Tue, 1 Jul 2025 18:06:11 -0400
Subject: [PATCH 34/44] Reverted bonus product modal

---
 .../app/components/_app/index.jsx             |  55 ++++---
 .../app/components/product-view/index.jsx     |  60 +-------
 .../app/hooks/use-bonus-product-modal.js      | 140 ------------------
 .../app/hooks/use-bonus-product-modal.test.js | 118 ---------------
 .../app/pages/product-detail/index.jsx        |   8 +-
 5 files changed, 38 insertions(+), 343 deletions(-)
 delete mode 100644 packages/template-retail-react-app/app/hooks/use-bonus-product-modal.js
 delete mode 100644 packages/template-retail-react-app/app/hooks/use-bonus-product-modal.test.js

diff --git a/packages/template-retail-react-app/app/components/_app/index.jsx b/packages/template-retail-react-app/app/components/_app/index.jsx
index 4c76ed09c9..56d7f5f83f 100644
--- a/packages/template-retail-react-app/app/components/_app/index.jsx
+++ b/packages/template-retail-react-app/app/components/_app/index.jsx
@@ -33,7 +33,6 @@ import {SkipNavLink, SkipNavContent} from '@chakra-ui/skip-nav'
 
 // Contexts
 import {CurrencyProvider} from '@salesforce/retail-react-app/app/contexts'
-import {BonusProductModalProvider} from '@salesforce/retail-react-app/app/hooks/use-bonus-product-modal'
 
 // Local Project Components
 import Header from '@salesforce/retail-react-app/app/components/header'
@@ -47,7 +46,7 @@ import {DrawerMenu} from '@salesforce/retail-react-app/app/components/drawer-men
 import {ListMenu, ListMenuContent} from '@salesforce/retail-react-app/app/components/list-menu'
 import {HideOnDesktop, HideOnMobile} from '@salesforce/retail-react-app/app/components/responsive'
 import AboveHeader from '@salesforce/retail-react-app/app/components/_app/partials/above-header'
-import {StoreLocatorModal} from '@salesforce/retail-react-app/app/components/store-locator'
+import StoreLocatorModal from '@salesforce/retail-react-app/app/components/store-locator-modal'
 // Hooks
 import {AuthModal, useAuthModal} from '@salesforce/retail-react-app/app/hooks/use-auth-modal'
 import {
@@ -414,32 +413,32 @@ const App = (props) => {
                             </Box>
                             {!isOnline && <OfflineBanner />}
                             <AddToCartModalProvider>
-                                <BonusProductModalProvider>
-                                    <SkipNavContent
-                                        style={{
-                                            display: 'flex',
-                                            flexDirection: 'column',
-                                            flex: 1,
-                                            outline: 0
-                                        }}
+                                <SkipNavContent
+                                    style={{
+                                        display: 'flex',
+                                        flexDirection: 'column',
+                                        flex: 1,
+                                        outline: 0
+                                    }}
+                                >
+                                    <Box
+                                        as="main"
+                                        id="app-main"
+                                        role="main"
+                                        display="flex"
+                                        flexDirection="column"
+                                        flex="1"
                                     >
-                                        <Box
-                                            as="main"
-                                            id="app-main"
-                                            role="main"
-                                            display="flex"
-                                            flexDirection="column"
-                                            flex="1"
-                                        >
-                                            <OfflineBoundary isOnline={false}>
-                                                {children}
-                                            </OfflineBoundary>
-                                        </Box>
-                                    </SkipNavContent>
-                                    {!isCheckout ? <Footer /> : <CheckoutFooter />}
-                                    <AuthModal {...authModal} />
-                                    <DntNotification {...dntNotification} />
-                                </BonusProductModalProvider>
+                                        <OfflineBoundary isOnline={false}>
+                                            {children}
+                                        </OfflineBoundary>
+                                    </Box>
+                                </SkipNavContent>
+
+                                {!isCheckout ? <Footer /> : <CheckoutFooter />}
+
+                                <AuthModal {...authModal} />
+                                <DntNotification {...dntNotification} />
                             </AddToCartModalProvider>
                         </Box>
                     </CurrencyProvider>
@@ -470,4 +469,4 @@ App.propTypes = {
     children: PropTypes.node
 }
 
-export default App
+export default App
\ No newline at end of file
diff --git a/packages/template-retail-react-app/app/components/product-view/index.jsx b/packages/template-retail-react-app/app/components/product-view/index.jsx
index c456706bba..1144a05ab4 100644
--- a/packages/template-retail-react-app/app/components/product-view/index.jsx
+++ b/packages/template-retail-react-app/app/components/product-view/index.jsx
@@ -23,7 +23,6 @@ import {
 } from '@salesforce/retail-react-app/app/components/shared/ui'
 import {useCurrency, useDerivedProduct} from '@salesforce/retail-react-app/app/hooks'
 import {useAddToCartModalContext} from '@salesforce/retail-react-app/app/hooks/use-add-to-cart-modal'
-import {useBonusProductModalContext} from '@salesforce/retail-react-app/app/hooks/use-bonus-product-modal'
 
 // project components
 import ImageGallery from '@salesforce/retail-react-app/app/components/image-gallery'
@@ -132,13 +131,6 @@ const ProductView = forwardRef(
             onOpen: onAddToCartModalOpen,
             onClose: onAddToCartModalClose
         } = useAddToCartModalContext()
-        const {
-            isOpen: isBonusProductModalOpen,
-            onOpen: onBonusProductModalOpen,
-            onClose: onBonusProductModalClose,
-            bonusProducts,
-            addBonusProducts
-        } = useBonusProductModalContext()
         const theme = useTheme()
         const [showOptionsMessage, toggleShowOptionsMessage] = useState(false)
         const {
@@ -280,49 +272,16 @@ const ProductView = forwardRef(
                     return
                 }
                 try {
-                    const addToCartResponse = await addToCart(variant, quantity)
-
-                    // For regular products: addToCartResponse has productSelectionValues and possibly bonusDiscountLineItems
-                    // For product bundles: addToCartResponse is just the childProductSelections array
-                    const itemsAdded =
-                        addToCartResponse?.productSelectionValues || addToCartResponse
-                    const isValidResponse =
-                        itemsAdded && (Array.isArray(itemsAdded) || itemsAdded.length > 0)
-
-                    // Compare existing bonus products with new bonus discount line items
-                    // Only regular products (not bundles) can have bonusDiscountLineItems
-                    const newBonusItems =
-                        addToCartResponse?.bonusDiscountLineItems?.filter(
-                            (newItem) =>
-                                !bonusProducts.some(
-                                    (existingItem) => existingItem.id === newItem.id
-                                )
-                        ) || []
-
+                    const itemsAdded = await addToCart(variant, quantity)
                     // Open modal only when `addToCart` returns some data
                     // It's possible that the item has been added to cart, but we don't want to open the modal.
                     // See wishlist_primary_action for example.
-                    if (isValidResponse) {
-                        // Show bonus product modal first if there are bonus items
-                        if (newBonusItems?.length > 0) {
-                            // Update bonusProducts list with the new bonus items
-                            addBonusProducts(newBonusItems)
-                            onBonusProductModalOpen({
-                                newBonusItems,
-                                allBonusItems: addToCartResponse.bonusDiscountLineItems,
-                                openAddToCartModalIfNeeded: true,
-                                product,
-                                itemsAdded,
-                                selectedQuantity: quantity
-                            })
-                        } else {
-                            // If no bonus items, just show add to cart modal
-                            onAddToCartModalOpen({
-                                product,
-                                itemsAdded,
-                                selectedQuantity: quantity
-                            })
-                        }
+                    if (itemsAdded) {
+                        onAddToCartModalOpen({
+                            product,
+                            itemsAdded,
+                            selectedQuantity: quantity
+                        })
                     }
                 } catch (e) {
                     showError()
@@ -405,9 +364,6 @@ const ProductView = forwardRef(
             if (isAddToCartModalOpen) {
                 onAddToCartModalClose()
             }
-            if (isBonusProductModalOpen) {
-                onBonusProductModalClose()
-            }
         }, [location.pathname])
 
         useEffect(() => {
@@ -745,4 +701,4 @@ ProductView.propTypes = {
     selectedBundleParentQuantity: PropTypes.number
 }
 
-export default ProductView
+export default ProductView
\ No newline at end of file
diff --git a/packages/template-retail-react-app/app/hooks/use-bonus-product-modal.js b/packages/template-retail-react-app/app/hooks/use-bonus-product-modal.js
deleted file mode 100644
index 8db36534f7..0000000000
--- a/packages/template-retail-react-app/app/hooks/use-bonus-product-modal.js
+++ /dev/null
@@ -1,140 +0,0 @@
-/*
- * Copyright (c) 2025, Salesforce, Inc.
- * All rights reserved.
- * SPDX-License-Identifier: BSD-3-Clause
- * For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/BSD-3-Clause
- */
-import React, {useContext, useState, useEffect} from 'react'
-import {useLocation} from 'react-router-dom'
-import {useAddToCartModalContext} from '@salesforce/retail-react-app/app/hooks/use-add-to-cart-modal'
-import PropTypes from 'prop-types'
-import {useCurrentBasket} from '@salesforce/retail-react-app/app/hooks/use-current-basket'
-import {
-    Modal,
-    ModalCloseButton,
-    ModalContent,
-    ModalOverlay,
-    useBreakpointValue,
-    ModalHeader,
-    ModalBody,
-    Heading
-} from '@salesforce/retail-react-app/app/components/shared/ui'
-
-export const BonusProductModalContext = React.createContext()
-
-export const useBonusProductModalContext = () => useContext(BonusProductModalContext)
-
-export const BonusProductModalProvider = ({children}) => {
-    const {data: basket} = useCurrentBasket()
-    const bonusProductState = useBonusState(basket)
-
-    return (
-        <BonusProductModalContext.Provider value={bonusProductState}>
-            {children}
-            <BonusProductModal />
-        </BonusProductModalContext.Provider>
-    )
-}
-BonusProductModalProvider.propTypes = {
-    children: PropTypes.node.isRequired
-}
-
-export const BonusProductModal = () => {
-    const {isOpen, data, onClose, onOpen} = useBonusProductModalContext()
-    const size = useBreakpointValue({base: 'full', lg: '2xl', xl: '4xl'})
-
-    if (!isOpen) {
-        return null
-    }
-    return (
-        <Modal size={size} isOpen={isOpen} onClose={onClose} scrollBehavior="inside" isCentered>
-            <ModalOverlay />
-            <ModalContent
-                margin="0"
-                borderRadius={{base: 'none', md: 'base'}}
-                bgColor="gray.50"
-                containerProps={{'data-testid': 'bonus-product-modal'}}
-            >
-                <ModalHeader paddingY="8" bgColor="white">
-                    <Heading as="h1" fontSize="2xl"></Heading>
-                </ModalHeader>
-                <ModalCloseButton />
-                {/* Add your modal content here */}
-                <ModalBody bgColor="white" padding="0" marginBottom={{base: 40, lg: 0}}></ModalBody>
-            </ModalContent>
-        </Modal>
-    )
-}
-
-export const useBonusState = (basket) => {
-    const [state, setState] = useState({
-        isOpen: false,
-        data: {},
-        bonusProducts: basket?.bonusDiscountLineItems || []
-    })
-    const {pathname} = useLocation()
-    const {onOpen: onAddToCartModalOpen} = useAddToCartModalContext()
-
-    useEffect(() => {
-        if (state.isOpen) {
-            setState((prev) => ({
-                ...prev,
-                isOpen: false
-            }))
-        }
-    }, [pathname])
-
-    // Update bonusProducts when basket bonusDiscountLineItems changes
-    useEffect(() => {
-        const currentBonusItems = basket?.bonusDiscountLineItems || []
-        setState((prev) => {
-            // Only update if the bonus items have actually changed
-            if (JSON.stringify(prev.bonusProducts) !== JSON.stringify(currentBonusItems)) {
-                return {
-                    ...prev,
-                    bonusProducts: currentBonusItems
-                }
-            }
-            return prev
-        })
-    }, [basket?.bonusDiscountLineItems])
-
-    const addBonusProducts = (newBonusItems) => {
-        setState((prev) => {
-            const updatedBonusProducts = [...prev.bonusProducts, ...newBonusItems]
-            return {
-                ...prev,
-                bonusProducts: updatedBonusProducts
-            }
-        })
-    }
-
-    return {
-        isOpen: state.isOpen,
-        data: state.data,
-        bonusProducts: state.bonusProducts,
-        addBonusProducts,
-        onClose: () => {
-            setState((prev) => ({
-                ...prev,
-                isOpen: false,
-                data: {}
-            }))
-
-            if (state.data.openAddToCartModalIfNeeded && state.data.product) {
-                onAddToCartModalOpen({
-                    product: state.data.product,
-                    itemsAdded: state.data.itemsAdded,
-                    selectedQuantity: state.data.selectedQuantity
-                })
-            }
-        },
-        onOpen: (data) => {
-            setState((prev) => ({
-                ...prev,
-                isOpen: true,
-                data
-            }))
-        }
-    }
-}
diff --git a/packages/template-retail-react-app/app/hooks/use-bonus-product-modal.test.js b/packages/template-retail-react-app/app/hooks/use-bonus-product-modal.test.js
deleted file mode 100644
index d8a4008003..0000000000
--- a/packages/template-retail-react-app/app/hooks/use-bonus-product-modal.test.js
+++ /dev/null
@@ -1,118 +0,0 @@
-/*
- * Copyright (c) 2025, Salesforce, Inc.
- * All rights reserved.
- * SPDX-License-Identifier: BSD-3-Clause
- * For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/BSD-3-Clause
- */
-import React from 'react'
-import {renderHook, act} from '@testing-library/react'
-import {ChakraProvider} from '@chakra-ui/react'
-import {useLocation} from 'react-router-dom'
-import {renderWithProviders} from '@salesforce/retail-react-app/app/utils/test-utils'
-import {
-    useBonusState,
-    BonusProductModalProvider,
-    useBonusProductModalContext
-} from '@salesforce/retail-react-app/app/hooks/use-bonus-product-modal'
-
-// Mock react-router-dom's useLocation
-jest.mock('react-router-dom', () => ({
-    ...jest.requireActual('react-router-dom'),
-    useLocation: jest.fn()
-}))
-
-// Mock useAddToCartModalContext
-const mockOnAddToCartModalOpen = jest.fn()
-jest.mock('@salesforce/retail-react-app/app/hooks/use-add-to-cart-modal', () => ({
-    useAddToCartModalContext: () => ({onOpen: mockOnAddToCartModalOpen})
-}))
-
-describe('useBonusState', () => {
-    beforeEach(() => {
-        jest.clearAllMocks()
-        useLocation.mockReturnValue({pathname: '/initial'})
-    })
-
-    test('initializes with correct state from basket', () => {
-        const basket = {bonusDiscountLineItems: [{id: 'b1'}]}
-        const {result} = renderHook(() => useBonusState(basket))
-        expect(result.current.isOpen).toBe(false)
-        expect(result.current.data).toEqual({})
-        expect(result.current.bonusProducts).toEqual([{id: 'b1'}])
-    })
-
-    test('updates bonusProducts when basket changes', () => {
-        const {result, rerender} = renderHook(({basket}) => useBonusState(basket), {
-            initialProps: {basket: {bonusDiscountLineItems: [{id: 'b1'}]}}
-        })
-        rerender({basket: {bonusDiscountLineItems: [{id: 'b2'}]}})
-        expect(result.current.bonusProducts).toEqual([{id: 'b2'}])
-    })
-
-    test('addBonusProducts adds items', () => {
-        const {result} = renderHook(() => useBonusState())
-        act(() => {
-            result.current.addBonusProducts([{id: 'b3'}])
-        })
-        expect(result.current.bonusProducts).toEqual([{id: 'b3'}])
-    })
-
-    test('onOpen sets modal open and stores data', () => {
-        const {result} = renderHook(() => useBonusState())
-        act(() => {
-            result.current.onOpen({foo: 'bar'})
-        })
-        expect(result.current.isOpen).toBe(true)
-        expect(result.current.data).toEqual({foo: 'bar'})
-    })
-
-    test('onClose closes modal and clears data', () => {
-        const {result} = renderHook(() => useBonusState())
-        act(() => {
-            result.current.onOpen({foo: 'bar'})
-        })
-        act(() => {
-            result.current.onClose()
-        })
-        expect(result.current.isOpen).toBe(false)
-        expect(result.current.data).toEqual({})
-    })
-
-    test('onClose calls onAddToCartModalOpen if needed', () => {
-        const {result} = renderHook(() => useBonusState())
-        const data = {
-            openAddToCartModalIfNeeded: true,
-            product: {id: 'p1'},
-            itemsAdded: 2,
-            selectedQuantity: 1
-        }
-        act(() => {
-            result.current.onOpen(data)
-        })
-        act(() => {
-            result.current.onClose()
-        })
-        expect(mockOnAddToCartModalOpen).toHaveBeenCalledWith({
-            product: {id: 'p1'},
-            itemsAdded: 2,
-            selectedQuantity: 1
-        })
-    })
-
-    test('closes modal on location change', () => {
-        // Initial location
-        useLocation.mockReturnValue({pathname: '/foo'})
-        const {result, rerender} = renderHook(() => useBonusState())
-
-        act(() => {
-            result.current.onOpen({foo: 'bar'})
-        })
-        expect(result.current.isOpen).toBe(true)
-
-        // Change location
-        useLocation.mockReturnValue({pathname: '/bar'})
-        rerender()
-
-        expect(result.current.isOpen).toBe(false)
-    })
-})
diff --git a/packages/template-retail-react-app/app/pages/product-detail/index.jsx b/packages/template-retail-react-app/app/pages/product-detail/index.jsx
index 2f715b4f2a..7b671dc15c 100644
--- a/packages/template-retail-react-app/app/pages/product-detail/index.jsx
+++ b/packages/template-retail-react-app/app/pages/product-detail/index.jsx
@@ -302,16 +302,14 @@ const ProductDetail = () => {
                 quantity
             }))
 
-            const response = await addItemToNewOrExistingBasket(productItems)
+            await addItemToNewOrExistingBasket(productItems)
 
             einstein.sendAddToCart(productItems)
 
             // If the items were successfully added, set the return value to be used
             // by the add to cart modal.
-            return {
-                ...response,
-                productSelectionValues
-            }
+            return productSelectionValues
+            
         } catch (error) {
             console.log('error', error)
             showError(error)

From f3d883cd1a808256c3f72cea0b60e1bd2b018002 Mon Sep 17 00:00:00 2001
From: daniel-diaz <daniel.diaz@salesforce.com>
Date: Tue, 1 Jul 2025 18:14:22 -0400
Subject: [PATCH 35/44] Removed bonus product from test util

---
 packages/template-retail-react-app/app/utils/test-utils.js | 5 +----
 1 file changed, 1 insertion(+), 4 deletions(-)

diff --git a/packages/template-retail-react-app/app/utils/test-utils.js b/packages/template-retail-react-app/app/utils/test-utils.js
index 54c182447d..75720c7154 100644
--- a/packages/template-retail-react-app/app/utils/test-utils.js
+++ b/packages/template-retail-react-app/app/utils/test-utils.js
@@ -12,7 +12,6 @@ import PropTypes from 'prop-types'
 
 import theme from '@salesforce/retail-react-app/app/theme'
 import {AddToCartModalProvider} from '@salesforce/retail-react-app/app/hooks/use-add-to-cart-modal'
-import {BonusProductModalProvider} from '@salesforce/retail-react-app/app/hooks/use-bonus-product-modal'
 import {ServerContext} from '@salesforce/pwa-kit-react-sdk/ssr/universal/contexts'
 import {IntlProvider} from 'react-intl'
 import {CommerceApiProvider} from '@salesforce/commerce-sdk-react'
@@ -163,9 +162,7 @@ export const TestProviders = ({
                                 <Router>
                                     <ChakraProvider theme={theme}>
                                         <AddToCartModalProvider>
-                                            <BonusProductModalProvider>
-                                                {children}
-                                            </BonusProductModalProvider>
+                                            {children}
                                         </AddToCartModalProvider>
                                     </ChakraProvider>
                                 </Router>

From a9e65e2b2f6c64a454e8900ff42a4df4ef874bf1 Mon Sep 17 00:00:00 2001
From: daniel-diaz <daniel.diaz@salesforce.com>
Date: Tue, 1 Jul 2025 18:28:43 -0400
Subject: [PATCH 36/44] Fixed whitespace issues

---
 .../template-retail-react-app/app/components/_app/index.jsx     | 2 +-
 .../app/components/product-view/index.jsx                       | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/template-retail-react-app/app/components/_app/index.jsx b/packages/template-retail-react-app/app/components/_app/index.jsx
index d6f1a05aaa..6dfb4178ea 100644
--- a/packages/template-retail-react-app/app/components/_app/index.jsx
+++ b/packages/template-retail-react-app/app/components/_app/index.jsx
@@ -441,4 +441,4 @@ App.propTypes = {
     children: PropTypes.node
 }
 
-export default App
\ No newline at end of file
+export default App
diff --git a/packages/template-retail-react-app/app/components/product-view/index.jsx b/packages/template-retail-react-app/app/components/product-view/index.jsx
index 1144a05ab4..2da2feaa93 100644
--- a/packages/template-retail-react-app/app/components/product-view/index.jsx
+++ b/packages/template-retail-react-app/app/components/product-view/index.jsx
@@ -701,4 +701,4 @@ ProductView.propTypes = {
     selectedBundleParentQuantity: PropTypes.number
 }
 
-export default ProductView
\ No newline at end of file
+export default ProductView

From c6536e29119186d9dd2d26c2919cadae5824ef70 Mon Sep 17 00:00:00 2001
From: daniel-diaz <daniel.diaz@salesforce.com>
Date: Tue, 1 Jul 2025 18:31:05 -0400
Subject: [PATCH 37/44] Fixed change log

---
 packages/commerce-sdk-react/CHANGELOG.md | 2 --
 1 file changed, 2 deletions(-)

diff --git a/packages/commerce-sdk-react/CHANGELOG.md b/packages/commerce-sdk-react/CHANGELOG.md
index 1ee866fa67..546115ebca 100644
--- a/packages/commerce-sdk-react/CHANGELOG.md
+++ b/packages/commerce-sdk-react/CHANGELOG.md
@@ -5,8 +5,6 @@
 - Gracefully handle missing SDK Clients in CommerceApiProvider [#2539](https://github.com/SalesforceCommerceCloud/pwa-kit/pull/2539)
 - Refactor commerce-sdk-react to allow injecting ApiClients [#2519](https://github.com/SalesforceCommerceCloud/pwa-kit/pull/2519)
 
-- Refactor commerce-sdk-react to allow injecting ApiClients [#2519](https://github.com/SalesforceCommerceCloud/pwa-kit/pull/2519)
-
 ## v3.3.0 (May 22, 2025)
 
 - Fix inconsistency between dwsid and access token for guest login when hybrid authentication is enabled [#2397](https://github.com/SalesforceCommerceCloud/pwa-kit/pull/2397)

From 90be03ea28160ef58febddc0d181ece50247e3ce Mon Sep 17 00:00:00 2001
From: daniel-diaz <daniel.diaz@salesforce.com>
Date: Tue, 1 Jul 2025 18:33:35 -0400
Subject: [PATCH 38/44] Fixed more whitespace

---
 .../template-retail-react-app/app/pages/product-detail/index.jsx | 1 -
 1 file changed, 1 deletion(-)

diff --git a/packages/template-retail-react-app/app/pages/product-detail/index.jsx b/packages/template-retail-react-app/app/pages/product-detail/index.jsx
index 6eccba7419..8d3116de2f 100644
--- a/packages/template-retail-react-app/app/pages/product-detail/index.jsx
+++ b/packages/template-retail-react-app/app/pages/product-detail/index.jsx
@@ -317,7 +317,6 @@ const ProductDetail = () => {
             // If the items were successfully added, set the return value to be used
             // by the add to cart modal.
             return productSelectionValues
-            
         } catch (error) {
             console.log('error', error)
             showError(error)

From 09dac15824c08364685c6564229b5b3caed6c2cd Mon Sep 17 00:00:00 2001
From: daniel-diaz <daniel.diaz@salesforce.com>
Date: Wed, 2 Jul 2025 13:18:04 -0400
Subject: [PATCH 39/44] Added in the PR: 2562

---
 .../item-variant/item-attributes.jsx          | 16 +++-
 .../item-variant/item-attributes.test.js      | 77 +++++++++++++++++++
 .../app/components/product-item/index.jsx     |  2 +-
 .../static/translations/compiled/en-GB.json   |  6 ++
 .../static/translations/compiled/en-US.json   |  6 ++
 .../static/translations/compiled/en-XA.json   | 14 ++++
 .../translations/en-GB.json                   |  3 +
 .../translations/en-US.json                   |  3 +
 8 files changed, 124 insertions(+), 3 deletions(-)

diff --git a/packages/template-retail-react-app/app/components/item-variant/item-attributes.jsx b/packages/template-retail-react-app/app/components/item-variant/item-attributes.jsx
index 15ee4ec9c6..0dc7b897fe 100644
--- a/packages/template-retail-react-app/app/components/item-variant/item-attributes.jsx
+++ b/packages/template-retail-react-app/app/components/item-variant/item-attributes.jsx
@@ -20,13 +20,15 @@ import {getDisplayVariationValues} from '@salesforce/retail-react-app/app/utils/
  * In the context of a cart product item variant, this component renders a styled
  * list of the selected variation values as well as any promos (w/ info popover).
  */
-const ItemAttributes = ({includeQuantity, currency, ...props}) => {
+const ItemAttributes = ({includeQuantity, currency, excludeBonusLabel, ...props}) => {
     const variant = useItemVariant()
     const {data: basket} = useCurrentBasket()
     const {currency: activeCurrency} = useCurrency()
     const promotionIds = variant.priceAdjustments?.map((adj) => adj.promotionId) ?? []
     const intl = useIntl()
 
+    const displayBonusProductLabel = !excludeBonusLabel && variant?.bonusProductLineItem
+
     // Fetch all the promotions given by price adjustments. We display this info in
     // the promotion info popover when applicable.
     const {data: res} = usePromotions(
@@ -91,6 +93,15 @@ const ItemAttributes = ({includeQuantity, currency, ...props}) => {
 
     return (
         <Stack spacing={1.5} flex={1} {...props}>
+            {displayBonusProductLabel && (
+                <Text lineHeight={1} color="black.600" fontSize="sm">
+                    <FormattedMessage
+                        defaultMessage="Bonus Product"
+                        id="item_attributes.label.bonus_product"
+                    />
+                </Text>
+            )}
+
             {variationValues &&
                 Object.keys(variationValues).map((key) => (
                     <Text
@@ -210,7 +221,8 @@ const ItemAttributes = ({includeQuantity, currency, ...props}) => {
 
 ItemAttributes.propTypes = {
     includeQuantity: PropTypes.bool,
-    currency: PropTypes.string
+    currency: PropTypes.string,
+    excludeBonusLabel: PropTypes.bool
 }
 
 export default ItemAttributes
diff --git a/packages/template-retail-react-app/app/components/item-variant/item-attributes.test.js b/packages/template-retail-react-app/app/components/item-variant/item-attributes.test.js
index ec751b1d30..921495c6d8 100644
--- a/packages/template-retail-react-app/app/components/item-variant/item-attributes.test.js
+++ b/packages/template-retail-react-app/app/components/item-variant/item-attributes.test.js
@@ -73,3 +73,80 @@ test('component renders product bundles without variant data', async () => {
         })
     })
 })
+
+// Helper function to render the component with a given variant and props
+const renderComponent = (variant, props = {}) => {
+    renderWithProviders(
+        <ItemVariantProvider variant={variant}>
+            <ItemAttributes {...props} />
+        </ItemVariantProvider>
+    )
+}
+
+test('renders Bonus Product when bonusProductLineItem is true', async () => {
+    const mockVariantWithBonusProduct = {
+        ...mockBundledProductItemsVariant,
+        bonusProductLineItem: true // Simulate the bonus product flag
+    }
+
+    // Case 1: excludeBonusLabel is true
+    renderComponent(mockVariantWithBonusProduct, {excludeBonusLabel: true})
+
+    await waitFor(() => {
+        expect(screen.queryByText(/Bonus Product/i)).not.toBeInTheDocument() // Fixed assertion
+    })
+
+    // Case 3: excludeBonusLabel is false
+    renderComponent(mockVariantWithBonusProduct, {excludeBonusLabel: false})
+
+    await waitFor(() => {
+        expect(screen.getByText(/Bonus Product/i)).toBeInTheDocument()
+    })
+})
+
+test('renders Bonus Product when excludeBonusLabel is not set', async () => {
+    // Case 1: Variant has no bonus product
+    const mockVariantWithOutBonusProduct = {
+        ...mockBundledProductItemsVariant,
+        bonusProductLineItem: false // Simulate the bonus product flag
+    }
+
+    renderComponent(mockVariantWithOutBonusProduct)
+
+    await waitFor(() => {
+        expect(screen.queryByText(/Bonus Product/i)).not.toBeInTheDocument() // Fixed assertion
+    })
+
+    // Case 2: Variant has bonus product
+    const mockVariantWithBonusProduct = {
+        ...mockBundledProductItemsVariant,
+        bonusProductLineItem: true // Simulate the bonus product flag
+    }
+
+    renderComponent(mockVariantWithBonusProduct)
+
+    await waitFor(() => {
+        expect(screen.queryByText(/Bonus Product/i)).toBeInTheDocument() // Fixed assertion
+    })
+})
+
+test('does not render Bonus Product when bonusProductLineItem is false', async () => {
+    const mockVariantWithoutBonusProduct = {
+        ...mockBundledProductItemsVariant,
+        bonusProductLineItem: false // Simulate the absence of the bonus product flag
+    }
+
+    // Case 1: excludeBonusLabel is true
+    renderComponent(mockVariantWithoutBonusProduct, {excludeBonusLabel: true})
+
+    await waitFor(() => {
+        expect(screen.queryByText(/Bonus Product/i)).not.toBeInTheDocument()
+    })
+
+    // Case 2: excludeBonusLabel is false
+    renderComponent(mockVariantWithoutBonusProduct, {excludeBonusLabel: false})
+
+    await waitFor(() => {
+        expect(screen.queryByText(/Bonus Product/i)).not.toBeInTheDocument()
+    })
+})
diff --git a/packages/template-retail-react-app/app/components/product-item/index.jsx b/packages/template-retail-react-app/app/components/product-item/index.jsx
index b7c64c185e..ec92669f03 100644
--- a/packages/template-retail-react-app/app/components/product-item/index.jsx
+++ b/packages/template-retail-react-app/app/components/product-item/index.jsx
@@ -59,7 +59,7 @@ const ProductItem = ({
                         <Stack spacing={3} flex={1}>
                             <Stack spacing={1}>
                                 <CartItemVariantName />
-                                <CartItemVariantAttributes />
+                                <CartItemVariantAttributes excludeBonusLabel />
                                 <HideOnDesktop>
                                     <Box marginTop={2}>
                                         <CartItemVariantPrice
diff --git a/packages/template-retail-react-app/app/static/translations/compiled/en-GB.json b/packages/template-retail-react-app/app/static/translations/compiled/en-GB.json
index ef0237fcad..a0fb90f669 100644
--- a/packages/template-retail-react-app/app/static/translations/compiled/en-GB.json
+++ b/packages/template-retail-react-app/app/static/translations/compiled/en-GB.json
@@ -1997,6 +1997,12 @@
       "value": "Secure"
     }
   ],
+  "item_attributes.label.bonus_product": [
+    {
+      "type": 0,
+      "value": "Bonus Product"
+    }
+  ],
   "item_attributes.label.promotions": [
     {
       "type": 0,
diff --git a/packages/template-retail-react-app/app/static/translations/compiled/en-US.json b/packages/template-retail-react-app/app/static/translations/compiled/en-US.json
index ef0237fcad..a0fb90f669 100644
--- a/packages/template-retail-react-app/app/static/translations/compiled/en-US.json
+++ b/packages/template-retail-react-app/app/static/translations/compiled/en-US.json
@@ -1997,6 +1997,12 @@
       "value": "Secure"
     }
   ],
+  "item_attributes.label.bonus_product": [
+    {
+      "type": 0,
+      "value": "Bonus Product"
+    }
+  ],
   "item_attributes.label.promotions": [
     {
       "type": 0,
diff --git a/packages/template-retail-react-app/app/static/translations/compiled/en-XA.json b/packages/template-retail-react-app/app/static/translations/compiled/en-XA.json
index 19af750b82..a73351e0d0 100644
--- a/packages/template-retail-react-app/app/static/translations/compiled/en-XA.json
+++ b/packages/template-retail-react-app/app/static/translations/compiled/en-XA.json
@@ -4165,6 +4165,20 @@
       "value": "]"
     }
   ],
+  "item_attributes.label.bonus_product": [
+    {
+      "type": 0,
+      "value": "["
+    },
+    {
+      "type": 0,
+      "value": "Ɓǿǿƞŭŭş Ƥřǿǿḓŭŭƈŧ"
+    },
+    {
+      "type": 0,
+      "value": "]"
+    }
+  ],
   "item_attributes.label.promotions": [
     {
       "type": 0,
diff --git a/packages/template-retail-react-app/translations/en-GB.json b/packages/template-retail-react-app/translations/en-GB.json
index 74bfa000f0..5b1ad0ddb4 100644
--- a/packages/template-retail-react-app/translations/en-GB.json
+++ b/packages/template-retail-react-app/translations/en-GB.json
@@ -817,6 +817,9 @@
   "icons.assistive_msg.lock": {
     "defaultMessage": "Secure"
   },
+  "item_attributes.label.bonus_product": {
+    "defaultMessage": "Bonus Product"
+  },
   "item_attributes.label.promotions": {
     "defaultMessage": "Promotions"
   },
diff --git a/packages/template-retail-react-app/translations/en-US.json b/packages/template-retail-react-app/translations/en-US.json
index 74bfa000f0..5b1ad0ddb4 100644
--- a/packages/template-retail-react-app/translations/en-US.json
+++ b/packages/template-retail-react-app/translations/en-US.json
@@ -817,6 +817,9 @@
   "icons.assistive_msg.lock": {
     "defaultMessage": "Secure"
   },
+  "item_attributes.label.bonus_product": {
+    "defaultMessage": "Bonus Product"
+  },
   "item_attributes.label.promotions": {
     "defaultMessage": "Promotions"
   },

From a4f9d6f649ebb0c280ed865a46bdd4552a9e0518 Mon Sep 17 00:00:00 2001
From: daniel-diaz <daniel.diaz@salesforce.com>
Date: Wed, 2 Jul 2025 14:57:19 -0400
Subject: [PATCH 40/44] Refactored onblur and onChange to be functions

---
 .../product-item/product-quantity-picker.jsx  | 46 ++++++++++---------
 1 file changed, 25 insertions(+), 21 deletions(-)

diff --git a/packages/template-retail-react-app/app/components/product-item/product-quantity-picker.jsx b/packages/template-retail-react-app/app/components/product-item/product-quantity-picker.jsx
index 4723951b83..f597150a21 100644
--- a/packages/template-retail-react-app/app/components/product-item/product-quantity-picker.jsx
+++ b/packages/template-retail-react-app/app/components/product-item/product-quantity-picker.jsx
@@ -19,6 +19,29 @@ const ProductQuantityPicker = ({
 }) => {
     const intl = useIntl()
 
+    const handleQuantityChange = (stringValue, numberValue) => {
+        // Set the Quantity of product to value of input if value number
+        if (numberValue >= 0) {
+            // Call handler
+            onItemQuantityChange(numberValue).then(
+                (isValidChange) => isValidChange && setQuantity(numberValue)
+            )
+        } else if (stringValue === '') {
+            // We want to allow the use to clear the input to start a new input so here we set the quantity to '' so NAN is not displayed
+            // User will not be able to add '' quantity to the cart due to the add to cart button enablement rules
+            setQuantity(stringValue)
+        }
+    }
+
+    const handleQuantityBlur = (e) => {
+        // Default to last known quantity if a user leaves the box with an invalid value
+        const {value} = e.target
+
+        if (!value) {
+            setQuantity(product.quantity)
+        }
+    }
+
     return (
         <>
             <Text
@@ -43,27 +66,8 @@ const ProductQuantityPicker = ({
                 value={quantity}
                 min={0}
                 clampValueOnBlur={false}
-                onBlur={(e) => {
-                    // Default to last known quantity if a user leaves the box with an invalid value
-                    const {value} = e.target
-
-                    if (!value) {
-                        setQuantity(product.quantity)
-                    }
-                }}
-                onChange={(stringValue, numberValue) => {
-                    // Set the Quantity of product to value of input if value number
-                    if (numberValue >= 0) {
-                        // Call handler
-                        onItemQuantityChange(numberValue).then(
-                            (isValidChange) => isValidChange && setQuantity(numberValue)
-                        )
-                    } else if (stringValue === '') {
-                        // We want to allow the use to clear the input to start a new input so here we set the quantity to '' so NAN is not displayed
-                        // User will not be able to add '' quantity to the cart due to the add to cart button enablement rules
-                        setQuantity(stringValue)
-                    }
-                }}
+                onBlur={handleQuantityBlur}
+                onChange={handleQuantityChange}
                 productName={product?.name}
             />
             <VisuallyHidden role="status">

From 71f309029ff0f9a35632bb1739dbc79d918020d0 Mon Sep 17 00:00:00 2001
From: Daniel Diaz <38542490+ddiazccrz@users.noreply.github.com>
Date: Wed, 2 Jul 2025 16:29:24 -0400
Subject: [PATCH 41/44] Update
 packages/template-retail-react-app/app/pages/cart/partials/bonus-products-title.jsx

Co-authored-by: Ken Zheng <33469941+kzheng-sfdc@users.noreply.github.com>
Signed-off-by: Daniel Diaz <38542490+ddiazccrz@users.noreply.github.com>
---
 .../app/pages/cart/partials/bonus-products-title.jsx            | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/template-retail-react-app/app/pages/cart/partials/bonus-products-title.jsx b/packages/template-retail-react-app/app/pages/cart/partials/bonus-products-title.jsx
index 36d1e69c3c..02133184f9 100644
--- a/packages/template-retail-react-app/app/pages/cart/partials/bonus-products-title.jsx
+++ b/packages/template-retail-react-app/app/pages/cart/partials/bonus-products-title.jsx
@@ -12,7 +12,7 @@ import {useCurrentBasket} from '@salesforce/retail-react-app/app/hooks/use-curre
 const BonusProductsTitle = () => {
     const {data: basket} = useCurrentBasket()
     const bonusItemsCount =
-        basket?.productItems?.filter((item) => item.bonusProductLineItem).length || 0
+        basket?.productItems?.filter((item) => item.bonusProductLineItem)?.length || 0
 
     return (
         <Heading as="h2" fontSize="xl">

From 09b5ccf283d53d263208b943943551ab70725f7e Mon Sep 17 00:00:00 2001
From: Daniel Diaz <38542490+ddiazccrz@users.noreply.github.com>
Date: Thu, 3 Jul 2025 16:18:27 -0400
Subject: [PATCH 42/44] Update
 packages/template-retail-react-app/app/mocks/mock-data.js

Co-authored-by: Alex Vuong <alex.vuong@salesforce.com>
Signed-off-by: Daniel Diaz <38542490+ddiazccrz@users.noreply.github.com>
---
 packages/template-retail-react-app/app/mocks/mock-data.js | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/template-retail-react-app/app/mocks/mock-data.js b/packages/template-retail-react-app/app/mocks/mock-data.js
index 21c142e68a..bd0588bf8e 100644
--- a/packages/template-retail-react-app/app/mocks/mock-data.js
+++ b/packages/template-retail-react-app/app/mocks/mock-data.js
@@ -5712,7 +5712,7 @@ export const mockPasswordUpdateFalure = {
     errorMessage: 'Customer\u0027s current password is not valid'
 }
 
-export const mockBonusProductBasket = {
+export const mockBasketWithBonusProducts = {}
     baskets: [
         {
             ...mockCustomerBaskets.baskets[0],

From adb5603f297ef84102b7eb858325c4d1f11ae607 Mon Sep 17 00:00:00 2001
From: daniel-diaz <daniel.diaz@salesforce.com>
Date: Thu, 3 Jul 2025 19:37:53 -0400
Subject: [PATCH 43/44] Fixed unit test

---
 .../app/pages/cart/index.test.js              | 28 ++++++++++++++++++-
 1 file changed, 27 insertions(+), 1 deletion(-)

diff --git a/packages/template-retail-react-app/app/pages/cart/index.test.js b/packages/template-retail-react-app/app/pages/cart/index.test.js
index e7610b78a0..fdde82bd19 100644
--- a/packages/template-retail-react-app/app/pages/cart/index.test.js
+++ b/packages/template-retail-react-app/app/pages/cart/index.test.js
@@ -1299,7 +1299,33 @@ describe('Unavailable products tests', function () {
             {
                 path: '*/baskets/:basket/items/:itemId',
                 method: 'delete',
-                res: () => {}
+                res: () => {
+                    return {
+                        ...mockBaskets.baskets[0],
+                        productItems: [
+                            {
+                                adjustedTax: 3.05,
+                                basePrice: 12.8,
+                                bonusProductLineItem: false,
+                                gift: false,
+                                itemId: '7b1a03848f0807f99f37ea93e4',
+                                itemText: 'Worn Gold Dangle Earring',
+                                price: 64,
+                                priceAfterItemDiscount: 64,
+                                priceAfterOrderDiscount: 64,
+                                productId: '013742335262M',
+                                productName: 'Worn Gold Dangle Earring',
+                                quantity: 5,
+                                shipmentId: 'me',
+                                shippingItemId: '247699907591b6b94c9f38cf08',
+                                tax: 3.05,
+                                taxBasis: 64,
+                                taxClassId: 'standard',
+                                taxRate: 0.05
+                            }
+                        ]
+                    }
+                }
             }
         ])
         await user.click(removeBtn)

From facc6d0557d8a6fde6dcd98381a0a94bf00964a4 Mon Sep 17 00:00:00 2001
From: daniel-diaz <daniel.diaz@salesforce.com>
Date: Thu, 3 Jul 2025 20:35:07 -0400
Subject: [PATCH 44/44] Fixed lint

---
 packages/template-retail-react-app/app/mocks/mock-data.js     | 2 +-
 .../template-retail-react-app/app/pages/cart/index.test.js    | 4 ++--
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/packages/template-retail-react-app/app/mocks/mock-data.js b/packages/template-retail-react-app/app/mocks/mock-data.js
index bd0588bf8e..016419d6c4 100644
--- a/packages/template-retail-react-app/app/mocks/mock-data.js
+++ b/packages/template-retail-react-app/app/mocks/mock-data.js
@@ -5712,7 +5712,7 @@ export const mockPasswordUpdateFalure = {
     errorMessage: 'Customer\u0027s current password is not valid'
 }
 
-export const mockBasketWithBonusProducts = {}
+export const mockBasketWithBonusProducts = {
     baskets: [
         {
             ...mockCustomerBaskets.baskets[0],
diff --git a/packages/template-retail-react-app/app/pages/cart/index.test.js b/packages/template-retail-react-app/app/pages/cart/index.test.js
index fdde82bd19..dc68bef23b 100644
--- a/packages/template-retail-react-app/app/pages/cart/index.test.js
+++ b/packages/template-retail-react-app/app/pages/cart/index.test.js
@@ -15,7 +15,7 @@ import {
     mockEmptyBasket,
     mockCartVariant,
     mockedCustomerProductLists,
-    mockBonusProductBasket
+    mockBasketWithBonusProducts
 } from '@salesforce/retail-react-app/app/mocks/mock-data'
 import mockVariant from '@salesforce/retail-react-app/app/mocks/variant-750518699578M'
 import {rest} from 'msw'
@@ -1236,7 +1236,7 @@ describe('Bonus products', () => {
             {
                 path: '*/customers/:customerId/baskets',
                 method: 'get',
-                res: () => mockBonusProductBasket
+                res: () => mockBasketWithBonusProducts
             }
         ])
     })