---
title: "Medusa Next.js Ecommerce Store Starter"
description: "Ecommerce store template built with Next.js App Router, Medusa and TailwindCSS, with features like Algolia search and Stripe checkout."
url: "https://vercel.com/templates/next.js/medusa"
links:
  repository: "https://github.com/medusajs/nextjs-starter-medusa"
  demo: "https://next.medusajs.com/"
  deploy: "https://vercel.com/new/clone?demo-title=Medusa+Next.js+Ecommerce+Store+Starter&demo-description=Ecommerce+store+template+built+with+Next.js+App+Router%2C+Medusa+and+TailwindCSS%2C+with+features+like+Algolia+search+and+Stripe+checkout.&demo-url=https%3A%2F%2Fnext.medusajs.com%2F&demo-image=%2F%2Fimages.ctfassets.net%2Fe5382hct74si%2F39PbY6DZEVzjNsb2h1LNAx%2F2e9e1e53b377e8d1c27c8720ddd5d2aa%2FCleanShot_2023-05-17_at_20.05.49_2x_-_Oliver_Juhl.png&project-name=Medusa+Next.js+Ecommerce+Store+Starter&repository-name=medusa&repository-url=https%3A%2F%2Fgithub.com%2Fmedusajs%2Fnextjs-starter-medusa&from=templates&skippable-integrations=1&env=NEXT_PUBLIC_MEDUSA_BACKEND_URL%2CNEXT_PUBLIC_BASE_URL%2CPRODUCT_POSTGRES_URL%2CNEXT_PUBLIC_STRIPE_KEY%2CNEXT_PUBLIC_PAYPAL_CLIENT_ID%2CNEXT_PUBLIC_SEARCH_APP_ID%2CNEXT_PUBLIC_SEARCH_ENDPOINT%2CNEXT_PUBLIC_SEARCH_API_KEY%2CNEXT_PUBLIC_SEARCH_INDEX_NAME&envDescription=Instructions+on+how+to+get+these+env+vars%3A&envLink=https%3A%2F%2Fgithub.com%2Fmedusajs%2Fnextjs-starter-medusa%2Fblob%2Fmain%2F.env.template"
---

# Medusa Next.js Ecommerce Store Starter

Ecommerce store template built with Next.js App Router, Medusa and TailwindCSS, with features like Algolia search and Stripe checkout.

> ⚠️ This repository is now deprecated. Use the [dtc-starter](https://github.com/medusajs/dtc-starter) instead.

<p align="center">
  <a href="https://www.medusajs.com">
  <picture>
    <source media="(prefers-color-scheme: dark)" srcset="https://user-images.githubusercontent.com/59018053/229103275-b5e482bb-4601-46e6-8142-244f531cebdb.svg">
    <source media="(prefers-color-scheme: light)" srcset="https://user-images.githubusercontent.com/59018053/229103726-e5b529a3-9b3f-4970-8a1f-c6af37f087bf.svg">
    <img alt="Medusa logo" src="https://user-images.githubusercontent.com/59018053/229103726-e5b529a3-9b3f-4970-8a1f-c6af37f087bf.svg">
    </picture>
  </a>
</p>

<h1 align="center">
  Medusa Next.js Starter Template
</h1>

<p align="center">
Combine Medusa's modules for your commerce backend with the newest Next.js 15 features for a performant storefront.</p>

<p align="center">
  <a href="https://github.com/medusajs/medusa/blob/master/CONTRIBUTING.md">
    <img src="https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=flat" alt="PRs welcome!" />
  </a>
  <a href="https://discord.gg/xpCwq3Kfn8">
    <img src="https://img.shields.io/badge/chat-on%20discord-7289DA.svg" alt="Discord Chat" />
  </a>
  <a href="https://twitter.com/intent/follow?screen_name=medusajs">
    <img src="https://img.shields.io/twitter/follow/medusajs.svg?label=Follow%20@medusajs" alt="Follow @medusajs" />
  </a>
</p>

### Prerequisites

To use the [Next.js Starter Template](https://medusajs.com/nextjs-commerce/), you should have a Medusa server running locally on port 9000.
For a quick setup, run:

```shell
npx create-medusa-app@latest
```

Check out [create-medusa-app docs](https://docs.medusajs.com/learn/installation) for more details and troubleshooting.

# Overview

The Medusa Next.js Starter is built with:

- [Next.js](https://nextjs.org/)
- [Tailwind CSS](https://tailwindcss.com/)
- [Typescript](https://www.typescriptlang.org/)
- [Medusa](https://medusajs.com/)

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:

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

### Install dependencies

Use Yarn to install all dependencies.

```shell
yarn
```

### Start developing

You are now ready to start up your project.

```shell
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](https://stripe.com/)

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

```shell
NEXT_PUBLIC_STRIPE_KEY=<your-stripe-public-key>
```

You'll also need to setup the integrations in your Medusa server. See the [Medusa documentation](https://docs.medusajs.com) for more information on how to configure [Stripe](https://docs.medusajs.com/resources/commerce-modules/payment/payment-provider/stripe#main).

# Resources

## Learn more about Medusa

- [Website](https://www.medusajs.com/)
- [GitHub](https://github.com/medusajs)
- [Documentation](https://docs.medusajs.com/)

## Learn more about Next.js

- [Website](https://nextjs.org/)
- [GitHub](https://github.com/vercel/next.js)
- [Documentation](https://nextjs.org/docs)

## Related Templates

### [Next.js Commerce](https://vercel.com/templates/next.js/nextjs-commerce)

Starter kit for high-performance commerce with Shopify.

### [Builder.io Shopify Commerce](https://vercel.com/templates/next.js/builderio-shopify-commerce-headless)

Builder.io starter for Headless Shopify stores.

### [Next.js + Salesforce Commerce Cloud](https://vercel.com/templates/next.js/next-js-salesforce-commerce-cloud)

Starter kit for high-performance commerce with Salesforce Commerce Cloud and Next.js.

---

## Additional documentation

The [Vercel Knowledge Base](https://vercel.com/kb) contains guides and answers to common questions about Vercel, including deployment, framework configuration, domains, caching, and troubleshooting.