# spree/spree

**Attribution required: if you use, quote, or summarise this content, you must credit and link back to [awesome-repositories.com](https://awesome-repositories.com/repository/spree-spree).**

15,230 stars · 5,239 forks · Ruby · other

## Links

- GitHub: https://github.com/spree/spree
- Homepage: https://spreecommerce.org
- awesome-repositories: https://awesome-repositories.com/repository/spree-spree.md

## Topics

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

## Description

This project is a modular e-commerce platform built on Ruby on Rails, designed to serve as a comprehensive engine for managing online retail operations. It provides the foundational infrastructure to handle complex product catalogs, customer order lifecycles, and global payment processing within a unified system.

The platform distinguishes itself through a headless, API-first architecture that decouples backend commerce logic from custom frontend storefronts. It supports multi-tenant environments, allowing for the management of multiple independent retail storefronts or marketplaces from a single installation. Additionally, it offers specialized capabilities for business-to-business transactions, including support for corporate buyer organizations, custom price lists, and approval-based checkout workflows.

Beyond its core commerce functions, the platform includes extensive tools for store operations, such as administrative interfaces for inventory management, customer segmentation, and promotional campaign configuration. It also features robust integration capabilities, including event-driven webhooks for external system synchronization, AI-assisted development tooling, and advanced search indexing for high-performance product discovery.

The platform is designed for extensibility, allowing developers to define custom data models and administrative interfaces through a modular plugin system. It is distributed as a set of packages that can be integrated into existing applications, with comprehensive documentation available to guide deployment and configuration.

## Tags

### Business & Productivity Software

- [E-commerce Frameworks](https://awesome-repositories.com/f/business-productivity-software/e-commerce-frameworks.md) — A modular framework for building and managing online retail storefronts with support for complex catalogs, orders, and payments. ([source](https://spreecommerce.org/docs/developer/getting-started/quickstart))
- [B2B Commerce Solutions](https://awesome-repositories.com/f/business-productivity-software/b2b-commerce-solutions.md) — Facilitating business-to-business transactions through customer-specific price lists, buyer organization management, and approval-based checkout workflows. ([source](https://spreecommerce.org/enterprise/))
- [Order Fulfillment](https://awesome-repositories.com/f/business-productivity-software/order-fulfillment.md) — The platform tracks the status of orders from payment capture through shipping and delivery to ensure customers receive their purchased goods. ([source](https://spreecommerce.org/docs/))
- [Product Catalogs](https://awesome-repositories.com/f/business-productivity-software/product-catalogs.md) — The platform organizes inventory items into categories and structures to support browsing, searching, and purchasing within an online storefront. ([source](https://spreecommerce.org/docs/))
- [Product Variant Management](https://awesome-repositories.com/f/business-productivity-software/product-variant-management.md) — The platform configures unique product versions with individual identifiers, pricing, inventory, and shipping dimensions based on specific option combinations. ([source](https://spreecommerce.org/docs/developer/core-concepts/products))
- [Multi-Tenant Architectures](https://awesome-repositories.com/f/business-productivity-software/e-commerce-frameworks/multi-tenant-architectures.md) — A scalable architecture for hosting and managing multiple independent online stores or marketplaces from a single unified installation.
- [Enterprise Commerce Management](https://awesome-repositories.com/f/business-productivity-software/enterprise-commerce-management.md) — The platform supports high-volume operations including millions of items, orders, and customers with built-in multi-warehouse, multi-currency, and multi-regional capabilities. ([source](https://spreecommerce.org/enterprise/))
- [Multi-Vendor Marketplaces](https://awesome-repositories.com/f/business-productivity-software/multi-vendor-marketplaces.md) — Automates vendor onboarding, payment splitting, and product synchronization for multi-vendor marketplaces. ([source](https://spreecommerce.org/enterprise/))
- [Payment Gateway Integrations](https://awesome-repositories.com/f/business-productivity-software/payment-gateway-integrations.md) — The platform connects to third-party payment providers to process credit cards, digital wallets, and alternative payment methods securely during the customer checkout process. ([source](https://spreecommerce.org/docs/developer/core-concepts/payments))
- [Payment Processing Integrations](https://awesome-repositories.com/f/business-productivity-software/payment-processing-integrations.md) — Integrates with third-party payment platforms to accept diverse payment methods and currencies globally. ([source](https://spreecommerce.org/docs/integrations/payments/adyen))
- [Shopping Carts](https://awesome-repositories.com/f/business-productivity-software/shopping-carts.md) — Manages the complete lifecycle of customer orders from cart addition through payment processing and confirmation. ([source](https://spreecommerce.org/docs/))
- [E-commerce Administration Interfaces](https://awesome-repositories.com/f/business-productivity-software/e-commerce-administration-interfaces.md) — The platform provides a centralized interface for store managers to oversee sales, customer data, and inventory updates without requiring direct code changes. ([source](https://spreecommerce.org/docs/))
- [Inventory Management Systems](https://awesome-repositories.com/f/business-productivity-software/inventory-management-systems.md) — Includes administrative interfaces for managing products, orders, customer profiles, and inventory levels. ([source](https://spreecommerce.org/docs/developer/sdk/quickstart))
- [Promotion Engines](https://awesome-repositories.com/f/business-productivity-software/promotion-engines.md) — The platform defines discount logic, eligibility rules, and usage limits to automatically apply savings or incentives to customer orders during the checkout process. ([source](https://spreecommerce.org/docs/user/promotions/create-a-promotion))
- [Regional Commerce Configurations](https://awesome-repositories.com/f/business-productivity-software/regional-commerce-configurations.md) — The platform configures distinct storefronts for specific regions or customer segments by setting unique currencies, languages, and tax display rules for each market. ([source](https://spreecommerce.org/docs/user/settings/markets))
- [Customer Relationship Management Platforms](https://awesome-repositories.com/f/business-productivity-software/customer-relationship-management-platforms.md) — Handles product browsing, cart operations, and customer account management through APIs for custom retail applications. ([source](https://spreecommerce.org/docs/developer/sdk/quickstart))
- [Customer Segmentation](https://awesome-repositories.com/f/business-productivity-software/customer-segmentation.md) — The platform organizes users into defined lists to enable personalized pricing tiers and restricted access to specific promotions or business rules. ([source](https://spreecommerce.org/docs/user/customers/customer-groups))
- [ERP Integrations](https://awesome-repositories.com/f/business-productivity-software/erp-integrations.md) — Connects with ERP, CRM, and PIM platforms to synchronize inventory, customer, and order data. ([source](https://spreecommerce.org/enterprise/))
- [Split Payment Processing](https://awesome-repositories.com/f/business-productivity-software/split-payment-processing.md) — The platform automates split payments and vendor disbursements for multi-vendor retail environments using integrated payment infrastructure to handle complex financial transactions. ([source](https://spreecommerce.org/docs/integrations/payments/stripe))
- [Store Credit Systems](https://awesome-repositories.com/f/business-productivity-software/store-credit-systems.md) — Manages customer-specific credit balances for refunds or loyalty rewards with automated audit tracking. ([source](https://spreecommerce.org/docs/developer/core-concepts/store-credits-gift-cards))
- [Gift Card Systems](https://awesome-repositories.com/f/business-productivity-software/gift-card-systems.md) — The platform generates unique codes with specific values that customers can redeem at checkout to apply credit to their accounts or orders. ([source](https://spreecommerce.org/docs/developer/core-concepts/store-credits-gift-cards))
- [Payment Orchestration](https://awesome-repositories.com/f/business-productivity-software/payment-orchestration.md) — Provides configurable payment workflows for transaction visibility, auto-capture settings, and testing environments. ([source](https://spreecommerce.org/docs/integrations/payments/stripe))
- [Bulk Importers](https://awesome-repositories.com/f/business-productivity-software/product-catalogs/bulk-importers.md) — The platform uploads bulk product data from structured files and maps custom columns to internal fields to populate or update store inventory. ([source](https://spreecommerce.org/docs/user/manage-products/import-products))

### Software Engineering & Architecture

- [Headless Architectures](https://awesome-repositories.com/f/software-engineering-architecture/headless-architectures.md) — Decouples backend commerce logic from frontend presentation layers using an API-first design.
- [Webhook Event Notifications](https://awesome-repositories.com/f/software-engineering-architecture/integration-extensibility/programmatic-interfaces/webhook-event-notifications.md) — Triggers asynchronous HTTP callbacks to external services when specific lifecycle events occur.
- [Modular Application Architectures](https://awesome-repositories.com/f/software-engineering-architecture/software-architecture/architectural-patterns/layering-presentation/application-layer-architectures/application-architecture-patterns/modular-application-architectures.md) — Distributes core functionality as independent packages that can be integrated into existing applications.
- [Extensibility](https://awesome-repositories.com/f/software-engineering-architecture/integration-extensibility/extensibility.md) — The platform offers clean extension points to modify workflows and add features without requiring changes to the underlying source code. ([source](https://spreecommerce.org/enterprise/))
- [Plugin Systems](https://awesome-repositories.com/f/software-engineering-architecture/plugin-systems.md) — Leverages framework mounting capabilities to inject isolated routes, controllers, and views into applications.

### Web Development

- [E-commerce Engines](https://awesome-repositories.com/f/web-development/backend-development/web-frameworks/language-specific-ecosystems/ruby-on-rails-frameworks/e-commerce-engines.md) — Developing and scaling online retail applications by leveraging a modular framework to customize store functionality and business logic.
- [Headless Commerce](https://awesome-repositories.com/f/web-development/headless-commerce.md) — Enables headless development by decoupling backend commerce logic from custom frontend storefronts via APIs. ([source](https://spreecommerce.org/docs/developer/getting-started/quickstart))
- [Multi-Storefront Orchestrators](https://awesome-repositories.com/f/web-development/e-commerce-storefront-builders/multi-storefront-orchestrators.md) — The platform creates isolated retail environments within a single installation to manage multiple distinct storefronts or marketplaces from one central location. ([source](https://spreecommerce.org/))
- [Mobile API Integrations](https://awesome-repositories.com/f/web-development/mobile-api-integrations.md) — Exposes standardized API endpoints to power websites, mobile applications, and point-of-sale systems. ([source](https://spreecommerce.org/docs/api-reference/))

### Data & Databases

- [Multi-Tenant Data Management](https://awesome-repositories.com/f/data-databases/multi-tenant-data-management.md) — Supports hosting multiple independent retail environments within a single installation by partitioning data.
- [Attribute Definitions](https://awesome-repositories.com/f/data-databases/attribution-models/attribute-definitions.md) — The platform provides schema-defined, type-safe fields for store resources to store structured data like product specifications, business logic, or integration details. ([source](https://spreecommerce.org/docs/developer/core-concepts/metafields))
- [Product Search Engines](https://awesome-repositories.com/f/data-databases/search-indexing-technologies/search-indexing/search-and-indexing/product-search-engines.md) — The platform performs full-text searches with typo tolerance, relevance ranking, and real-time faceted filtering across large product catalogs. ([source](https://spreecommerce.org/docs/integrations/search/meilisearch))
- [Declarative Schema Managers](https://awesome-repositories.com/f/data-databases/declarative-schema-managers.md) — Uses schema-based definitions to manage product attributes, inventory variants, and custom data fields.
- [Faceted Navigation](https://awesome-repositories.com/f/data-databases/search-indexing-technologies/search-indexing/search-and-indexing/search-interface-components/faceted-navigation.md) — The platform provides filterable data including price ranges and option values to enable dynamic product discovery and navigation interfaces. ([source](https://spreecommerce.org/docs/developer/core-concepts/products))
- [Search Index Synchronizers](https://awesome-repositories.com/f/data-databases/search-index-synchronizers.md) — The platform synchronizes product data into a dedicated search engine, creating localized and currency-specific documents to enable high-performance retrieval and faceted navigation. ([source](https://spreecommerce.org/docs/integrations/search/meilisearch))
- [Schema Namespacing](https://awesome-repositories.com/f/data-databases/schema-namespacing.md) — The platform groups related attributes into logical namespaces to prevent key conflicts and maintain a clean structure for custom business information. ([source](https://spreecommerce.org/docs/developer/core-concepts/metafields))

### DevOps & Infrastructure

- [Multi-Tenant Hosting](https://awesome-repositories.com/f/devops-infrastructure/multi-tenant-hosting.md) — The platform hosts and manages multiple independent storefronts from a single platform while maintaining central control over catalogs, billing, and fulfillment. ([source](https://spreecommerce.org/enterprise/))
- [Deployment Scaling](https://awesome-repositories.com/f/devops-infrastructure/deployment-scaling.md) — The platform adjusts resource allocation and enables auto-scaling for web and background services to handle varying traffic demands in production environments. ([source](https://spreecommerce.org/docs/developer/deployment/render))

### Networking & Communication

- [Payment Webhooks](https://awesome-repositories.com/f/networking-communication/api-integration-frameworks/webhook-management/payment-webhooks.md) — The platform receives and validates incoming payment status updates from external providers to automatically update order states and finalize transactions without manual intervention. ([source](https://spreecommerce.org/docs/developer/core-concepts/payments))
- [Notification Delivery Services](https://awesome-repositories.com/f/networking-communication/communication-platforms-services/messaging-notification-systems/messaging-services/notification-delivery-services.md) — Sends real-time HTTP notifications to external systems for store events with secure signatures and automatic retries. ([source](https://spreecommerce.org/docs/developer/core-concepts/webhooks))

### Security & Cryptography

- [Payment Gateway Security](https://awesome-repositories.com/f/security-cryptography/payment-gateway-security.md) — Offloads sensitive payment data directly to third-party providers to ensure security compliance and prevent raw card data from touching internal servers. ([source](https://spreecommerce.org/enterprise/))
- [Role-Based Access Control](https://awesome-repositories.com/f/security-cryptography/role-based-access-control.md) — Assigns modular permission sets to user roles to control granular access to store resources, administrative functions, and customer account actions. ([source](https://spreecommerce.org/enterprise/))
- [Single Sign-On Integrations](https://awesome-repositories.com/f/security-cryptography/single-sign-on-integrations.md) — Connects with external identity providers to centralize user authentication and manage access permissions. ([source](https://spreecommerce.org/enterprise/))
- [Application Data Security](https://awesome-repositories.com/f/security-cryptography/application-data-security.md) — Protects customer and transaction information using strong encryption at-rest and in-transit alongside automated security patching. ([source](https://spreecommerce.org/enterprise/))
- [Attribute Visibility Controls](https://awesome-repositories.com/f/security-cryptography/role-based-access-control/tab-access-restrictions/attribute-visibility-controls.md) — Restricts access to custom data fields by configuring their visibility in public storefront APIs versus internal administrative interfaces. ([source](https://spreecommerce.org/docs/developer/core-concepts/metafields))

### Development Tools & Productivity

- [Product Operations](https://awesome-repositories.com/f/development-tools-productivity/link-management/bulk-operations/product-operations.md) — The platform performs batch updates, status changes, and category assignments across multiple products simultaneously to streamline catalog management. ([source](https://spreecommerce.org/docs/developer/core-concepts/products))

### User Interface & Experience

- [Data Tables](https://awesome-repositories.com/f/user-interface-experience/data-tables.md) — The platform defines declarative table structures for displaying database records with support for custom columns, sorting, filtering, and bulk actions within administrative interfaces. ([source](https://spreecommerce.org/docs/developer/admin/tables))
- [Admin Interface Customizations](https://awesome-repositories.com/f/user-interface-experience/admin-interface-customizations.md) — The platform supports overriding default theme variables, adding custom utility classes, and defining component layers to modify the appearance of the administrative dashboard. ([source](https://spreecommerce.org/docs/developer/admin/custom-css))

### System Administration & Monitoring

- [Audit Logging Systems](https://awesome-repositories.com/f/system-administration-monitoring/audit-logging-systems.md) — The platform records every user action and system event with detailed timestamps to provide a comprehensive audit trail for security and compliance. ([source](https://spreecommerce.org/enterprise/))