Skip to content
Lumen Starter

About Lumen

Lumen is an open-source Next.js storefront starter for Medusa. It's designed to be the fastest way to launch a production-grade storefront on top of a Medusa v2 backend — every native Medusa feature is wired end-to-end, the design is yours to brand, and the payment layer plugs into whichever provider your store uses.

This site is a live demo: catalog, cart, checkout, customer accounts, orders, addresses, returns — all real flows against a real Medusa Cloud backend. Browse around, place a test order, see how it feels.

Why Lumen

Most Medusa storefront starters today are tied to a single deploy target and a single payment provider. Lumen makes both portable.

  • Deploys natively to Medusa Cloud or Vercel. Same code, same env vars — no platform-specific dependencies in critical paths.
  • Gateway-agnostic payments. Stripe Elements and PayPal Smart Buttons ship in the box. Adding a new payment provider is a single file.
  • All native Medusa features. Products, variants, categories, collections, multi-region pricing, promotion codes, gift cards, customer auth, address book, order history, and customer-initiated returns.
  • Designed, not generated. Built on Next.js 16, Tailwind v4, and shadcn/ui by a design agency that ships ecommerce for a living.
  • Production-grade defaults. Region routing, SEO metadata, structured data, sitemap, accessibility, security headers, i18n — wired in.

What's in the box

  • Catalog: products, variants, options, categories, collections, brands, search
  • Multi-region routing under /[countryCode]/... with region-driven pricing
  • Cart: line items, promotion codes, gift cards, server-computed totals
  • Checkout: address → shipping option → payment session → order complete
  • Payment providers: Stripe Elements, PayPal Smart Buttons, manual system_default, generic fallback
  • Customer auth: register / login / logout / forgot password / reset password
  • Account: orders, order detail, addresses (CRUD + default), profile, returns
  • Pluggable repository layer (swap data sources without touching pages)
  • shadcn/ui components, Tailwind v4, Next.js 16 App Router
  • SEO + structured data, sitemap, robots.txt, security headers, i18n (EN/ES)

Get Lumen

Lumen is MIT-licensed. Clone the repo, point it at your Medusa backend, deploy.

github.com/Epic-Design-Labs/medusa-nextjs-lumen

Built by Epic Design Labs

Lumen is designed and maintained by Epic Design Labs, a design and development studio that builds high-performing ecommerce experiences. If you need help launching on Medusa, customizing Lumen, or building a private fork with deeper integrations, get in touch.