Spree Commerce

Website · Next.js Storefront · Demo · Documentation · API · Roadmap · Discord · Enterprise

Open-source headless eCommerce platform with a complete REST API, TypeScript SDK, and a production-ready Next.js storefront.

Everything you need to launch cross-border storefronts, B2B wholesale, multi-vendor marketplaces, or multi-tenant SaaS.

Getting Started

Copy and paste the following command to your terminal to set up Spree in 5 minutes:

bash

npx create-spree-app@latest my-store

This sets up the Spree Commerce backend, the Admin Dashboard, and the Next.js storefront in a single project. The storefront is built with Next.js 16, React 19, Tailwind CSS 4, and TypeScript.

You need to have Node.js (22+) installed and Docker running. Learn more in the installation docs.

Or deploy directly to the cloud:

Note This uses Render's free plan for quick evaluation. Free instances spin down after inactivity and may take 30-60s to wake up. For production, see recommended sizing.

If you prefer to install Spree manually, you may follow the Quickstart Guide.

If you like what you see, consider giving Spree a GitHub star ⭐

Thank you for supporting Spree open-source ❤️

Features

REST API & TypeScript SDK -- production-grade REST API with flat JSON, publishable keys, rate limiting, and OpenAPI 3.0 spec. The TypeScript SDK adds autocomplete and type safety.
Next.js Storefront -- open-source storefront built with Next.js 16, React 19, Tailwind CSS 4, and TypeScript. Full shopping experience, multi-region URL routing, Stripe payments (Apple Pay, Google Pay, Klarna, Affirm), customer accounts, and SEO built in. Try the demo
Cross-Border Commerce -- Markets bundle currency, language, payment methods, and shipping rules per country. Translations Center for bulk product localization. EU Omnibus Directive compliance with automatic 30-day price history.
Payment Sessions -- provider-agnostic payment processing. Ship with Stripe, add Adyen or PayPal without changing storefront checkout code.
MeiliSearch Integration -- typo-tolerant product search and faceted filtering
AI-Ready Development -- AGENTS.md and bundled offline docs ship with every scaffolded project. OpenAPI 3.0 specs enable typed client generation for any language.
Admin Dashboard -- rebuilt admin with Tailwind CSS, Tables DSL, and role-based permissions
Pricing & Promotions -- Price Lists for regional/B2B/wholesale pricing, Customer Groups, Gift Cards, and an advanced Promotions Engine
Products & Catalog -- Metafields, CSV importer/exporter, digital products, product tags, bulk operations
Integrations & Extensibility -- Event Bus, Webhooks 2.0, native integrations (GA4, GTM, Klaviyo, MeiliSearch)

Read the full announcement: Announcing Spree Commerce 5.4: A Complete Open Source eCommerce Stack

Documentation

Spree Commerce supports complex commerce scenarios natively and lets you combine them as your business evolves: B2B eCommerce, multi-store, cross-border, multi-vendor marketplace, digital products, multi-tenant commerce.

Enterprise Support

Your success is backed by the team that builds Spree. Contact us to get access to:

Dedicated Success Manager -- your single point of contact who understands your business and coordinates resources
SLA-Backed Response Times -- guaranteed response windows for issue resolution depending on severity
Group Chat & Email Support -- direct access to our team through Slack, Teams, or email
Long-Term Support (LTS) -- extended maintenance and security patches with predictable upgrade cycles
Priority Fixes & Change Requests -- priority access to new features and version upgrades
24/7 Monitoring & Response -- round-the-clock infrastructure monitoring with proactive alerting
Professional Services On-Demand -- development consulting, custom integrations, and implementation services

Enterprise Edition

Spree Commerce Enterprise Edition adds enterprise-grade security and purpose-built modules for complex commerce scenarios -- B2B wholesale, multi-vendor marketplace, and multi-tenant eCommerce. Built on the same open-source REST API and BSD 3-Clause core, so your team keeps full ownership of the code, the data, and the infrastructure. Zero platform fees. Zero transaction fees. Use each module independently or combine them as your business evolves.

Enterprise-grade security by default:

Encryption at-rest (AES-256) and in-transit (TLS 1.3)
Single Sign-On (SSO) -- Okta, Azure AD, Google Workspace, or any SAML/OIDC provider
PCI DSS-compliant architecture with tokenized payments
Role-Based Access Control with granular permissions
Audit logging for compliance reviews
Continuous security patches delivered through the LTS program

Enterprise Edition modules:

Multi-vendor Marketplace -- automated vendor onboarding (Shopify, WooCommerce, CSV), product and order sync, split payments, and vendor payouts via Stripe Connect
B2B eCommerce -- customer-specific price lists, buyer organizations with roles and approval workflows, gated storefronts, and ERP/procurement integrations
Multi-tenant eCommerce -- host hundreds of independent stores as a white-label SaaS, franchise network, or multi-brand platform with central control over billing, fulfillment, and operations

Contact our Sales team to get access to the Enterprise Edition.

What you can build with Spree

Next.js eCommerce Storefront

A production-ready, open-source storefront built with Next.js 16, React 19, and TypeScript. Fork it, customize it, deploy it. Try the live demo

Multi-vendor marketplace

Launch a multi-vendor marketplace with automated vendor onboarding (two-way sync with Shopify, WooCommerce, other platforms), product catalog curation, Stripe Connect or Adyen for Platforms marketplace payment splitting and vendor payouts, granular commission management, marketplace promos, cross-border sales and many other features.

B2B eCommerce Platform

Customer segmentation for personalized shopping experiences, customer-specific volume pricing, buyer organizations with approval workflows, and gated storefronts. Integrate with any ERP or procurement system through the REST API and TypeScript SDK. Combine this capability with a Multi-vendor Marketplace, Cross-border eCommerce or both.

Cross-border eCommerce

Sell in multiple markets with local currencies, languages, payment methods, and shipping rules. Markets bundle per-country configuration so each customer sees a localized storefront from a single platform. Combine this capability with a Multi-vendor Marketplace, a B2B eCommerce Platform or both.

Wholesale eCommerce

Price Lists, gated storefronts, and bulk ordering. Sell to multiple customer segments through separate storefronts with the right assortment and pricing. Combine this capability with a Multi-vendor Marketplace, Cross-border eCommerce or both.

Multi-tenant eCommerce Platform

Host hundreds of independent stores as a white-label SaaS, franchise network, or multi-brand platform. Each tenant gets their own dashboard, storefront, and branding. B2B2B or B2B2C.

Community & Contributing

Spree is an open source project, and we love contributions in any form -- pull requests, issues, feature ideas!

Follow our Contributing Guide

Join our Discord to meet other community members.

Contact

License

Spree Commerce core code in the spree/spree repository is released under the free, open-source BSD-3-Clause license (LICENSE).

If you like what you see, consider giving Spree a GitHub star ⭐

Thank you for supporting Spree open-source ❤️