spree /spree

Open Source Platform for DTC, B2B Commerce, Marketplaces & Omnichannel. REST APIs, TypeScript SDKs, and production-ready Next.js storefront. Self-host it. Own your data. No vendor lock-in. Zero platform fees.

★ 15,842⑂ 5,319👁 78⑃ 10,690● 4,410▤ 274
RubyBSD-3-ClauseCreated 2008-03-10spreecommerce.org
Download: v6.0.4v6.0.4 ↓6.0.42026-11-12
+4
Daily
+21
Weekly
15,842
stars
5,319
forks
78
watchers
10,690
prs
4,410
issues
274
releases

README

Website
·
Next.js Storefront
·
Documentation
·
Free Sandbox
·
API
·
Roadmap
·
Discord





Build commerce the way you want it. Spree is an open-source headless commerce platform with complete REST APIs, TypeScript SDKs, an MCP server, a React admin dashboard, and a production-ready Next.js storefront. BSD 3-Clause licensed — keep full ownership of your code, data, and infrastructure.

Teams use Spree to build multi-vendor marketplaces and B2B and wholesale channels, as well as headless DTC, cross-border and omnichannel selling — all from one set of commerce primitives, and all alongside the ERP, PIM, and payment systems you already run.

Use AI agents to build your ecommerce business. Spree ships with a collection of agent skills for coding agents and an MCP server that lets you manage your store via chat.

 Use Cases

Spree ships commerce primitives, so the same core serves very different businesses.

 Multi-vendor Marketplace

Seller onboarding with configurable requirement checklists, orders split per seller at completion, a flexible commission engine, a payout ledger with Stripe Connect, and a dedicated Seller Panel. All in the open-source core.



 B2B & Wholesale

Price lists with volume tiers, customer groups, companies with locations, contacts and tax exemptions, catalogs for per-segment assortments, and storefronts gated to approved buyers.



 Headless & Omnichannel

Run web storefronts, mobile apps, points of sale, B2B panels and marketplaces off one backend. Channels give each surface its own catalog, pricing, payment methods and order attribution.

The Next.js storefront is one such surface — production-ready, open source, built with Next.js 16, React 19 and TypeScript. Fork it, customize it, deploy it. Try the live demo


  
    
    
    
  


 Cross-border Commerce

Markets bundle currency, language, payment methods and shipping per region, so each customer sees a localized storefront from a single platform. Translations for product content, EU Omnibus price history and customs duties are built in.



 Multi-tenant SaaS Enterprise

Run a SaaS platform where each tenant gets its own isolated store — catalog, orders, customers, payment methods and branding — with staff able to manage several tenants. Requires the Enterprise Edition.

 Getting Started

 Try it in a sandbox

The fastest way to see Spree is a free sandbox: a hosted store with the admin dashboard and APIs, ready in your browser. Nothing to install — sign in, click Create store, and explore.

 Install locally

Copy and paste the following command to your terminal to set up Spree locally in 5 minutes:

bash
npx create-spree-app@latest my-store


This sets up the Spree backend, the React Admin Dashboard, and optionally the Next.js storefront in a monorepo. The storefront is built with Next.js 16, React 19, Tailwind CSS 4, and TypeScript. Admin dashboard uses Vite and TanStack.

You need Node.js 24+, Git and Docker running. The backend runs as a Docker image, and you can co

Top issues

Discussions

Latest release

v6.0.4 v6.0.4 2026-11-12
Spree 6.0.4

Spree 6.0.4 is a patch release with a refreshed admin dashboard and seller panel, a richer seller page for marketplace operators, and built-in diagnostics for bug reports. It also fixes a set of checkout completion races, draft order totals, and email lookups in apps that encrypt emails.

bash
npx spree upgrade


---

 ✨ New features

- Diagnostics and Send feedback. Settings → System info shows an anonymised report of versions, runtime, infrastructure, changed settings and recent errors, and Send feedback in the account menu opens a bug report with it attached. Developers get Vie

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON