# spree/spree

Open Source eCommerce Platform for B2B, Marketplace, and Enterprise. REST API, TypeScript SDK, and production-ready Next.js storefront. Self-host it. Own your stack. No vendor lock-in. Zero platform fees.

Repository: https://github.com/spree/spree
Canonical: https://ross.abutalabs.com/products/spree
Homepage: https://spreecommerce.org
Language: Ruby
License: BSD-3-Clause
License Family: permissive
Topics: ecommerce, e-commerce, ecommerce-platform, spree-commerce, marketplace, multi-tenant, multi-vendor, multi-vendor-ecommerce, ecommerce-api, ecommerce-framework, open-source, headless, headless-commerce, headless-ecommerce, b2b-commerce
Last push: 2026-08-26T21:22:10+00:00

## Health v2 (maintenance only)
Score: 98/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 99, release rhythm 95, longevity 100
- inputs: {"age_days": 6750, "days_push": 7, "days_rel": 36, "gap_med": 6, "n_releases_24m": 56}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 15647, forks 5292 (observed 2026-08-28T04:11:13.252588+00:00)

## What it is
Spree Commerce is an open-source headless eCommerce platform written in Ruby, providing a complete REST API, TypeScript SDK, admin dashboard, and a production-ready Next.js storefront. It supports B2B, marketplace, multi-tenant, multi-store, and cross-border commerce scenarios and can be fully self-hosted with no platform fees.

## Use cases
- build a self-hosted online store without vendor lock-in or platform fees
- launch a multi-vendor marketplace with vendor sync and marketplace payments
- set up a B2B wholesale portal with custom pricing and buyer approvals
- create a headless commerce backend powering a mobile app or custom frontend
- run multiple brand stores from a single admin panel
- migrate away from a SaaS ecommerce platform to own your stack
- power a multi-region store with local currencies, languages, and taxes

## When to choose
- you need full ownership of your commerce code, data, and infrastructure
- you want a headless REST API with a TypeScript SDK and Next.js storefront out of the box
- you need B2B, marketplace, or multi-tenant capabilities in one platform
- you want to escape SaaS platform fees and limitations
- you are comfortable with Ruby/Rails backends and Docker-based deployment

## When to avoid
- you want a fully hosted, zero-maintenance SaaS solution
- your team has no Ruby/Rails experience and cannot maintain a Rails backend
- you need only a tiny storefront with minimal commerce features
- you require a specific niche feature available only in a proprietary platform

## Facets
- artifact type: framework
- maturity: stable
- function: api-framework, web-framework, http-server, sdk, cli, self-hosted
- domain: e-commerce, web-development, backend, apis, self-hosted
- platform: self-hosted, cross-platform
- tags: ecommerce, headless-commerce, marketplace, b2b, multi-vendor, multi-tenant, rest-api, typescript-sdk, nextjs-storefront, ruby-on-rails, shopping-cart, checkout, catalog-management, web-server, docker, nodejs

## Member repositories
- spree/spree (main) score 98

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:11:13.252588+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T17:05:35.976168+00:00, confidence not recorded.
  - readme: https://github.com/spree/spree (fetched 2026-08-28T04:11:13.252588+00:00, sha 6ca22d53d8dc)
  - homepage: https://spreecommerce.org (fetched 2026-08-29T08:03:44.386576+00:00, sha f76ff57073d9)
  - site_page: https://spreecommerce.org/docs (fetched 2026-08-29T08:03:44.409640+00:00, sha d4109fd765b1)
  - site_page: https://spreecommerce.org/features (fetched 2026-08-29T08:03:44.396804+00:00, sha 571ae3e3f05a)
  - site_page: https://spreecommerce.org/docs/developer/agentic/agent-skills (fetched 2026-08-29T08:03:44.403624+00:00, sha db995131fd83)
  - site_page: https://spreecommerce.org/docs/developer/cli/admin-api (fetched 2026-08-29T08:03:44.405716+00:00, sha acfa1cbf04da)
  - site_page: https://spreecommerce.org/docs/developer/agentic/mcp (fetched 2026-08-29T08:03:44.407875+00:00, sha cc0823fe46a0)
  - site_page: https://spreecommerce.org/docs/api-reference/store-api/introduction (fetched 2026-08-29T08:03:44.411225+00:00, sha d5817c2eb50d)
  - site_page: https://spreecommerce.org/integrations (fetched 2026-08-29T08:03:44.399735+00:00, sha b17266323041)
  - site_page: https://spreecommerce.org/use-cases/b2b-ecommerce-platform (fetched 2026-08-29T08:03:44.401629+00:00, sha 1ca46292bf47)
- Data as of 2026-08-30T08:39:29.467469+00:00.