Production-ready Medusa DTC Starter

Production-ready Medusa DTC Starter

by Gorgo

Documentation | Live demo | Website

A production-ready Medusa starter for direct-to-consumer commerce: a Medusa backend and a Next.js storefront with a conversion-focused checkout, 36 languages, 241 countries, transactional emails, SEO with an llms.txt endpoint, and integrations you configure straight from the Medusa Admin.

Features

All the features of the official Medusa DTC Starter, plus:

• Conversion-focused checkout: Checkout steps are built as modals that streamline the purchase flow, with the cart totals and the promotion code in view the whole time. The design borrows from the Yandex KIT checkout, Yandex's platform for launching online stores. You can remove or add any field.

• Address autocomplete: The address field suggests options as you type, and picking a suggestion fills in the postal code, city, and region automatically. At any point the buyer can check "Enter address manually" and fill in the fields themselves. Use the built-in DaData service or connect your own, as described in Set Up Address Autocomplete.

• Full i18n support: 36 languages with RTL support and 241 countries by default. Add your own regions or remove the ones you don't need directly in the seed script's data files. For their format and currencies, see Customize Seed Data.

• Catalog search: Fast, convenient search across products and categories, backed by the Store API. You can plug in your own search engine, for example Meilisearch.

• Filterable catalog: Filters by product options, sorting by newest and price, and a sidebar with categories and subcategories. On mobile, filters open in a sheet from the bottom. Selected filters stay in the page's URL, so a curated selection can be shared as a link. The design borrows from the catalog of fashion brand 12 STOREEZ.

• Transactional emails: A custom SMTP notification provider sends emails from React Email templates using the nodemailer package. Seven subscribers react to the customer.created, auth.password_reset, order.placed, order.completed, order.fulfillment_created, order.transfer_requested, and payment.captured events. See the email templates on GitHub.

• On-demand cache revalidation: Whenever a product, category, collection, or translation changes, a backend subscriber posts a webhook to the storefront, and the storefront revalidates exactly the pages that are affected. See the subscriber's code on GitHub.

• Integration Module: Store administrators configure payment, shipping, and other providers directly in the Medusa Admin application, with no editing of configuration files and no redeploying the store. Sensitive values are encrypted, and settings are validated before they take effect.

• SEO and AI optimization: sitemap.xml, robots.txt, and hreflang alternates are generated automatically, Open Graph and Twitter Card meta tags are set for every page, and there's an llms.txt endpoint for AI crawlers.

Getting Started

One command scaffolds the project, runs the migrations, creates an admin user, and seeds regions, locales, and a demo catalog:

npx create-medusa-app@latest --repo-url https://github.com/gorgojs/medusa-dtc-starter

Then start the backend, copy the publishable API key from Settings → Publishable API Keys in the Admin into the storefront's .env.local, and start the storefront on http://localhost:8000. For the manual install and the troubleshooting notes, read Getting Started with Medusa DTC Starter.

Support and Community

Have questions about the starter? Join the Telegram support chat: @gorgojs_chat

Connect with other Medusa developers on Telegram: @medusajs_chat