Go to file
2026-10-27 15:09:07 +07:00
.yarn/releases Initial Source code 2026-10-27 15:09:07 +07:00
mock-backend Initial Source code 2026-10-27 15:09:07 +07:00
public Initial Source code 2026-10-27 15:09:07 +07:00
src Initial Source code 2026-10-27 15:09:07 +07:00
.dockerignore Initial Source code 2026-10-27 15:09:07 +07:00
.env.template Initial Source code 2026-10-27 15:09:07 +07:00
.eslintrc.js Initial Source code 2026-10-27 15:09:07 +07:00
.gitignore Initial Source code 2026-10-27 15:09:07 +07:00
.prettierrc Initial Source code 2026-10-27 15:09:07 +07:00
.yarnrc.yml Initial Source code 2026-10-27 15:09:07 +07:00
check-env-variables.js Initial Source code 2026-10-27 15:09:07 +07:00
Dockerfile Initial Source code 2026-10-27 15:09:07 +07:00
LICENSE Initial Source code 2026-10-27 15:09:07 +07:00
next-env.d.ts Initial Source code 2026-10-27 15:09:07 +07:00
next.config.js Initial Source code 2026-10-27 15:09:07 +07:00
package-lock.json Initial Source code 2026-10-27 15:09:07 +07:00
package.json Initial Source code 2026-10-27 15:09:07 +07:00
postcss.config.js Initial Source code 2026-10-27 15:09:07 +07:00
README.md Initial Source code 2026-10-27 15:09:07 +07:00
RUNNING.md Initial Source code 2026-10-27 15:09:07 +07:00
tailwind.config.js Initial Source code 2026-10-27 15:09:07 +07:00
tsconfig.json Initial Source code 2026-10-27 15:09:07 +07:00
vitest.config.ts Initial Source code 2026-10-27 15:09:07 +07:00
vitest.setup.ts Initial Source code 2026-10-27 15:09:07 +07:00
yarn.lock Initial Source code 2026-10-27 15:09:07 +07:00

⚠️ This repository is now deprecated. Use the dtc-starter instead.

Medusa logo

Medusa Next.js Starter Template

Combine Medusa's modules for your commerce backend with the newest Next.js 15 features for a performant storefront.

PRs welcome! Discord Chat Follow @medusajs

Prerequisites

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

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:

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:

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

Install dependencies

Use Yarn to install all dependencies.

yarn

Start developing

You are now ready to start up your project.

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

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

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

Learn more about Next.js