Prerequisites

To use the Next.js Starter Template, you should have a Medusa server running locally on port 9000. For a quick setup, run:

1
npx create-medusa-app@latest

Check out create-medusa-app docs for more details and troubleshooting.

Overview

The Medusa Next.js Starter is built with:

• Next.js
• Tailwind CSS
• Typescript
• Medusa

Features include:

• Full ecommerce support:
  • Product Detail Page
  • Product Overview Page
  • Product Collections
  • Cart
  • Checkout with Stripe
  • User Accounts
  • Order Details
• Full Next.js 15 support:
  • App Router
  • Next fetching/caching
  • Server Components
  • Server Actions
  • Streaming
  • Static Pre-Rendering

Quickstart

Setting up the environment variables

Navigate into your projects directory and get your environment variables ready:

1
cd nextjs-starter-medusa/
2
mv .env.template .env.local

Install dependencies

Use Yarn to install all dependencies.

1
yarn

Start developing

You are now ready to start up your project.

1
yarn dev

Open the code and start customizing

Your site is now running at http://localhost:8000!

Payment integrations

By default this starter supports the following payment integrations

• Stripe

To enable the integrations you need to add the following to your .env.local file:

1
NEXT_PUBLIC_STRIPE_KEY=<your-stripe-public-key>

You'll also need to setup the integrations in your Medusa server. See the Medusa documentation for more information on how to configure Stripe.

Resources

Learn more about Medusa

• Website
• GitHub
• Documentation

Learn more about Next.js

• Website
• GitHub
• Documentation