Medusa V2 Starter

Stack

• Medusa V2
• Next.js
• Tailwind CSS
• Docker and Docker Compose
• Turborepo

Features

• Sleek, Modern Design: The storefront boasts a minimalist, contemporary design that perfectly reflects Sofa Society's commitment to modern aesthetics and sustainability.
• Customizable Collections: Easily customize the content and images for each collection. Each product page also features images and a CTA for the collection it belongs to, which can be personalized as well, creating a fully branded shopping experience.
• Premade Inspiration Page: A beautiful, ready-to-use inspiration page helps customers explore the latest trends and styles, showcasing Sofa Society's furniture in real-world settings.
• About Page: Share your brand’s story, values, and commitment to sustainability with a pre-built about page that captures the essence of Sofa Society.
• Streamlined Checkout Flow: The checkout process is designed to be fast, intuitive, and frictionless, providing a seamless shopping experience for your customers from start to finish.
• Fully Responsive Design: Optimized for mobile, tablet, and desktop devices, ensuring a smooth, consistent experience across all platforms.
• Stripe Integration for Payments: Accept payments effortlessly by integrating Stripe. Simply add your Stripe API key to medusa/.env and the publishable key to storefront/.env to get started.
• Full E-commerce Functionality: The starter includes all the essential e-commerce features you need, including product pages, a shopping cart, a checkout process, and order confirmation.
• Next.js and Tailwind CSS: Built with Next.js v15 app router and Tailwind CSS, the starter is highly performant, customizable, and easy to extend with additional features.

Development

Setup

pnpm i
docker-compose up -d

Medusa

cd apps/medusa
cp .env.template .env
pnpm --filter medusa run build
medusa db:migrate
pnpm --filter medusa run seed
medusa user -e "admin@medusa.local" -p "supersecret"
pnpm --filter medusa run dev

At this point, you should be able to access the Medusa admin at http://localhost:9000/app with the credentials you just created. After logging in, you should go to http://localhost:9000/app/settings/publishable-api-keys, copy the publishable key, and paste it into the NEXT_PUBLIC_MEDUSA_PUBLISHABLE_KEY env variable in the storefront/.env.local file.

Storefront

cd storefront
cp .env.template .env.local
pnpm --filter storefront run build

You should now be able to access the storefront at http://localhost:8000.

Run both apps at once

pnpm run dev