Spree Commerce is an open-sourceheadlesse-commerce platform.[3] It provides REST APIs that allow Next.js storefront developers, mobile app developers, and SaaS platforms to build commerce experiences against a shared backend.[4]
It was created by Sean Schofield in 2007 and has since had over 800 contributors.[5] The project has gained over 15,000 stars on GitHub,[6] and has been downloaded over 2.7 million times from RubyGems.[7]
Spree is distributed in two editions. The Community Edition (CE), licensed under BSD-3-Clause,[11] provides the core commerce engine. The Enterprise Edition (EE) adds commercial modules for B2B, marketplace, and multi-tenant use cases, as well as enterprise support.[12]
Architecture
Spree exposes two RESTAPIs conforming to the OpenAPI 3.0 specification:[13] a Store API for customer-facing operations (browsing, cart, checkout) and an Admin API for back-office management and third-party integrations.[14][15] An official TypeScript SDK and a production Next.js storefront starter are available on GitHub under the MIT license.[16]
Multi-vendor marketplace: vendor onboarding, commission management, automatic payment splitting via Stripe Connect and Adyen for Platforms
Multi-tenant white-label: isolated storefronts managed from a single installation
Security and governance: role-based permissions, audit logging, SSO, data encryption, and GDPR data export and anonymization tools
Typical Use Cases
As an open-source, self-hosted platform with full API access, Spree is used in scenarios where organizations require control over the technology stack, data residency, or deep customization.[19] Common deployment patterns include:
Headless storefronts – the REST APIs and TypeScript SDK allow frontend teams to build custom storefronts using frameworks such as Next.js or native mobile apps (iOS, Android) while Spree handles the commerce backend.[20]
Cross-border commerce – the Markets system allows a single Spree installation to serve multiple countries, each with its own currency, language, payment methods, and shipping rules.
B2B and wholesale – the Enterprise Edition provides buyer organizations, approval workflows, customer-specific pricing, and gated storefronts for business-to-business sales.[21]
Multi-vendor marketplaces – vendor onboarding, product approval flows, commission management, and automated payment splitting support marketplace models where third-party sellers fulfill orders.[22]
Multi-tenant white-label – a single Spree installation can host multiple isolated storefronts with independent branding, catalogs, and configurations, used by SaaS platforms and franchise operators.[23]
Embedded commerce – SaaS applications can integrate Spree's APIs to add commerce capabilities (catalog, checkout, payments) without building a commerce engine from scratch.
Licensing
Spree Commerce is licensed under the open-source BSD-3-Clause license — free to use, modify, and distribute for any purpose, including commercial use.[24]
Spree ecosystem packages (starters, SDKs, payment integrations, and extensions) are licensed under the MIT license.[25]
The Multi-Store module (spree_multi_store) is available under the AGPL v3, which is an OSI-approved open-source license, with a Commercial License option available for those who wish to keep their code changes private. Single-store installations are not affected by this.[26]
Spree Commerce history
On July 1, 2011, Spree received $1.5 million in seed funding from AOL and True Ventures.[27] On February 25, 2014, Spree raised an additional $5M in Series A funding led by Thrive Capital. Also participating were Vegas Tech Fund (led by Zappos CEO Tony Hsieh), Red Swan (led by Bonobos CEO Andy Dunn) as well as existing investors True Ventures and AOL Ventures.[28]
On September 21, 2015, it was acquired by First Data.[29] After the First Data acquisition, developers from Spark Solutions and VinSol now maintain and develop the Spree Commerce Open Source project. Vinsol also develops Spree extensions.
In 2016 an OpenCommerce Conference was held in New York to showcase the newest e-commerce projects running on Spree.[30]
In 2021, Spree transitioned from a monolithic architecture to an API-first, headless model, introducing REST APIs that decoupled the commerce backend from the frontend presentation layer. A JavaScript SDK was released to support developers building storefronts against the Spree API.
On April 2, 2025, Spree 5.0 was released,[31] splitting the project into a free Community Edition (BSD-3-Clause) and a commercial Enterprise Edition with B2B, marketplace, and multi-tenant modules. Spree 5 also upgraded the APIs to conform to the OpenAPI 3.0 specification.
In April 2026, Spree 5.4 introduced a TypeScript SDK, a production-ready Next.js storefront starter,[32] a provider-agnostic Payment Sessions API supporting Stripe, Adyen, and PayPal, and a Markets system for managing multiple countries with per-region currencies, languages, and payment configurations from a single installation.[33]
This page is based on this Wikipedia article Text is available under the CC BY-SA 4.0 license; additional terms may apply. Images, videos and audio are available under their respective licenses.
