Skip to content

armgit / spree

Public Imported from GitHub
0

Open Source Platform for DTC, B2B Commerce, Marketplaces & Omnichannel. REST APIs, TypeScript SDKs, and production-ready Next.js storefront. Self-host it. Own your data. No vendor lock-in. Zero platform fees.

Clarify B2B features in README (#14086)

Damian Legawiec307e201bb3b7
diff --git a/README.md b/README.md
index 2522ee4582..ff590a34dc 100755
--- a/README.md
+++ b/README.md
@@ -4,8 +4,6 @@
</a>
</p>
-# Spree Commerce
-
[Website](https://spreecommerce.org)
·
[Next.js Storefront](https://github.com/spree/storefront)
@@ -19,19 +17,15 @@
[Roadmap](https://github.com/spree/spree/milestones?direction=asc&sort=due_date&state=open)
·
[Discord](https://discord.spreecommerce.org)
-·
-[Enterprise](https://spreecommerce.org/enterprise/)
[![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)
-Open-source headless eCommerce platform with a complete REST API, TypeScript SDK, and a production-ready Next.js storefront.
+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, multi-vendor marketplaces, or multi-tenant SaaS.
-
-Have questions or need help getting started? [Contact us](https://spreecommerce.org/contact/) for expert guidance and advice on your Spree project.
+Everything you need to launch cross-border storefronts, B2B wholesale, or a custom commerce backend.
## Getting Started
@@ -60,57 +54,22 @@ Thank you for supporting Spree open-source ❤️
## Features
-* **[REST API & TypeScript SDK](https://spreecommerce.org/docs/api-reference/store-api/introduction)** -- production-grade REST API with flat JSON, publishable keys, rate limiting, and OpenAPI 3.0 spec. The [TypeScript SDK](https://spreecommerce.org/docs/developer/sdk/quickstart) adds autocomplete and type safety.
-* **[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/)
-* **[Cross-Border Commerce](https://spreecommerce.org/docs/user/settings/markets)** -- 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](https://spreecommerce.org/docs/developer/core-concepts/payments)** -- provider-agnostic payment processing. Ship with [Stripe](https://spreecommerce.org/docs/integrations/payments/stripe), add [Adyen](https://spreecommerce.org/docs/integrations/payments/adyen) or PayPal without changing storefront checkout code.
-* **[MeiliSearch Integration](https://spreecommerce.org/docs/integrations/search/meilisearch)** -- 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](https://spreecommerce.org/docs/developer/admin/custom-css), [Tables DSL](https://spreecommerce.org/docs/developer/admin/tables), and [role-based permissions](https://spreecommerce.org/docs/developer/customization/permissions)
-* **Pricing & Promotions** -- [Price Lists](https://spreecommerce.org/docs/developer/core-concepts/products#price-lists) for regional/B2B/wholesale pricing, [Customer Groups](https://spreecommerce.org/docs/user/customers/customer-groups), [Gift Cards](https://spreecommerce.org/docs/developer/core-concepts/store-credits-gift-cards), and an advanced [Promotions Engine](https://spreecommerce.org/docs/user/promotions/create-a-promotion)
-* **Products & Catalog** -- [Metafields](https://spreecommerce.org/docs/developer/core-concepts/metafields), [CSV importer/exporter](https://spreecommerce.org/docs/user/manage-products/import-products), digital products, product tags, [bulk operations](https://spreecommerce.org/docs/user/manage-products/bulk-product-operations)
-* **Integrations & Extensibility** -- [Event Bus](https://spreecommerce.org/docs/developer/core-concepts/events), [Webhooks 2.0](https://spreecommerce.org/docs/developer/core-concepts/webhooks), 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), [MeiliSearch](https://spreecommerce.org/docs/integrations/search/meilisearch))
-
-Read the full announcement: **[Announcing Spree Commerce 5.4: A Complete Open Source eCommerce Stack](https://spreecommerce.org/announcing-spree-commerce-5-4/)**
-
-## Documentation
-
-Spree Commerce supports complex commerce scenarios natively and lets you combine them as your business evolves: [B2B eCommerce](https://spreecommerce.org/docs/use-case/b2b/b2b-capabilities), [multi-store](https://spreecommerce.org/docs/use-case/multi-store/capabilities), [cross-border](https://spreecommerce.org/multi-region-ecommerce/), [multi-vendor marketplace](https://spreecommerce.org/docs/use-case/marketplace/capabilities), [digital products](https://spreecommerce.org/docs/use-case/digital-products/capabilities), [multi-tenant commerce](https://spreecommerce.org/docs/use-case/multi-tenant/multi-tenant-capabilities).
-
-## Enterprise Support
-
-Your success is backed by the team that builds Spree. [Contact us](https://spreecommerce.org/contact/) 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](https://spreecommerce.org/enterprise/) 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
+Everything below ships in this repository under the BSD 3-Clause license.
-[Contact our Sales team](https://spreecommerce.org/contact/) to get access to the Enterprise Edition.
+* **[REST API & TypeScript SDK](https://spreecommerce.org/docs/api-reference/store-api/introduction)** — production-grade REST API, publishable keys, rate limiting, and OpenAPI 3.0 spec. The [TypeScript SDK](https://spreecommerce.org/docs/developer/sdk/quickstart) adds autocomplete and type safety.
+* **[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/)
+* **[Cross-Border Commerce](https://spreecommerce.org/docs/user/settings/markets)** — 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](https://spreecommerce.org/docs/developer/core-concepts/products#price-lists)** — [Price Lists](https://spreecommerce.org/docs/developer/core-concepts/products#price-lists) for regional, B2B, and wholesale pricing. [Customer Groups](https://spreecommerce.org/docs/user/customers/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](https://spreecommerce.org/docs/use-case/multi-store/capabilities)** — run multiple storefronts off a single Spree backend, each with its own domain, branding, products, and currency.
+* **[Payment Sessions](https://spreecommerce.org/docs/developer/core-concepts/payments)** — provider-agnostic payment processing. Ship with [Stripe](https://spreecommerce.org/docs/integrations/payments/stripe), [Adyen](https://spreecommerce.org/docs/integrations/payments/adyen) and PayPal without changing storefront checkout code.
+* **[Promotions & Gift Cards](https://spreecommerce.org/docs/user/promotions/create-a-promotion)** — advanced promotions engine and [Gift Cards](https://spreecommerce.org/docs/developer/core-concepts/store-credits-gift-cards).
+* **Products & Catalog** — [Metafields](https://spreecommerce.org/docs/developer/core-concepts/metafields), [CSV importer/exporter](https://spreecommerce.org/docs/user/manage-products/import-products), digital products, product tags, [bulk operations](https://spreecommerce.org/docs/user/manage-products/bulk-product-operations).
+* **[MeiliSearch Integration](https://spreecommerce.org/docs/integrations/search/meilisearch)** — typo-tolerant product search and faceted filtering.
+* **Admin Dashboard** — built with [Tailwind CSS](https://spreecommerce.org/docs/developer/admin/custom-css), [Tables DSL](https://spreecommerce.org/docs/developer/admin/tables), and [role-based permissions](https://spreecommerce.org/docs/developer/customization/permissions).
+* **Integrations & Extensibility** — [Event Bus](https://spreecommerce.org/docs/developer/core-concepts/events), [Webhooks 2.0](https://spreecommerce.org/docs/developer/core-concepts/webhooks), 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)).
+* **AI-Ready Development** — AGENTS.md and bundled offline docs ship with every scaffolded project.
-## What you can build with Spree
+## Screenshots
### [Next.js eCommerce Storefront](https://github.com/spree/storefront)
@@ -124,60 +83,58 @@ A production-ready, open-source storefront built with Next.js 16, React 19, and
</tr>
</table>
-### [Multi-vendor marketplace](https://spreecommerce.org/marketplace-ecommerce/)
-
-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.
-
-* [Marketplace eCommerce Capabilities](https://spreecommerce.org/docs/use-case/marketplace/capabilities)
-* [Marketplace eCommerce Admin Panel](https://spreecommerce.org/docs/use-case/marketplace/admin-dashboard)
-* [Marketplace eCommerce Vendor Panel](https://spreecommerce.org/docs/use-case/marketplace/vendor-dashboard)
-* [Marketplace eCommerce Customer Experience](https://spreecommerce.org/docs/use-case/marketplace/customer-ux)
-
-<img alt="Spree Commerce - Multi-vendor Marketplace eCommerce" src="https://github.com/spree/spree/assets/12614496/c4ddd118-df4c-464e-b1fe-d43862e5cf25" width="600" >
-
-### [B2B eCommerce Platform](https://spreecommerce.org/use-cases/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.
-
-* [B2B eCommerce Capabilities](https://spreecommerce.org/docs/use-case/b2b/b2b-capabilities)
-* [B2B eCommerce Admin Capabilities](https://spreecommerce.org/docs/use-case/b2b/b2b-admin-capabilities)
-* [B2B eCommerce Buyer Experience](https://spreecommerce.org/docs/use-case/b2b/b2b-buyer-capabilities)
-
-<img alt="Spree Commerce - B2B eCommerce Platform" src="https://github.com/spree/spree/assets/12614496/e0a184f6-31ad-4f7f-b30b-6f8a501b6f63" width="600" >
-
### [Cross-border eCommerce](https://spreecommerce.org/multi-region-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.
+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.
<img alt="Spree Commerce - Cross-border eCommerce" src="https://spreecommerce.org/wp-content/uploads/2024/07/multi-region-country-shopping-1024x575.webp" width="600" >
-### [Wholesale eCommerce](https://spreecommerce.org/use-cases/wholesale-ecommerce/)
+### [Wholesale & B2B Pricing](https://spreecommerce.org/use-cases/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.
+Price Lists, Customer Groups, and gated storefronts. Sell to multiple customer segments with the right assortment and pricing per segment.
-<img src="https://github.com/spree/spree/assets/12614496/bac1e551-f629-47d6-a983-b385aa65b1bd" alt="Spree Commerce - Wholesale eCommerce Platform" width="600" >
+<img src="https://github.com/spree/spree/assets/12614496/bac1e551-f629-47d6-a983-b385aa65b1bd" alt="Spree Commerce - Wholesale eCommerce Platform" width="600" >
-### [Multi-tenant eCommerce Platform](https://spreecommerce.org/multi-tenant-white-label-ecommerce/)
+### [Multi-vendor Marketplace](https://spreecommerce.org/marketplace-ecommerce/)
-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.
+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.
-* [Multi-Tenant Capabilities](https://spreecommerce.org/docs/use-case/multi-tenant/multi-tenant-capabilities)
-* [Multi-Tenant Super Admin Capabilities](https://spreecommerce.org/docs/use-case/multi-tenant/super-admin-capabilities)
-* [Tenant Capabilities](https://spreecommerce.org/docs/use-case/multi-tenant/tenant-capabilities)
-
-<img src="https://github.com/spree/spree/assets/12614496/cf651354-6180-4927-973f-c650b80ccdb0" alt="Spree Commerce - Multi-tenant eCommerce Platform" width="600" >
+<img alt="Spree Commerce - Multi-vendor Marketplace eCommerce" src="https://github.com/spree/spree/assets/12614496/c4ddd118-df4c-464e-b1fe-d43862e5cf25" width="600" >
## Community & Contributing
-Spree is an open source project, and we love contributions in any form -- pull requests, issues, feature ideas!
+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.
-Follow our [Contributing Guide](https://spreecommerce.org/docs/developer/contributing/quickstart)
+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.
-[Join our Discord](https://discord.spreecommerce.org) to meet other community members.
+### What's in Core vs. Enterprise
-## Contact
+| 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 us](https://spreecommerce.org/contact/) and let's go!
+[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