Introducing Next.js Commerce 2.0

• App Router Ready: Using React Server Components, Server Actions, built-in layouts, metadata, and all the new patterns from the recently released App Router.

• Dynamic Storefront: A dynamic storefront at the speed of static. Customize content without sacrificing performance.

• Simplified Architecture: Next.js Commerce is now a single provider per repository, resulting in less code and fewer abstractions for your application.

Our new ecommerce accelerator template showcases the best patterns for building composable commerce applications, including support for BigCommerce, Medusa, Saleor, Shopify, and Swell.

View the demo or deploy your own version today.

Copy link to headingWhy is building an ecommerce site difficult?

When Google announced that page experience would be a ranking factor in search results and Amazon found that just 100 milliseconds of extra load time cost them 1% in sales, it put a lot of pressure on ecommerce sites to raise the bar or suffer the consequences.

However, according to the Web Almanac, ecommerce sites still struggle to achieve good performance.

Commerce sites are more complex than they seem on the surface. What is it about ecommerce that contributes to these metrics?

• They make lots of page requests. The 50th percentile of all ecommerce sites had 101 requests on the homepage on mobile. That seems like a lot, but think of all the product and sale information that appears on most home pages.

• They are asset heavy. Video and Images are the first and second most requested resource type as well as the first and second largest contributor to page weight. Once again, think of all the product and sale imagery you see on the homepage alone.

• They focus on personalization. This includes recommended products based on your shopping history and habits or location, items in your cart, user information, and more.

Many commerce platforms come with pre-built templates to help you get started quickly, but they often lack the rigor needed to scale and perform at a high level.

For example, Shopify’s store themes only require a minimum average Lighthouse performance score of 60 across the theme's product, collection, and home page, for both desktop and mobile.

Large retailers such as Under Armour, Walmart, Target, Nike, and more trust their ecommerce experience to Next.js to help them achieve better results. Let’s look at how.

Copy link to headingNext.js Commerce v1

The first version of Next.js Commerce was announced during Next.js Conf 2020 and alongside Next.js 10. Newer Next.js features at the time, like next/image with its automatic image optimization and static and dynamic rendering on a per-page basis, provided the ingredients to create a better ecommerce experience.

Paired with the industry shift from monoliths to headless ecommerce, we were able raise the bar for ecommerce sites. Next.js Commerce embodied a best-in-class, highly performant, highly optimized commerce experience including excellent web core vitals, SEO optimizations, Incremental Static Regeneration, link prefetching, and more.

This version of Next.js Commerce was as tremendous step forward, but there was still room for improvement for highly dynamic ecommerce sites.

Copy link to headingNext.js Commerce 2.0—dynamic storefronts at the speed of static

There are many dynamic elements in commerce to consider such as a user’s cart, search results, products being purchased and affecting availability, product recommendations, and more.

Even with advancements in Server-Side Rendering (SSR), Static Site Generation (SSG), and Incremental Static Regeneration (ISR), creating an ecommerce site was still a difficult task.

In order to be the most effective, we need something more granular to control the static and dynamic parts of our application. This is where Next.js and the introduction of the App Router gives you access to a deeper level of control, allowing you to create storefronts that feel static, but are completely dynamic.

Copy link to headingPerformance results

By leveraging the Next.js App Router's latest features and Vercel’s Frontend Cloud, Next.js Commerce 2.0 is able to achieve incredible performance, demonstrating dynamic at the speed of static.

When we shared an early preview, a few remarked that the performance of the site felt static. We had to clarify this is a dynamic, server-rendered storefront that performs at the level of a statically cached page. This is possible due to the new caching architecture in Next.js App Router and the Vercel Data Cache.

To compliment this new release, we also did a minor redesign to give the theme a fresh, modern look.

Let's walkthrough some Next.js features that made this possible.

Copy link to headingLayouts and pages

App Router introduces a new file name routing convention, which includes layouts and pages. This allows you to create and share site wide layouts and components, like headers and footers, but specifically for ecommerce, this allows you to create a cart that is accessible from anywhere on the site. The overall experience is much snappier. This was possible before, but is now more easier to achieve.

Copy link to headingReact Server Components, Streaming, and Suspense

React Server Components (RSCs) allow us to do as much work on the server as possible, including dynamic API calls, before returning a fully rendered UI. This means a leaner client-side JavaScript bundle size and fewer client-side requests. This also means no layout shift, no loading spinners, and a faster time to interactive.

Paired with Streaming with Suspense, we can prioritize and return portions of the UI as they are ready instead of waiting for the entire page to be ready. This gives users content faster. Your site is no longer as slow as your slowest backend. Portions of the site below the fold can be streamed in later, while users see more immediate content above the fold.

• The layout, page, header, and search sort filters are all rendered on the server available on initial page load.

• The cart, search categories, products, and footer use Suspense independently load when each piece ready.

Copy link to headingData fetching and caching

The biggest mental model shift in the App Router is to stop thinking which pages should be static or dynamic and starting thinking about what data is static or dynamic. Moving the static and dynamic decisions to data fetching gives you more control over when and where to serve static or dynamic content.

