spree / spree

Website
·
Next.js Storefront
·
Documentation
·
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
Copy and paste the following command to your terminal to set up Spree locally in 5 minutes:
 [code] 
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 Development
Spree comes with agent skills, which teach Claude Code, Codex, Cursor, Copilot and 60+ other tools Spree's conventions, customization patterns and upgrade flows. It also connects Claude Code, Cursor and VS Code to the documentation MCP server, so your agent can search the latest docs. This is