Back to catalog
Spree Commerce
BSD-3-ClauseSpree Commerce is a self-hosted headless e-commerce platform that replaces hosted monoliths with a decoupled Next.js storefront and zero transaction fees.
Overview
Spree Commerce pairs a Ruby on Rails backend engine with a decoupled Next.js storefront for self-hosted headless e-commerce. Launched in 2008, the framework exposes a REST API and TypeScript SDK for multi-currency pricing, inventory control, and order fulfillment. By running on private infrastructure, it grants engineering teams direct control over checkout pipelines without transactional platform fees.
Where Spree Commerce fits
Hosted platforms like Shopify Plus and BigCommerce manage hosting and traffic surges, but enforce monthly subscriptions and percentage-based platform cuts on transaction volume. Proprietary headless engines like commercetools offer API flexibility while running inside vendor clouds that meter request volumes and prevent direct database access. Teams with strict data-residency rules or bespoke supply chains often find that commercial SaaS limits custom backend middleware and checkout logic.
Spree Commerce occupies the self-hosted operational tier for engineering teams that prioritize infrastructure control over convenience. Deploying Spree requires orchestrating Rails containers, PostgreSQL, Redis, and Sidekiq background workers on private clouds or Kubernetes clusters. This operational model trades variable vendor cuts for predictable compute bills, giving systems engineers direct SQL access, custom event publishers, and low-level checkout hooks that closed platforms forbid.
What it does well
- REST API and TypeScript SDK: typed endpoints and OpenAPI specs let frontend teams manage carts and checkouts without writing Ruby.
- Decoupled Next.js storefront: ships with an open-source React 19 and Next.js starter featuring server-side rendering, multi-region routing, and account portals.
- Multi-store architecture: runs multiple storefronts, localized currencies, regional tax rules, and stock locations from a single database.
- Command-line tooling: includes a terminal CLI to generate data models, run database migrations, and inspect store endpoints locally.
- Extensible payments: integrates directly with Stripe, Adyen, and PayPal, supported by an SDK for writing custom payment gateway adapters.
- Domain event bus: dispatches asynchronous events across orders, shipments, and customer updates to synchronize external ERPs and fulfillment pipelines.
