Documentation

Code splitting

As you continue to develop your application, the JavaScript bundle size will keep increasing over time, becoming one of the critical bottlenecks for performance and SEO. To solve this issue, Next.js allows developers to dynamic import components hence splitting the application bundle into smaller chunks and lazy load on demand.

In this article, you'll learn how to improve site performance with code splitting using dynamic imports.

Component based code splitting

The easiest way to do code splitting in commercetools Frontend is the per-component basis, where you lazy load components that aren't required on the initial page load. For example, the <Cart /> component is only needed for the cart page and can be lazy-loaded. You can lazy-load tastics while registering them in the frontend/frontastic/tastics/index.tsx as shown below

// ... imports for other tastics
import dynamic from 'next/dynamic';


const Cart = dynamic(() => import('./cart'), {
  loading: () => <h1>Loading cart...</h1>,
});


export const tastics = {
  'commercetools/ui/cart': Cart,
  // ... more tastics
};

The loading component appears as a fallback while the browser waits for the JavaScript bundle for the <Cart/>. In this example, the text Loading cart... appears while the request for the JavaScript bundle is pending.

f87bed5 loading cart

But as soon as the JavaScript is loaded the loading message is replaced with the <Cart /> component as shown below.

942b425 cart loaded

Another way to do code splitting is to lazy load parts of your React component, as shown below.

import React from 'react';
import { useCart } from 'frontastic/provider';
import Head from 'next/head';
import { useFormat } from 'helpers/hooks/useFormat';


import dynamic from 'next/dynamic';


const Cart = dynamic(() => import('components/commercetools-ui/cart'), {
  loading: () => <h1>Loading cart...</h1>,
});


const CartTastic = ({ data }) => {
  const { formatMessage } = useFormat({ name: 'cart' });
  const { data: cartList, removeItem, updateItem, shippingMethods } = useCart();
  const editItemQuantity = (lineItemId: string, newQuantity: number) =>
    updateItem(lineItemId, newQuantity);


  return (
    <>
      <Head>
        <title>
          {formatMessage({ id: 'checkout', defaultMessage: 'checkout' })}
        </title>
        <meta
          name="description"
          content={formatMessage({
            id: 'checkout',
            defaultMessage: 'checkout',
          })}
        />
      </Head>
      <Cart
        cart={cartList}
        removeItem={removeItem}
        editItemQuantity={editItemQuantity}
        shippingMethods={shippingMethods?.data}
        pageTitle={data.pageTitle}
        emptyStateImage={data.emptyStateImage}
        emptyStateTitle={data.emptyStateTitle}
        emptyStateSubtitle={data.emptyStateSubtitle}
        emptyStateCTALabel={data.emptyStateCTALabel}
        emptyStateCTALink={data.emptyStateCTALink}
      />
    </>
  );
};


export default CartTastic;