spree/spree — Gitpedia

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

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:

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.

Building with an AI coding agent? Install the Spree agent skills — they teach Claude Code, Cursor, Copilot, and 60+ other tools Spree's conventions, customization patterns, and upgrade flows:

bash
npx skills add spree/agent-skills

Then connect the docs MCP server and let your agent build with you. Learn more in the Agentic Development docs.

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 & Wholesale — Price 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 & Catalog — Metafields, 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 & Extensibility — Event Bus, Webhooks 2.0, native integrations (GA4, GTM, Klaviyo).
Agentic Development — 25 agent skills (npx skills add spree/agent-skills) teaching AI coding agents Spree's conventions, a docs MCP server, LLM-ready documentation (llms.txt, per-page Markdown, offline npm package), and a generated AGENTS.md/CLAUDE.md in every scaffolded project.

Screenshots

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

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.

Wholesale & B2B Pricing

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

Multi-vendor Marketplace

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.

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
Browse the Roadmap and open Issues

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	—	✅