Using the new data fetching and caching paradigms, revalidation (also known as Incremental Static Regeneration) moves to individual fetching too.

We're using Shopify's Storefront API, which utilizes GraphQL. GraphQL expects that all requests are POST requests. We mimic Next.js built-in functionality of caching all calls by default, except for mutations.

1
const domain = `https://${process.env.SHOPIFY_STORE_DOMAIN!}`;
2
const endpoint = `${domain}${SHOPIFY_GRAPHQL_API_ENDPOINT}`;
3
const key = process.env.SHOPIFY_STOREFRONT_ACCESS_TOKEN!;
4
export async function shopifyFetch({
5
  cache = 'force-cache',
6
  headers,
7
  query,
8
  tags,
9
  variables
10
}) {
11
  const result = await fetch(endpoint, {
12
    method: 'POST',
13
    headers: {
14
      'Content-Type': 'application/json',
15
      'X-Shopify-Storefront-Access-Token': key,
16
      ...headers
17
    },
18
    body: JSON.stringify({
19
      ...(query && { query }),
20
      ...(variables && { variables })
21
    }),
22
    cache,
23
    ...(tags && { next: { tags } })
24
  });
25
  const body = await result.json();
26
  if (body.errors) {
27
    throw body.errors[0];
28
  }
29
  return {
30
    status: result.status,
31
    body
32
  };
33
}

Since all data is cached by default, we need a way to trigger revalidation of data when needed. Let's use products as an example.

When we update a product description, inventory, etc. in Shopify, we want the site to reflect that change. We also don't want the site make unnecessary calls for this data if it's not changing. So we can cache by default, but add a revalidation tag.

1
import { getProductQuery } from './queries/product';
2
const res = await shopifyFetch({
3
  query: getProductQuery,
4
  tags: ['products'],
5
  variables: {
6
    handle: 'acme-t-shirt'
7
  }
8
});

Now we can subscribe to Shopify webhooks to be notified when product data changes and we can revalidate the product data using revalidateTag.

1
import { revalidateTag } from 'next/cache';
2
import { NextRequest, NextResponse } from 'next/server';
3
export async function POST(req) {
4
  const productWebhooks = ['products/create', 'products/delete', 'products/update'];
5
  const topic = headers().get('x-shopify-topic') || 'unknown';
6
  const isProductUpdate = productWebhooks.includes(topic);
7
  if (!isProductUpdate) {
8
    // We don't need to revalidate anything for any other topics.
9
    return NextResponse.json({ status: 200 });
10
  }
11
  if (isProductUpdate) {
12
    revalidateTag('products');
13
  }
14
  return NextResponse.json({ status: 200, revalidated: true, now: Date.now() });
15
}

Copy link to headingServer Actions

With Server Actions, we can colocate server-side data mutations with the UI that is invoking them, eliminating the need to create API routes used only by your application and reducing client-side JavaScript making the bundle size smaller.

1
'use client';
2
import { addItem } from 'components/cart/actions';
3
import { useRouter } from 'next/navigation';
4
import { useTransition } from 'react';
5
export function AddToCart({selectedVariantId}) {
6
  const router = useRouter();
7
  const [isPending, startTransition] = useTransition();
8
  return (
9
    <button
10
      aria-label="Add item to cart"
11
      disabled={isPending}
12
      onClick={() => {
13
        startTransition(async () => {
14
          const error = await addItem(selectedVariantId);
15
          if (error) {
16
            alert(error);
17
            return;
18
          }
19
          router.refresh();
20
        });
21
      }}
22
    >
23
      'Add To Cart'
24
    </button>
25
  );
26
}

1
'use server';
2
import { addToCart, createCart, getCart } from 'lib/shopify';
3
import { cookies } from 'next/headers';
4
export const addItem = async (variantId) => {
5
  let cartId = cookies().get('cartId')?.value;
6
  let cart;
7
  if (cartId) {
8
    cart = await getCart(cartId);
9
  }
10
  if (!cartId || !cart) {
11
    cart = await createCart();
12
    cartId = cart.id;
13
    cookies().set('cartId', cartId);
14
  }
15
  if (!variantId) {
16
    return new Error('Missing variantId');
17
  }
18
  try {
19
    await addToCart(cartId, [{ merchandiseId: variantId, quantity: 1 }]);
20
  } catch (e) {
21
    return new Error('Error adding item', { cause: e });
22
  }
23
};

Copy link to headingRepository strategy

The previous architecture of Next.js Commerce v1 was a multi-vendor, interoperable solution, including integrations with ten e-commerce providers. For v2, we removed roughly 145,000 lines of code making the project more straightforward, maintainable, and easier to understand while also highlighting the latest features of the Next.js App Router.

Providers are able to fork the Next.js Commerce repository add support for their platform. We’re delighted that our partners BigCommerce, Medusa, Saleor, and Swell have embraced this new vision and already have templates and demos using Next.js Commerce 2.0 ready to go. If you want to add support for your platform, follow the instructions and open a pull request to add yours to the list.

To get started with your own ecommerce store, you can deploy your own version of Next.js Commerce 2.0 + Shopify by visiting the template page and using our one click to deploy button.