https://github.com/spree/spree

An open source eCommerce platform giving you full control and customizability. Modular and API-first. Multi-vendor, multi-tenant, multi-store, multi-currency, multi-language. Built using Ruby on Rails. Developed by @vendo-dev
https://github.com/spree/spree

cart e-commerce ecommerce ecommerce-api ecommerce-framework ecommerce-platform marketplace multi-tenant multi-vendor multi-vendor-ecommerce open-source rails ruby rubyonrails shop spree spree-commerce spreecommerce store white-label

Last synced: 27 days ago
JSON representation

An open source eCommerce platform giving you full control and customizability. Modular and API-first. Multi-vendor, multi-tenant, multi-store, multi-currency, multi-language. Built using Ruby on Rails. Developed by @vendo-dev

• Host: GitHub
• URL: https://github.com/spree/spree
• Owner: spree
• License: other
• Created: 2008-03-10T14:45:35.000Z (almost 18 years ago)
• Default Branch: main
• Last Pushed: 2025-10-05T21:00:37.000Z (5 months ago)
• Last Synced: 2025-10-05T23:18:32.884Z (5 months ago)
• Topics: cart, e-commerce, ecommerce, ecommerce-api, ecommerce-framework, ecommerce-platform, marketplace, multi-tenant, multi-vendor, multi-vendor-ecommerce, open-source, rails, ruby, rubyonrails, shop, spree, spree-commerce, spreecommerce, store, white-label
• Language: Ruby
• Homepage: https://spreecommerce.org
• Size: 187 MB
• Stars: 14,961
• Watchers: 81
• Forks: 5,155
• Open Issues: 216
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • Contributing: .github/CONTRIBUTING.md
  • License: license.md
  • Code of conduct: CODE_OF_CONDUCT.md
  • Security: SECURITY.md
  • Cla: .github/CLA.md

Awesome Lists containing this project

• awesome-ruby-toolbox - Spree - Spree is an open source e-commerce framework for Ruby on Rails. Join us on http://slack.spreecommerce.com (E-Commerce and Payments / Online Shops)
• awesome-opensource-apps - Spree
• Open-Source-Ruby-and-Rails-Apps - Spree - Spree is an open source E-commerce platform for Rails 6 with a modern UX, optional PWA frontend, REST API, GraphQL, several official extensions and 3rd party integrations. Over 1 million downloads and counting! 🔥 ✅ 🚀 (Happy Exploring 🤘)
• favorite-link - Spree 是一个完整的，模块化的，API 驱动的开源电子商务解决方案，适用于 Ruby on Rails。
• awesome-starred - spree/spree - Open Source multi-language/multi-currency/multi-store eCommerce platform (graphql)
• open-production-web-projects - Spree - E-commerce platform for Rails 6 with a modern UX, optional PWA frontend, REST API, GraphQL, several official extensions and 3rd party integrations. Over 1 million downloads and counting (Ruby / Ruby on Rails)
• awesome-ruby - Spree - A complete open source e-commerce solution for Ruby on Rails. (E-Commerce & Online Paying)
• awesome-opensource-apps - Spree - commerce Solution | [http://spreecommerce.com](http://spreecommerce.com) | (Rails)
• awesome-ruby - Spree - Spree is a complete open source e-commerce solution for Ruby on Rails. (E-Commerce and Payments)
• awesome-repositories - spree/spree - Spree Commerce is an API-first, open-source eCommerce platform for fast growing businesses and enterprises. Spree supports complex commerce scenarios natively — from B2B wholesale to multi-vendor mark (Ruby)
• awesome-github-star - spree - language/multi-currency/multi-store eCommerce platform | spree | 12387 | (Ruby)
• fucking-awesome-ruby - Spree - Spree is a complete open source e-commerce solution for Ruby on Rails. (E-Commerce and Payments)
• awesome-rails - spree - An open source e-commerce platform. [:red_circle:](https://rubygems.org/gems/spree) (Gems / Articles)
• awesome-ruby - Spree - Spree is a complete open source e-commerce solution for Ruby on Rails. (E-Commerce and Payments)

README

          


  

    

  

  
Spree Commerce - Open Source eCommerce Platform


  


    An open-source eCommerce platform giving you full control and customizability.

    


    Build any eCommerce solution that your business requires.

    


    


    Website

    ·

    Documentation

    ·

    Quickstart Guide    

    ·

    Roadmap

    ·

    Slack

    ·

    Enterprise

  




  

    

  

  

    

  



## Getting Started

Copy and paste the following command to your terminal to set up Spree in 5 minutes:

```bash

bash -c "$(curl -fsSL https://spreecommerce.org/install)"

```

If you prefer to install Spree manually, you may follow the [Quickstart Guide](https://spreecommerce.org/docs/developer/getting-started/quickstart).

Make sure to check out **Spree 5** announcement below and the latest [Spree 5.3 release](https://github.com/spree/spree/releases/tag/v5.3.0).

If you like what you see, consider giving Spree a GitHub star :star:

Thank you for supporting Spree open-source :heart:

## Documentation

- [Developer Docs](https://spreecommerce.org/docs/developer/getting-started/quickstart)

- [Ecommerce API](https://spreecommerce.org/docs/api-reference/introduction)

- [Integrations](https://spreecommerce.org/docs/integrations/integrations)

- [User Docs](https://spreecommerce.org/docs/user/what-is-spree-commerce)

- [Use Cases](https://spreecommerce.org/docs/use-case/overview)

## Spree 5 Announcement & Demo

[![Spree Commerce 5 version](https://vendo-production-res.cloudinary.com/image/upload/w_2000/q_auto/v1742985405/docs/github/Spree_Commerce_open-source_eCommerce_myzurl.jpg)](https://spreecommerce.org/announcing-spree-5-the-biggest-open-source-release-ever/)

[Spree 5](https://spreecommerce.org/announcing-spree-5-the-biggest-open-source-release-ever/) is the most feature-packed open-source release in Spree Commerce's history — transforming the platform into an API-first, developer-friendly, enterprise-grade eCommerce solution that still adheres to its open-source roots.

**Spree 5 packs a punch with:**

- **Admin Dashboard** — Completely new Admin Dashboard built with Tailwind CSS, Admin SDK with Tables DSL, staff management with role-based permissions

- **Pricing & Promotions** — Flexible Pricing Engine with regional/B2B/wholesale pricing out of the box, Customer Groups, Gift Cards, and enhanced Promotions UI

- **Products & Catalog** — Metafields for custom data without migrations, CSV importer/exporter, Digital products, Product Tags, Bulk operations UI

- **Checkout & Payments** — Stripe, Adyen, Payment Links, Wallet payments (Apple Pay/Google Pay), Buy Now Pay Later, Bank & SEPA payments

- **Integrations & Extensibility** — Event Bus with Subscribers, Webhooks 2.0 with admin UI, native integrations (Google Analytics 4, GTM, Klaviyo)

- **Developer Experience** — New CLI Installer, code generators, LSP editor integrations, Claude Code/Cursor AI integrations

Upcoming **Spree 5.4** expands the platform's reach to JavaScript developers with:

- **New REST API** — ~10x faster than API v2, built for simplicity and performance

- **TypeScript SDK** — First-class developer experience with full type safety

- **Next.js Starter Kit** — Production-ready headless storefront powered by the new API

Read the [full Spree 5.3 announcement here](https://spreecommerce.org/announcing-spree-commerce-5-3-with-price-lists-customer-groups-new-admin-tools/).

To install Spree check out this [Quickstart Guide](https://spreecommerce.org/docs/developer/getting-started/quickstart).

[View the latest Releases](https://github.com/spree/spree/releases) ·

[View the Roadmap](https://github.com/orgs/spree/projects) ·

[Get Enterprise Support](https://spreecommerce.org/get-started/)

## Enterprise support

[Contact us](https://spreecommerce.org/get-started/) for enterprise support and custom development services. We offer:

  * expert delivery of your Spree project,

  * migrations and upgrades,

  * optimizing your Spree stack.

## Enterprise Edition 

Besides enterprise support we also offer the Spree Commerce [Enterprise Edition](https://spreecommerce.org/spree-commerce-version-comparison-community-edition-vs-enterprise-edition/) that gives you all the tools you need to launch your store or marketplace and provides you with ready-to-use integrations that will reduce your project's development time and cost.

To get access to the Enterprise Edition, contact our [Sales team](https://spreecommerce.org/get-started/)

## Features

### Customizable and modular

  * pick and choose parts you want to use

  * customize everything else (storefront, order processing, API, etc)



### Composable and API-first

  * connect with your existing ecosystem, build custom workflows with ease

  * [Storefront and Admin API](https://spreecommerce.org/docs/api-reference/introduction)

  * Webhooks



### Cart and Checkout for any use case

  * advanced cart functionality

  * over 30 payment provider integrations out of the box

  * API to integrate any other payment gateway

  * robust discounts system

  * store credits, gift cards





### [Global Commerce](https://spreecommerce.org/multi-region-ecommerce/) ready

  * multi-currency

  * multi-language

  * full translation support for products, categories, and more

  * different shipping methods / costs for different regions

  * advanced tax calculation





### [Multi-Store eCommerce](https://spreecommerce.org/multi-store-ecommerce/) ready

  * host multiple brands / stores on a single Spree instance

  * each with different branding, configuration, payment methods, shipping options, product catalogs etc



### Responsive Admin Panel

Manage and curate products, users, orders, returns, shipments & more



### Orders & Post-purchase management

Manage orders, shipments, returns and refunds





### Why developers love it

* **Runs anywhere** - cloud, VPS, Docker, Kubernetes

* **Battle Tested** - used by thousands of merchants around the globe in all categories since 2007!

* **Extensions available** adding new features to Spree

## What you can build with Spree

Use Spree for any use case. Innovate beyond what's out there.

### [Headless eCommerce](https://spreecommerce.org/headless-ecommerce/) micro-service

Capture orders and payments for whatever you're selling - physical or digital, products or services



### [Multi-vendor marketplace](https://spreecommerce.org/marketplace-ecommerce/)

Run your own marketplace with multiple suppliers, each with a dedicated supplier dashboard

- [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)



### [B2B eCommerce](https://spreecommerce.org/use-cases/headless-b2b-ecommerce/)

Start capturing 6+ figure orders from resellers with safe payments and a checkout process that fits your business model

- [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)



### [Wholesale eCommerce](https://spreecommerce.org/use-cases/wholesale-ecommerce/)

Run your wholesale operation the way your retail partners expect



### [Multi-tenant eCommerce Platform](https://spreecommerce.org/multi-tenant-white-label-ecommerce/)

Launch a multi-tenant eCommerce platform for your customers, resellers, affiliates in any configuration, eg. B2B2B, B2B2C, B2B2E

- [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)



## Community & Contributing

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 Slack](https://slack.spreecommerce.org) to meet other community members.

## Contact

[Contact us](https://spreecommerce.org/get-started/) and let's go! 

## Developed by

Spree is developed and maintained by







> Vendo is the commercial entity behind Spree Commerce and in particular the latest, unprecedented investment into Spree 5 and following versions as well as its integrations. We've been the Spree core team since 2016 and led numerous Spree projects while supporting the community. Learn more at: https://www.getvendo.com/

## License

Spree Commerce is a free, open-source eCommerce framework giving you full control and customizability.

For Spree Commerce versions 4.10 and later in the [spree/spree](https://github.com/spree/spree) repository two licenses apply simultaneously and users are required to comply with the terms of these two licenses at the same time:

* [AGPL-3.0](https://opensource.org/license/agpl-v3) - for all contributions from version 4.10 onwards

* [BSD-3-Clause](https://opensource.org/license/bsd-3-clause) - for all other contributions predating version 4.10

Effectively, for versions 4.10 and upwards **AGPL-3.0** license applies.

Spree Commerce versions 4.9 and earlier in the [spree/spree](https://github.com/spree/spree) repository are available under the BSD-3-Clause license and users are required to comply with its terms.

Please note:

* [Spree under AGPLv3 may be used privately](https://spreecommerce.org/spree-under-agplv3-may-be-used-privately/) 

* [Spree Commerce Developer Covenant](https://spreecommerce.org/spree-commerce-developer-covenant/) 

If you’d like to use Spree Commerce without the AGPL-3.0 restrictions e.g. for a SaaS business, please talk to us about obtaining a [Commercial License](https://github.com/spree/spree/blob/main/license.md#commercial-license).

All third party components incorporated into this software are licensed under the original license provided by the owner of the applicable component.

Please refer to our [Licensing FAQ](https://spreecommerce.org/why-spree-is-changing-its-open-source-license-to-agpl-3-0-and-introducing-a-commercial-license/) in case of questions

If you like what you see, consider giving Spree a GitHub star :star:

Thank you for supporting Spree open-source :heart: