README

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





Build commerce the way you want it. Spree is an open-source commerce platform with a complete REST API, TypeScript SDKs, 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 a local MCP server that allows your to 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+ installed and Docker running. Learn more in the installation docs.

 Agentic Developmen

Top issues

Discussions

Latest release

Spree 6.0.3

A patch release for Spree 6.0. PayPal is back as an official payment provider that ships with Spree, AI agents connected to your store can now run every back-office action the Admin API offers, product lists show stock totals, and saving a product no longer drops categories or tags added elsewhere.

bash
npx spree upgrade


---

 ✨ New features

- PayPal for Spree 6. The spree_paypal_checkout gem now ships with Spree at the same version. It offers PayPal, Pay Later, Venmo and guest card payments in PayPal's window, honors your capture setting, and registers its own webhooks, so yo