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
+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 coTop issues
#9231Taxes not including promotions with whole-order adjustments20 comments · 2019-02-04#7890Move cost_price at stock level (feature/suggestion/issue)9 comments · 2017-03-26#10160How to customize propduct properties??6 comments · 2020-05-13#13966Rules for multi-country promotions are impossible to create5 comments · 2026-04-30#6460Create Line Item promotion not removing line item when original item is removed from the cart5 comments · 2015-06-03#14614VIES VAT Registry Validation3 comments · 2026-09-10#10874Taxes rounding produces small amount deviation in order's tax total.3 comments · 2021-03-15#14611Order Change Substrate2 comments · 2026-09-10
Discussions
#15167Do merchants ask for their own layout of order and product screens in the new admin?0 comments · 2026-11-11#14990Spree 6.00 comments · 2026-10-27#13970Is it possible to integrate the store's front-end into a Docker Compose file?1 comments · 2026-04-30#13806When will Spree V5.4 be released?1 comments · 2026-03-20#13497Spree 5.3 with new Pricing engine, Customer Groups and Events & Subscribers workflows0 comments · 2026-01-26#13318Spree 5.2 with New Features and Developer tools0 comments · 2025-11-28#13166Extending Admin UI1 comments · 2025-10-04#12948How to delete the tag itself1 comments · 2025-07-15
Latest release
v6.0.4 v6.0.4 2026-11-12Spree 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