5.1. Next.js Starter

In this chapter, you’ll learn how to install and use the Next.js Starter storefront.

Install Next.js Starter#

1. Clone the v2 branch of the Next.js Starter:

Terminal
❯git clone https://github.com/medusajs/nextjs-starter-medusa my-medusa-storefront

2. Change to the my-medusa-storefront directory, install the dependencies, and rename the template environment variable:

npm
yarn
pnpm

3. While the Medusa application is running, start the Next.js storefront:

npm
yarn
pnpm

Your Next.js Starter Storefront is now running at localhost:8000.

Customize Storefront#

To customize the storefront, refer to the following directories:

• src/app: The storefront’s pages.
• src/modules: The storefront’s components.
• src/styles: The storefront’s styles.

Configurations and Integrations#

The Next.js Starter is compatible with some Medusa integrations out-of-the-box, such as the Stripe provider module. You can also change some of its configurations if necessary.

Refer to the Next.js Starter reference for more details.