# spree

**Repository Path**: mirrors/spree

## Basic Information

- **Project Name**: spree
- **Description**: Spree一款采用Ruby on Rails开发的开源商城，兼容Rails 2.1，它作为独立的一个软件发布，可扩展，还包括完整的数据模型和管理界面
- **Primary Language**: Ruby
- **License**: BSD-3-Clause
- **Default Branch**: main
- **Homepage**: https://www.oschina.net/p/spree
- **GVP Project**: No

## Statistics

- **Stars**: 2
- **Forks**: 3
- **Created**: 2020-05-19
- **Last Updated**: 2025-10-18

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

<p align="center">
  <a href="https://spreecommerce.org">
    <img alt="Spree Commerce - an open source eCommerce platform" src="https://github.com/spree/spree/assets/12614496/ff5372a4-e906-458e-83b6-7927ba0629c1">
  </a>

  <h1 align="center">Spree Commerce</h2>

  <p align="center">
    An <a href="https://spreecommerce.org/" alt="open-source eCommerce platform">open-source eCommerce platform</a> giving you full control and customizability.
    <br />
    Build any eCommerce solution that your business requires.
    <br />
    <br />
    <a href="https://spreecommerce.org/announcing-spree-5-the-biggest-open-source-release-ever/">Spree 5</a>
    ·
    <a href="https://spreecommerce.org">Website</a>
    ·
    <a href="https://spreecommerce.org/docs/">Documentation</a>
    ·
    <a href="https://slack.spreecommerce.org">Slack</a>
    ·
    <a href="https://github.com/spree/spree_starter/">Starter</a>
    ·
    <a href="https://demo.spreecommerce.org">Demo</a>
    ·
    <a href="https://spreecommerce.org/pricing/">Pricing</a>
    ·
    <a href="https://github.com/spree/spree/milestones?direction=asc&sort=due_date&state=open">Roadmap</a>
  </p>
</p>

<p align="center">
  <a href="https://rubygems.org/gems/spree">
    <img alt="Gem Total Downloads" src="https://img.shields.io/gem/dt/spree" />
  </a>
  <a href="https://slack.spreecommerce.org">
    <img alt="Slack members" src="https://img.shields.io/badge/slack%20members-7K-blue" />
  </a>
</p>

## Getting Started

Visit the [Quickstart Guide](https://spreecommerce.org/docs/developer/getting-started/quickstart) to set up Spree in 5 minutes.

Make sure to check out the latest [Spree 5 release announcement](https://github.com/spree/spree#spree-5-announcement--demo) and demo.

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

We’re thrilled to unveil [Spree 5](https://spreecommerce.org/announcing-spree-5-the-biggest-open-source-release-ever/
) — the most powerful and feature-packed open-source release in Spree Commerce’s history, including:
- A completely revamped Admin Dashboard experience: boost your team's productivity 
- A Mobile-First, No-code Customizable Storefront: raise conversions and loyalty
- New integrations: a native [Stripe integration](https://github.com/spree/spree_stripe), and also Stripe Connect, Klaviyo integrations available with the Enterprise Edition
- Enterprise Edition Admin Features: Audit Log, [Multi-Vendor Marketplace eCommerce](https://spreecommerce.org/marketplace-ecommerce/) module, [Multi-tenant / White-label SaaS eCommerce](https://spreecommerce.org/multi-tenant-white-label-ecommerce/) module, [B2B eCommerce](https://spreecommerce.org/use-cases/headless-b2b-ecommerce/) module 

Read the [full Spree 5 announcement here](https://spreecommerce.org/announcing-spree-5-the-biggest-open-source-release-ever/).

Check out the [Spree 5 demo](https://demo.spreecommerce.org/) for yourself.

## Enterprise support

[Contact us](https://spreecommerce.org/get-started/) for enterprise support and custom development services. We offer:
  * expert delivery of your Spree application,
  * 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)
<img alt="Spree Commerce - Storefront customization" src="https://github.com/spree/spree/assets/12614496/1a000452-6716-4fab-90ca-a4c28fc138a7">

### 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
<img alt="Spree Commerce - API   Integrations" src="https://github.com/spree/spree/assets/12614496/18e98e8e-15cd-4b74-8e58-80e5b3f281d8">

### 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
<img alt="Spree Commerce - Cart   Checkout" src="https://github.com/spree/spree/assets/12614496/05399a8f-a57a-4907-a8ea-a4e58285a55d">
<img alt="Spree Commerce - Payments   Refunds" src="https://github.com/spree/spree/assets/12614496/0911073c-a681-409e-810c-f7e8daa4daac">

### [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
<img alt="Spree Commerce - Multi-region   Multi-store" src="https://github.com/spree/spree/assets/12614496/e9c2edce-b80c-47ad-817b-a00a4ba54495">
<img alt="Spree Commerce - Multi-region" src="https://github.com/spree/spree/assets/12614496/f8678baf-4efa-4de7-b092-b01ef3a4d8ea">

### [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
<img alt="Spree Commerce - Multi-store" src="https://github.com/spree/spree/assets/12614496/cf651354-6180-4927-973f-c650b80ccdb0">

### Responsive Admin Panel
Manage and curate products, users, orders, returns, shipments & more
<img alt="Spree Commerce - Inventory management" src="https://github.com/spree/spree/assets/12614496/cdc7af4d-41ba-44f2-9595-efc948865107">

### Orders & Post-purchase management
Manage orders, shipments, returns and refunds
<img alt="Spree Commerce - Order   Return management" src="https://github.com/spree/spree/assets/12614496/b1dffa8c-24d4-4629-a026-02951b5a80d7">
<img alt="Spree Commerce - Order Fulfillment" src="https://github.com/spree/spree/assets/12614496/2212ec6d-bfd0-4940-9aae-f0ceea0b4e4d">

### 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
<img alt="Spree Commerce - headless open-source eCommerce" src="https://github.com/spree/spree/assets/12614496/2bca9fdf-5ae2-4433-83aa-431105906fc8">

### [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)
<img alt="Spree Commerce - Marketplace" src="https://github.com/spree/spree/assets/12614496/c4ddd118-df4c-464e-b1fe-d43862e5cf25">

### [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)
<img alt="Spree Commerce - B2B eCommerce" src="https://github.com/spree/spree/assets/12614496/e0a184f6-31ad-4f7f-b30b-6f8a501b6f63">

### [Wholesale eCommerce](https://spreecommerce.org/use-cases/wholesale-ecommerce/)
Run your wholesale operation the way your retail partners expect
<img alt="Spree Commerce - Wholesale" src="https://github.com/spree/spree/assets/12614496/bac1e551-f629-47d6-a983-b385aa65b1bd">

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

<img alt="Spree Commerce - Multi-store" src="https://github.com/spree/spree/assets/12614496/cf651354-6180-4927-973f-c650b80ccdb0">

## 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/contact/) and let's go! 

## Developed by

Spree is developed and maintained by

<a href="https://getvendo.com">
<img alt="Vendo" src="https://avatars.githubusercontent.com/u/89416582?s=96&v=4" />
</a>

> 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: