Spree Commerce

Spree Commerce is an open-source, headless e-commerce platform built on Ruby on Rails that lets self-hosters build B2B, marketplace, and enterprise online…

  • Business & Finance
Spree Commerce is an open-source, headless e-commerce platform built on Ruby on Rails that lets self-hosters build B2B, marketplace, and enterprise online stores using REST APIs, a TypeScript SDK, a React admin dashboard, and a production-ready Next.js storefront — with no platform fees under the BSD 3-Clause license.

Platform availability

Available on 1 of 10 platforms

  • Unraid (not listed)
  • TrueNAS (not listed)
  • Umbrel (not listed)
  • ZimaOS (not listed)
  • Proxmox (not listed)
  • Helm (not listed)
  • Mac (not listed)
  • Windows (not listed)
  • Linux (not listed)
  • Any server

Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.

78/100 Good

Maintained
100last commit 1 day ago
Popular
8415,848 GitHub stars
Easy to install
251 install platform, install notes
Light to run
No data

Based on 3 of 4 factors.

Availability: platform listings confirmed today

GitHub stars
15,848
Open issues
226
Last commit
2026-11-20
Latest release
v6.0.5
License
BSD-3-Clause
Activity
declining

Checked today - source: GitHub (spree/spree)

Resources & Compatibility

Requirements not published yet.

Checked today - source: Docker Hub image tags and published docs

First-install notes

  • Run the first-time setup command In your Spree project folder, run spree init so it starts the Docker services, seeds the database, and creates an API key. Without this, the app has no database or API key and won't work for stores or admins. source
  • Create the storefront environment file If you added a storefront app, copy .env.local.example to .env.local, then add your Spree API key there so the store can talk to the backend. Without this, the storefront cannot find products or settings. source
  • Start the storefront separately Open a second terminal, go to my-store/apps/storefront, and run pnpm dev to start the local storefront website at http://localhost:3001. If you skip this, the backend may be running but there is no public store page to open. source

Fetched today - each note links to its source

Alternatives (9)

  • Etsy - Marketplace for handmade, vintage, and unique items offering direct sales from independent creators worldwide, including crafts, art, and d…
  • LiteCart - Lightning fast e-commerce platform built in PHP.
  • Medusa - Medusa is an automatic video library manager for TV shows.
  • OpenCart - OpenCart is a free open-source PHP e-commerce platform that lets merchants, homelab admins, and store owners create and manage online store…
  • Payhip - Platform simplifies sales of digital products like ebooks, courses, and coaching services.
  • PrestaShop - PrestaShop is an open-source e-commerce free software powering nearly 200,000 online stores.
  • Sell.app - Sell.app is the easiest way to sell digital products online.
  • Shopify - A cloud-based e-commerce platform offering customizable online store creation, channel sales, inventory management, secure payments, and sh…
  • WooCommerce - Open-source ecommerce platform supporting physical and digital sales, customizable storefronts, booking and subscription features, and wide…

Checked today - source: AlternativeTo

Common questions

How do I initialize a local Spree backend with a database and API key?

Run spree init in your Spree project folder to start the Docker services, seed the database, and create an API key. If you skip this, the app has no database or API key for stores or admins.

How do I point the Next.js storefront at the Spree backend?

Copy .env.local.example to .env.local and add your Spree API key there so the store can talk to the backend. Without this, the storefront cannot find products or settings.

Do I need to start the storefront separately during local development?

Yes, open a second terminal, go to my-store/apps/storefront, and run pnpm dev to start the local storefront at localhost:3001. If you skip this, the backend may be running but there is no public store page to open.

Can I build a mobile app that uses the same Spree backend?

Yes, Spree provides REST APIs that allow mobile app developers to build commerce experiences against a shared backend.

Can I manage the store with an AI agent or MCP interface?

Spree ships with an MCP server that can manage the store via chat. It also includes agent skills for coding agents.

Answers sourced from en.wikipedia.org, github.com, github.com, github.com, github.com

Community

Collected today - public community threads