Skip to content

spree/spree

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

28,201 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Spree Commerce open source headless eCommerce platform for B2B, Multi-vendor Marketplace, cross-border eCommerce, multi-tenant eCommerce

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

Gem Total Downloads codecov License

Open-source headless eCommerce platform with a complete REST API, TypeScript SDK, and a production-ready Next.js storefront. BSD 3-Clause licensed — keep full ownership of your code, data, and infrastructure.

Everything you need to launch cross-border storefronts, B2B wholesale, or a custom commerce backend.

Getting Started

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

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:

Deploy to Render

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

Everything below ships in this repository under the BSD 3-Clause license.

  • REST API & TypeScript SDK — production-grade REST API, 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.
  • B2B & WholesalePrice Lists for regional, B2B, and wholesale pricing. Customer Groups for segmentation. Companies, company locations, and company contacts for buyer organizations. Catalogs for curated, per-segment product assortments. Gated storefronts via publishable keys.
  • Multi-Store — run multiple storefronts off a single Spree backend, each with its own domain, branding, products, and currency.
  • Payment Sessions — provider-agnostic payment processing. Ship with Stripe, Adyen and PayPal without changing storefront checkout code.
  • Promotions & Gift Cards — advanced promotions engine and Gift Cards.
  • Products & CatalogMetafields, CSV importer/exporter, digital products, product tags, bulk operations.
  • MeiliSearch Integration — typo-tolerant product search and faceted filtering.
  • Admin Dashboard — built with Tailwind CSS, Tables DSL, and role-based permissions.
  • Integrations & ExtensibilityEvent Bus, Webhooks 2.0, native integrations (GA4, GTM, Klaviyo).
  • AI-Ready Development — AGENTS.md and bundled offline docs ship with every scaffolded project.

Screenshots

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

Spree Commerce - Next.js Storefront - Home Spree Commerce - Next.js Storefront - Product Spree Commerce - Next.js Storefront - Lighthouse

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.

Spree Commerce - Cross-border eCommerce

Price Lists, Customer Groups, and gated storefronts. Sell to multiple customer segments with the right assortment and pricing per segment.

Spree Commerce - Wholesale eCommerce Platform

Launch a multi-vendor marketplace with vendor accounts, product catalog curation, split payments, vendor payouts, and commission management. The Enterprise Edition adds automated vendor onboarding (Shopify, WooCommerce sync) and Stripe Connect / Adyen for Platforms integrations.

Spree Commerce - Multi-vendor Marketplace eCommerce

Community & Contributing

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

Spree Enterprise Edition

Spree is built and maintained by a funded team behind the open-source project. Beyond the open-source Core, we offer a paid Enterprise Edition for organizations that need additional modules and SLA-backed support.

Enterprise Edition is built on top of 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.

What's in Core vs. Enterprise

Capability Open-source (this repo) Enterprise Edition
REST API, TypeScript SDK, Next.js storefront
Multi-store, Markets, cross-border, multi-currency
Promotions, Gift Cards, Digital Products
Payment integrations: Stripe, Adyen, PayPal
Automatic tax calculation with Avatax & Stripe Tax
B2B & Wholesale — Price Lists, Customer Groups, gated storefronts
B2B Buyer organizations (companies, locations, contacts) Coming soon in Spree 6.0
B2B Catalogs — curated per-segment product assortments Coming soon in Spree 6.0
B2B approval workflows & ERP integrations — role-based approval chains, procurement and ERP connectors
Multi-vendor Marketplace — vendor onboarding, vendor panel, commissions, split payments, vendor payouts Coming soon in Spree 6.0
Marketplace automations — Shopify/WooCommerce vendor sync, Stripe Connect onboarding, automated commission rules, advanced reporting
Multi-tenant SaaS — super-admin layer, tenant provisioning, white-label billing, central operations across hundreds of tenant stores
Enterprise security — SSO (SAML/OIDC), encryption at-rest, audit logging, PCI-compliant architecture
SLA support — dedicated success manager, guaranteed response times, LTS releases, 24/7 monitoring

Contact our Sales team for an Enterprise Edition demo, or join Discord to use the open-source edition with the community.

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 ❤️