Overview:
Spree Commerce is an open-source headless eCommerce platform built around a complete REST API and TypeScript SDK. It provides the core components for launching online storefronts, including a production-ready Next.js storefront with integrated payments and SEO. The platform is designed to support cross-border commerce, B2B wholesale, multi-vendor marketplaces, and multi-tenant SaaS deployments. It is aimed at development teams who need a customizable, API-first commerce stack.
Core Features:
REST API & TypeScript SDK: Production-grade REST API with flat JSON, publishable keys, rate limiting, and OpenAPI 3.0 spec. The TypeScript SDK provides autocomplete and type safety.
Next.js Storefront: Open-source storefront built with Next.js 16, React 19, Tailwind CSS 4, and TypeScript. Includes multi-region URL routing, Stripe payments (Apple Pay, Google Pay, Klarna, Affirm), customer accounts, and SEO.
Cross-Border Commerce: Markets bundle currency, language, payment methods, and shipping rules per country. Includes a Translations Center for bulk product localization and EU Omnibus Directive compliance.
Payment Sessions: Provider-agnostic payment processing that ships with Stripe and supports adding Adyen or PayPal without changing storefront checkout code.
Pricing & Promotions: Price Lists for regional/B2B/wholesale pricing, Customer Groups, Gift Cards, and an advanced Promotions Engine.
Integrations & Extensibility: Includes an Event Bus, Webhooks 2.0, and native integrations with GA4, GTM, Klaviyo, and MeiliSearch.
Use Cases:
Launching a multi-vendor marketplace: Automate vendor onboarding via Shopify, WooCommerce, or CSV import, manage product sync and split payments, and handle vendor payouts through Stripe Connect.
Building a B2B eCommerce platform: Implement customer-specific price lists, buyer organizations with roles and approval workflows, gated storefronts, and ERP/procurement integrations.
Selling across multiple countries: Use Markets to bundle per-country configuration for currency, language, payment methods, and shipping rules, allowing customers to see a localized storefront from a single platform.
Why It Matters:
Spree provides a complete, open-source eCommerce stack where core features like the API, storefront, and admin dashboard are transparent and modifiable. The platform is designed to be extended through REST APIs, a TypeScript SDK, webhooks, and an event bus. Enterprise modules for B2B, marketplace, and multi-tenant commerce are available separately, allowing teams to add complexity as needed without changing the core, BSD 3-Clause licensed foundation.

