# spree **Repository Path**: trusted-list/spree ## Basic Information - **Project Name**: spree - **Description**: Spree is an API-first, open-source eCommerce platform for fast growing businesses and enterprises. Spree supports complex commerce scenarios natively — from B2B wholesale to multi-vendor marketplace to global multi-region or multi-tenant distributor platforms. Use each model independently or combine them as your business evolves. - **Primary Language**: Unknown - **License**: BSD-3-Clause - **Default Branch**: main - **Homepage**: https://spreecommerce.org - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-03-12 - **Last Updated**: 2026-11-12 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README

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

[Website](https://spreecommerce.org) · [Next.js Storefront](https://github.com/spree/storefront) · [Documentation](https://spreecommerce.org/docs/) · [Free Sandbox](https://console.spree.sh) · [API](https://spreecommerce.org/docs/api-reference/) · [Roadmap](https://github.com/spree/spree/milestones?direction=asc&sort=due_date&state=open) · [Discord](https://discord.spreecommerce.org) [![Gem Total Downloads](https://img.shields.io/gem/dt/spree)](https://rubygems.org/gems/spree) [![codecov](https://codecov.io/gh/spree/spree/graph/badge.svg?token=DPFc7HbJvU)](https://codecov.io/gh/spree/spree) [![License](https://img.shields.io/badge/License-BSD%203--Clause-blue.svg)](https://opensource.org/licenses/BSD-3-Clause) **Build commerce the way you want it.** Spree is an open-source commerce platform with a complete REST API, TypeScript SDKs, a React admin dashboard, and a production-ready Next.js storefront. BSD 3-Clause licensed — keep full ownership of your code, data, and infrastructure. Teams use Spree to build **multi-vendor marketplaces** and **B2B and wholesale** channels, as well as headless DTC, cross-border and omnichannel selling — all from one set of commerce primitives, and all alongside the ERP, PIM, and payment systems you already run. Use AI agents to build your ecommerce business. Spree ships with a collection of agent skills for coding agents and a local MCP server that allows your to manage your store via chat. ## Use Cases Spree ships commerce primitives, so the same core serves very different businesses. ### [Multi-vendor Marketplace](https://spreecommerce.org/docs/developer/how-to/build-a-marketplace) Seller onboarding with configurable requirement checklists, orders split per seller at completion, a flexible [commission engine](https://spreecommerce.org/docs/developer/core-concepts/commissions), a payout ledger with Stripe Connect, and a dedicated Seller Panel. All in the open-source core. Spree Commerce - Multi-vendor Marketplace eCommerce ### [B2B & Wholesale](https://spreecommerce.org/docs/developer/how-to/build-a-b2b-store) [Price lists](https://spreecommerce.org/docs/developer/core-concepts/pricing) with volume tiers, [customer groups](https://spreecommerce.org/docs/user/customers/customer-groups), [companies](https://spreecommerce.org/docs/developer/core-concepts/companies) with locations, contacts and tax exemptions, [catalogs](https://spreecommerce.org/docs/developer/core-concepts/catalogs) for per-segment assortments, and storefronts gated to approved buyers. Spree Commerce - Wholesale eCommerce Platform ### [Headless & Omnichannel](https://spreecommerce.org/docs/developer/core-concepts/channels) Run web storefronts, mobile apps, points of sale, B2B panels and marketplaces off one backend. [Channels](https://spreecommerce.org/docs/developer/core-concepts/channels) give each surface its own catalog, pricing, payment methods and order attribution. The [Next.js storefront](https://github.com/spree/storefront) is one such surface — production-ready, open source, built with Next.js 16, React 19 and TypeScript. Fork it, customize it, deploy it. [Try the live demo](https://demo.spreecommerce.org/)
Spree Commerce - Next.js Storefront - Home Spree Commerce - Next.js Storefront - Product Spree Commerce - Next.js Storefront - Lighthouse
### [Cross-border Commerce](https://spreecommerce.org/docs/developer/core-concepts/markets) [Markets](https://spreecommerce.org/docs/developer/core-concepts/markets) bundle currency, language, payment methods and shipping per region, so each customer sees a localized storefront from a single platform. [Translations](https://spreecommerce.org/docs/developer/core-concepts/translations) for product content, EU Omnibus price history and customs duties are built in. Spree Commerce - Cross-border eCommerce ### [Multi-tenant SaaS](https://spreecommerce.org/docs/developer/multi-tenant/quickstart) Enterprise Run a SaaS platform where each tenant gets its own isolated store — catalog, orders, customers, payment methods and branding — with staff able to manage several tenants. Requires the [Enterprise Edition](https://spreecommerce.org/pricing). ## Getting Started ### Try it in a sandbox The fastest way to see Spree is a [free sandbox](https://console.spree.sh): a hosted store with the admin dashboard and APIs, ready in your browser. Nothing to install — sign in, click **Create store**, and explore. ### Install locally Copy and paste the following command to your terminal to set up Spree locally in 5 minutes: ```bash npx create-spree-app@latest my-store ``` This sets up the Spree backend, the React Admin Dashboard, and optionally the [Next.js storefront](https://github.com/spree/storefront) in a monorepo. The storefront is built with Next.js 16, React 19, Tailwind CSS 4, and TypeScript. Admin dashboard uses Vite and TanStack. You need Node.js 24+ installed and Docker running. Learn more in the [installation docs](https://spreecommerce.org/docs/developer/getting-started/quickstart). ### Agentic Development Spree comes with [agent skills](https://github.com/spree/agent-skills), which teach Claude Code, Codex, Cursor, Copilot and 60+ other tools Spree's conventions, customization patterns and upgrade flows. It also connects Claude Code, Cursor and VS Code to the [documentation MCP server](https://spreecommerce.org/docs/developer/agentic/mcp), so your agent can search the latest docs. This is automatically setup for you when you run `npx create-spree-app` and can be added to existing projects with `spree add ai`. See the [Agentic Development docs](https://spreecommerce.org/docs/developer/agentic/overview) for more details. ## Features Everything below ships in this repository under the BSD 3-Clause license. * **[REST API & TypeScript SDKs](https://spreecommerce.org/docs/api-reference/store-api/introduction)** — a REST API for storefronts, admins and sellers, with publishable keys, scoped secret keys, rate limiting and an OpenAPI 3.0 spec. Each provide their own TypeScript SDK. * **[React Admin Dashboard](https://spreecommerce.org/docs/developer/dashboard/overview)** — a Vite + React application built on TanStack Router and Query, shadcn/ui and Tailwind. Own it and customize without forking: [change navignation](https://spreecommerce.org/docs/developer/dashboard/customization/navigation), add/remove [routes](https://spreecommerce.org/docs/developer/dashboard/customization/routes), [modify table columns](https://spreecommerce.org/docs/developer/dashboard/customization/tables) and [insert your own UI widgets](https://spreecommerce.org/docs/developer/dashboard/customization/slots). Ships with a matching **Seller Panel** for marketplace vendors. * **[Next.js Storefront](https://github.com/spree/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](https://demo.spreecommerce.org/) * **[Spree CLI](https://spreecommerce.org/docs/developer/cli/quickstart)** — manage projects from the terminal (boot, generate, migrate, upgrade) and call the Admin API directly with `spree api get/post/...` — zero-config in local dev, built for scripts and AI agents. * **[MCP Server](https://spreecommerce.org/docs/developer/mcp/overview)** — a local server that you can connect to Claude, ChatGPT, or any LLM to fully manage your store via natural language. * **[Marketplace & Payouts](https://spreecommerce.org/docs/developer/core-concepts/sellers)** — seller onboarding with a configurable requirements checklist, per-seller order splitting, a [commission engine](https://spreecommerce.org/docs/developer/core-concepts/commissions) with EU commission taxation, and a payout ledger with Stripe Connect payouts. * **[B2B & Wholesale](https://spreecommerce.org/docs/developer/how-to/build-a-b2b-store)** — [price lists](https://spreecommerce.org/docs/developer/core-concepts/pricing) with volume tiers and negotiated rates, [customer groups](https://spreecommerce.org/docs/user/customers/customer-groups) for segmentation, [companies](https://spreecommerce.org/docs/developer/core-concepts/companies) with locations, contacts and validated tax exemptions, and [catalogs](https://spreecommerce.org/docs/developer/core-concepts/catalogs) for per-segment assortments. * **[Payments](https://spreecommerce.org/docs/developer/core-concepts/payments)** — provider-agnostic payment sessions that finish reliably even when a tab closes. Ships with [Stripe](https://spreecommerce.org/docs/integrations/payments/stripe), [Adyen](https://spreecommerce.org/docs/integrations/payments/adyen) and [PayPal](https://spreecommerce.org/docs/integrations/payments/paypal). Add your own with the [Payment Provider SDK](https://spreecommerce.org/docs/developer/how-to/custom-payment-method). * **[Promotions & Gift Cards](https://spreecommerce.org/docs/developer/core-concepts/promotions)** — a rules-based [promotions engine](https://spreecommerce.org/docs/developer/core-concepts/promotions) for percentage and fixed discounts, free shipping, BOGO offers and coupon codes, plus native [store credits and gift cards](https://spreecommerce.org/docs/developer/core-concepts/store-credits-gift-cards). * **[Fulfillment](https://spreecommerce.org/docs/developer/core-concepts/fulfillments)** — shipping, digital delivery and in-store pickup, [delivery profiles and zones](https://spreecommerce.org/docs/developer/core-concepts/delivery-setup), multi-location [inventory](https://spreecommerce.org/docs/developer/core-concepts/inventory), and [returns, exchanges and claims](https://spreecommerce.org/docs/developer/core-concepts/returns-exchanges-claims). * **[Taxes & Compliance](https://spreecommerce.org/docs/developer/core-concepts/taxes)** — inclusive or added-on tax, automatic calculation via Avalara and Stripe Tax, cross-border [customs fees & duties](https://spreecommerce.org/docs/developer/core-concepts/fees), and [data privacy](https://spreecommerce.org/docs/developer/core-concepts/data-privacy) tooling for GDPR subject requests and EU Omnibus price history. * **Products & Catalog** — [custom fields](https://spreecommerce.org/docs/developer/core-concepts/metafields) on any record, [CSV imports and exports](https://spreecommerce.org/docs/developer/core-concepts/imports-exports), digital products, product tags, a shared [media library](https://spreecommerce.org/docs/developer/core-concepts/media) and bulk operations. * **[Provider Contracts](https://spreecommerce.org/docs/developer/providers/overview)** — plug your existing stack in rather than replacing it: [ERP](https://spreecommerce.org/docs/developer/providers/erp), [PIM](https://spreecommerce.org/docs/developer/providers/pim), [WMS and carriers](https://spreecommerce.org/docs/developer/providers/fulfillment), [DAM](https://spreecommerce.org/docs/developer/providers/dam), [SSO](https://spreecommerce.org/docs/developer/providers/sso) and [payouts](https://spreecommerce.org/docs/developer/providers/payouts). * **[Security & Identity](https://spreecommerce.org/docs/developer/providers/sso)** — [OpenID Connect](https://spreecommerce.org/docs/developer/providers/sso) single sign-on for staff and customers, [custom auth adapters](https://spreecommerce.org/docs/developer/how-to/custom-api-authentication) for any JWT issuer, [role-based permissions](https://spreecommerce.org/docs/developer/customization/permissions) scoped per store, and a [PCI-compliant](https://spreecommerce.org/docs/developer/security/pci_compliance) payment architecture where card data never touches your server. * **[MeiliSearch Integration](https://spreecommerce.org/docs/integrations/search/meilisearch)** — typo-tolerant product search and faceted filtering, or [bring your own search provider](https://spreecommerce.org/docs/developer/how-to/custom-search-provider). * **Integrations & Extensibility** — [Event Bus](https://spreecommerce.org/docs/developer/core-concepts/events), [Webhooks](https://spreecommerce.org/docs/developer/core-concepts/webhooks), [OpenTelemetry](spree/opentelemetry) instrumentation, and native integrations ([GA4](https://spreecommerce.org/docs/integrations/analytics/google-analytics), [GTM](https://spreecommerce.org/docs/integrations/analytics/google-tag-manager), [Klaviyo](https://spreecommerce.org/docs/integrations/marketing/klaviyo)). * **[Agentic Development](https://spreecommerce.org/docs/developer/agentic/overview)** — [agent skills](https://github.com/spree/agent-skills) teaching AI coding agents Spree's conventions and a [docs MCP server](https://spreecommerce.org/docs/developer/agentic/mcp), both set up with one command (`spree add ai`), plus [LLM-ready documentation](https://spreecommerce.org/docs/developer/agentic/llm-docs) (llms.txt, per-page Markdown, offline npm package), and a generated AGENTS.md/CLAUDE.md in every scaffolded project. ## Deployment The Spree backend can be deployed anywhere — cloud, on-prem or VPS. We provide official Docker images and Dockerfiles, so you can use AWS, Azure, GCP, Render, Railway, Fly.io, Heroku, or any other Docker-compatible host. The Next.js storefront can be deployed to Vercel, Netlify, or any Node.js host. See the [Deployment Documentation](https://spreecommerce.org/docs/developer/deployment) for more details. ## Community & Contributing Spree is an open-source project, and we love contributions in any form — pull requests, issues, feature ideas. * Follow our [Contributing Guide](https://spreecommerce.org/docs/developer/contributing/quickstart) * [Join our Discord](https://discord.spreecommerce.org) to meet other community members * Browse the [Roadmap](https://github.com/spree/spree/milestones?direction=asc&sort=due_date&state=open) and open [Issues](https://github.com/spree/spree/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](https://spreecommerce.org/enterprise/) for organizations that need additional modules and SLA-backed support. Enterprise adds **B2B approval workflows** with role-based approval chains and ERP connectors, **marketplace automations** such as Shopify and WooCommerce seller sync and advanced reporting, **[multi-tenant SaaS](https://spreecommerce.org/docs/developer/multi-tenant/quickstart)** — running many isolated tenant stores from one deployment, with a super-admin, tenant provisioning and white-label billing — **audit logging and encryption at-rest**, and **SLA support** with a dedicated success manager, LTS releases and 24/7 monitoring. Everything else — the APIs, the SDKs, the dashboard, marketplace, B2B and cross-border — is in this repository. Enterprise Edition builds on the same BSD 3-Clause core, so your team keeps full ownership of the code, the data, and the infrastructure. Zero platform fees. Zero transaction fees. [Contact our Sales team](https://spreecommerce.org/contact/) for an Enterprise Edition demo, or [join Discord](https://discord.spreecommerce.org) to use the open-source edition with the community. ## License Spree Commerce core code in the **[spree/spree](https://github.com/spree/spree)** repository is released under the free, open-source [BSD-3-Clause](https://opensource.org/license/bsd-3-clause) license ([LICENSE](https://github.com/spree/spree/blob/main/LICENSE)). If you like what you see, consider giving Spree a GitHub star ⭐ Thank you for supporting Spree open-source ❤️