Skip to content
Back to search

spree

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.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/spree/spree with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/spree/spree'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/spree--spree/badge.svg)](/listings/spree--spree)

HTML

<a href="/listings/spree--spree"><img src="/api/listings/spree--spree/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

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:

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.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 143 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. <p>
  2. <a href="https://spreecommerce.org">
  3. <img src="https://spreecommerce.org/wp-content/themes/spree/images/logo.svg" alt="Spree Commerce open source headless eCommerce platform for B2B, Multi-seller Marketplace, cross-border eCommerce, multi-tenant eCommerce" width="250" />
  4. </a>
  5. </p>
  6. [Website](https://spreecommerce.org)
  7. ·
  8. [Next.js Storefront](https://github.com/spree/storefront)
  9. ·
  10. [Documentation](https://spreecommerce.org/docs/)
  11. ·
  12. [Free Sandbox](https://console.spree.sh)
  13. ·
  14. [API](https://spreecommerce.org/docs/api-reference/)
  15. ·
  16. [Roadmap](https://github.com/spree/spree/milestones?direction=asc&sort=due_date&state=open)
  17. ·
  18. [Discord](https://discord.spreecommerce.org)
  19. [![Gem Total Downloads](https://img.shields.io/gem/dt/spree)](https://rubygems.org/gems/spree)
  20. [![codecov](https://codecov.io/gh/spree/spree/graph/badge.svg?token=DPFc7HbJvU)](https://codecov.io/gh/spree/spree)
  21. [![License](https://img.shields.io/badge/License-BSD%203--Clause-blue.svg)](https://opensource.org/licenses/BSD-3-Clause)
  22. **Build commerce the way you want it.** Spree is an open-source headless commerce platform with complete REST APIs, TypeScript SDKs, an MCP server, a React admin dashboard, and a production-ready Next.js storefront. BSD 3-Clause licensed — keep full ownership of your code, data, and infrastructure.
  23. 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.
  24. Use AI agents to build your ecommerce business. Spree ships with a collection of agent skills for coding agents and an MCP server that lets you manage your store via chat.
  25. ## Use Cases
  26. Spree ships commerce primitives, so the same core serves very different businesses.
  27. ### [Multi-vendor Marketplace](https://spreecommerce.org/docs/developer/how-to/build-a-marketplace)
  28. 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.
  29. <img alt="Spree Commerce - Multi-vendor Marketplace eCommerce" src="https://github.com/spree/spree/assets/12614496/c4ddd118-df4c-464e-b1fe-d43862e5cf25" width="600" >
  30. ### [B2B & Wholesale](https://spreecommerce.org/docs/developer/how-to/build-a-b2b-store)
  31. [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.
  32. <img src="https://github.com/spree/spree/assets/12614496/bac1e551-f629-47d6-a983-b385aa65b1bd" alt="Spree Commerce - Wholesale eCommerce Platform" width="600" >
  33. ### [Headless & Omnichannel](https://spreecommerce.org/docs/developer/core-concepts/channels)
  34. 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.
  35. 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/)
  36. <table>
  37. <tr>
  38. <td><a href="https://demo.spreecommerce.org/"><img src="https://spreecommerce.org/wp-content/uploads/2026/04/Spree-Commerce-Next.js-Storefront-Homepage.webp" alt="Spree Commerce - Next.js Storefront - Home" width="400" /></a></td>
  39. <td><a href="https://demo.spreecommerce.org/"><img src="https://spreecommerce.org/wp-content/uploads/2026/04/Spree-Commerce-Next.js-Storefront-Product-Detail-Page-PDP.webp" alt="Spree Commerce - Next.js Storefront - Product" width="400" /></a></td>
  40. <td><a href="https://demo.spreecommerce.org/"><img src="https://spreecommerce.org/wp-content/uploads/2026/04/Spree-Commerce-Next.js-Storefront-PageSpeed-Lighthouse.webp" alt="Spree Commerce - Next.js Storefront - Lighthouse" width="400" /></a></td>
  41. </tr>
  42. </table>
  43. ### [Cross-border Commerce](https://spreecommerce.org/docs/developer/core-concepts/markets)
  44. [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.
  45. <img alt="Spree Commerce - Cross-border eCommerce" src="https://spreecommerce.org/wp-content/uploads/2024/07/multi-region-country-shopping-1024x575.webp" width="600" >
  46. ### [Multi-tenant SaaS](https://spreecommerce.org/docs/developer/multi-tenant/quickstart) <sup>Enterprise</sup>
  47. 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).
  48. ## Getting Started
  49. ### Try it in a sandbox
  50. 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.
  51. ### Install locally
  52. Copy and paste the following command to your terminal to set up Spree locally in 5 minutes:
  53. ```bash
  54. npx create-spree-app@latest my-store
  55. ```
  56. 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.
  57. You need Node.js 24+, Git and Docker running. The backend runs as a Docker image, and you can configure it entirely with [environment variables](https://spreecommerce.org/docs/developer/deployment/environment_variables). Learn more in the [installation docs](https://spreecommerce.org/docs/developer/getting-started/quickstart).
  58. ### Agentic Development
  59. 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 set up 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.
  60. ## Features
  61. Everything below ships in this repository under the BSD 3-Clause license.
  62. * **[REST API & TypeScript SDKs](https://spreecommerce.org/docs/api-reference/store-api/introduction)** — REST APIs for storefronts, admins and sellers, with publishable keys, scoped secret keys, rate limiting and OpenAPI 3.0 specs. Each has its own TypeScript SDK.
  63. * **[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 navigation](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.
  64. * **[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/)
  65. * **[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.
  66. * **[MCP Server](https://spreecommerce.org/docs/developer/mcp/overview)** — built into the backend. Connect Claude, ChatGPT, Cursor or any MCP client to manage your store in natural language, limited to the permissions you approve.
  67. * **[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.
  68. * **[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.
  69. * **[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).
  70. * **[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).
  71. * **[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).
  72. * **[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.
  73. * **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.
  74. * **[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).
  75. * **[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.
  76. * **[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).
  77. * **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)).
  78. * **[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.
  79. ## Deployment
  80. The Spree backend can be deployed anywhere — cloud, on-prem or VPS. We provide official Docker images (`ghcr.io/spree/spree`), 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.
  81. ## Community & Contributing
  82. Spree is an open-source project, and we love contributions in any form — pull requests, issues, feature ideas.
  83. * Follow our [Contributing Guide](https://spreecommerce.org/docs/developer/contributing/quickstart)
  84. * [Join our Discord](https://discord.spreecommerce.org) to meet other community members
  85. * 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)
  86. ## Spree Enterprise Edition
  87. 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.
  88. 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.
  89. 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.
  90. [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.
  91. ## License
  92. 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)).
  93. If you like what you see, consider giving Spree a GitHub star ⭐
  94. Thank you for supporting Spree open-source ❤️

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.