spree 5.3.4 → 5.4.0.beta

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 89ca67fa503163f20064070751285b4f3f4cd30481147258846321a9b0b45c72
-  data.tar.gz: 04d8fe1a55ebfc40e3de183448b6709d5f34a4511156439f7788c512b2d547f6
+  metadata.gz: 44ce0b3fe4816c312c053f46ca86715d0815ff8e54d120de37268dd5190da959
+  data.tar.gz: 459730d812120edb28d4dc404a5df4b24e65cd1e65dc309f50bfaef4aaee6dab
 SHA512:
-  metadata.gz: 2a7e985545a7e9ea30202e2294ea126c3501d15da823ba17c45ea69230e08ef37e712396abbcb4f228ebea5dc0caa1b50a6144a059afa7d3f2debe94abcbb757
-  data.tar.gz: ab8a62f06ab8c973b9564af5bb2ef68d031ecbef59d4b8676fd61b3978cafcb75c2276e882be1a36a69cc467735c32a8e7da278d11e3790b5ee7e320e7e9100e
+  metadata.gz: 84b5eb3b2e9c18a283c4b84d5412a2d6781ac252666482ef5b68de6df2c7f5cfa9aa005ebede18792477ff1db572641fb56d5010e68f368a9aee0eac1e6c7803
+  data.tar.gz: d916840bce93ea23bcfcdc39384b95b3425748ab323eb3c64bc4bfedfb98b4110eab3fb2aca731f7c2e91cd9d4430e8436b51f100d00b8b8adf0963b17748c6c

data/README.md

@@ -1,235 +1,102 @@
-<p align="center">
-  <a href="https://spreecommerce.org">
-    <img alt="Spree Commerce - an open source eCommerce platform" src="https://raw.githubusercontent.com/spree/spree/e4ee6636d9a31c73761b0c76662d15b0f9899ecb/docs/images/Spree%20Commerce%20open-source%20eCommerce%20platform%20API%20headless%20Next.js.webp">
-  </a>
-
-  <h1 align="center">Spree Commerce - Open Source eCommerce Platform</h1>
-
-  <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">Website</a>
-    ·
-    <a href="https://spreecommerce.org/docs/">Documentation</a>
-    ·
-    <a href="https://spreecommerce.org/docs/developer/getting-started/quickstart">Quickstart Guide</a>    
-    ·
-    <a href="https://github.com/spree/spree/milestones?direction=asc&sort=due_date&state=open">Roadmap</a>
-    ·
-    <a href="https://slack.spreecommerce.org">Slack</a>
-    ·
-    <a href="https://spreecommerce.org/enterprise/">Enterprise</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
-
-Copy and paste the following command to your terminal to set up Spree in 5 minutes:
+# Spree
 
-```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)
-<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">
+Ruby gems that power Spree Commerce — models, services, APIs, admin dashboard, and transactional emails.
 
-### 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">
+## Structure
 
-### 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">
+```
+spree/
+├── core/               # spree_core — models, services, business logic
+├── api/                # spree_api — REST APIs (Store API + Admin API)
+├── admin/              # spree_admin — admin dashboard
+├── emails/             # spree_emails — transactional emails (optional)
+├── spree.gemspec       # meta-gem (installs core + api)
+├── template.rb         # Rails application template for new projects
+├── Gemfile             # shared dependencies for development/testing
+├── Rakefile            # gem build, test, and release tasks
+└── lib/                # shared generators
+```
 
-## Community & Contributing
+## Installation
 
-Spree is an open source project and we love contributions in any form - pull requests, issues, feature ideas!
+Add to your Rails application's Gemfile:
 
-Follow our [Contributing Guide](https://spreecommerce.org/docs/developer/contributing/quickstart)
+```ruby
+gem 'spree'
+gem 'spree_admin'   # optional
+gem 'spree_emails'  # optional
+```
 
-[Join our Slack](https://slack.spreecommerce.org) to meet other community members.
+Or use the Rails application template:
 
-## Contact
+```bash
+rails new my_store -m https://raw.githubusercontent.com/spree/spree/main/spree/template.rb
+```
 
-[Contact us](https://spreecommerce.org/get-started/) and let's go! 
+## Running Tests
 
-## Developed by
+Each gem has its own test suite. First install the shared dependencies, then set up the specific gem:
 
-Spree is developed and maintained by
+```bash
+# 1. Install shared dependencies (required once)
+cd spree
+bundle install
+
+# 2. Set up and run tests for a specific gem (e.g. core)
+cd core
+bundle install
+bundle exec rake test_app   # generates a dummy Rails app for testing
+bundle exec rspec
+```
 
-<a href="https://getvendo.com">
-<img alt="Vendo" src="https://avatars.githubusercontent.com/u/89416582?s=96&v=4" />
-</a>
+Replace `core` with `api`, `admin`, or `emails` to test other gems.
 
-> 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/
+By default tests run against SQLite3. To use PostgreSQL:
 
-## License
+```bash
+DB=postgres DB_USERNAME=postgres DB_PASSWORD=password DB_HOST=localhost bundle exec rake test_app
+```
 
-Spree Commerce is a free, open-source eCommerce framework giving you full control and customizability.
+Run a single spec:
 
-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:
+```bash
+cd spree/core
+bundle exec rspec spec/models/spree/product_spec.rb
+bundle exec rspec spec/models/spree/product_spec.rb:42
+```
 
-* [AGPL-3.0](https://opensource.org/license/agpl-v3) - for all contributions from version 4.10 onwards
+### Parallel tests
 
-* [BSD-3-Clause](https://opensource.org/license/bsd-3-clause) - for all other contributions predating version 4.10
+```bash
+cd spree/core
+bundle exec rake parallel_setup
+bundle exec parallel_rspec spec
+```
 
-Effectively, for versions 4.10 and upwards **AGPL-3.0** license applies.
+## Building & Releasing Gems
 
-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.
+```bash
+cd spree
+bundle exec rake gem:build     # build all gems
+bundle exec rake gem:release   # push to RubyGems
+```
 
-Please note:
-* [Spree under AGPLv3 may be used privately](https://spreecommerce.org/spree-under-agplv3-may-be-used-privately/) 
+## Generating TypeScript Types
 
-* [Spree Commerce Developer Covenant](https://spreecommerce.org/spree-commerce-developer-covenant/) 
+Types for the SDK are generated from API serializers:
 
-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).
+```bash
+cd spree/api
+bundle exec rake typelizer:generate
+```
 
-All third party components incorporated into this software are licensed under the original license provided by the owner of the applicable component.
+## Generating OpenAPI Spec
 
-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
+The Store API OpenAPI specification is generated from rswag integration tests:
 
-If you like what you see, consider giving Spree a GitHub star :star:
+```bash
+cd spree/api
+bundle exec rake rswag:specs:swaggerize
+```
 
-Thank you for supporting Spree open-source :heart:
+Output: `docs/api-reference/store.yaml`

data/lib/generators/spree/install/install_generator.rb

@@ -40,15 +40,11 @@ module Spree
       template 'config/initializers/spree.rb', 'config/initializers/spree.rb'
     end
 
-    def install_spree_cli
-      generate 'spree_cli:install'
-    end
-
     def install_authentication
       if @authentication == 'devise'
         generate 'spree:authentication:devise'
       elsif @authentication == 'dummy'
-        # this is for dummy / test app
+        generate 'spree:authentication:dummy'
       end
     end
 
@@ -84,7 +80,6 @@ module Spree
         silence_warnings { rake 'active_storage:install:migrations' }
         silence_warnings { rake 'action_text:install:migrations' }
         silence_warnings { rake 'spree:install:migrations' }
-        silence_warnings { rake 'spree_api:install:migrations' }
       end
     end
 

data/lib/generators/spree/install/templates/config/initializers/spree.rb

@@ -84,16 +84,6 @@ Rails.application.config.after_initialize do
   # Spree.export_types << Spree::Exports::Payments
   # Spree.reports << Spree::Reports::MassivelyOvercomplexReportForCfo
 
-  # Page builder (themes, pages, sections, blocks)
-  # Spree.page_builder.themes << Spree::Themes::NewShinyTheme
-  # Spree.page_builder.theme_layout_sections << Spree::PageSections::SuperImportantCeoBio
-  # Spree.page_builder.pages << Spree::Pages::CustomLandingPage
-  # Spree.page_builder.page_sections << Spree::PageSections::ContactFormToGetInTouch
-  # Spree.page_builder.page_blocks << Spree::PageBlocks::BigRedButtonToCallSales
-
-  # Storefront partials
-  # Spree.storefront.partials.head << 'spree/shared/that_js_snippet_that_marketing_forced_me_to_include'
-
   # Admin partials
   # Spree.admin.partials.product_form << 'spree/admin/products/custom_section'
 
@@ -124,4 +114,4 @@ Rails.application.config.after_initialize do
 end
 
 Spree.user_class = <%= (options[:user_class].blank? ? 'Spree::LegacyUser' : options[:user_class]).inspect %>
-Spree.admin_user_class = <%= (options[:admin_user_class].blank? ? (options[:user_class].blank? ? 'Spree::LegacyUser' : options[:user_class]) : options[:admin_user_class]).inspect %>
+Spree.admin_user_class = <%= (options[:admin_user_class].blank? ? (options[:user_class].blank? ? 'Spree::LegacyAdminUser' : options[:user_class]) : options[:admin_user_class]).inspect %>

data/lib/spree.rb

@@ -1,3 +1,2 @@
 require 'spree_core'
 require 'spree_api'
-require 'spree_cli'

metadata

@@ -1,15 +1,16 @@
 --- !ruby/object:Gem::Specification
 name: spree
 version: !ruby/object:Gem::Version
-  version: 5.3.4
+  version: 5.4.0.beta
 platform: ruby
 authors:
 - Sean Schofield
 - Spark Solutions Sp. z o.o.
 - Vendo Connect Inc.
+autorequire:
 bindir: bin
 cert_chain: []
-date: 1980-01-02 00:00:00.000000000 Z
+date: 2026-02-25 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: spree_core
@@ -17,42 +18,28 @@ dependencies:
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 5.3.4
+        version: 5.4.0.beta
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 5.3.4
+        version: 5.4.0.beta
 - !ruby/object:Gem::Dependency
   name: spree_api
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 5.3.4
+        version: 5.4.0.beta
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 5.3.4
-- !ruby/object:Gem::Dependency
-  name: spree_cli
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - '='
-      - !ruby/object:Gem::Version
-        version: 5.3.4
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - '='
-      - !ruby/object:Gem::Version
-        version: 5.3.4
+        version: 5.4.0.beta
 description: A complete open source e-commerce solution with multi-store, multi-currency
   and multi-language capabilities
 email: hello@spreecommerce.org
@@ -66,13 +53,13 @@ files:
 - lib/spree.rb
 homepage: https://spreecommerce.org
 licenses:
-- AGPL-3.0-or-later
 - BSD-3-Clause
 metadata:
   bug_tracker_uri: https://github.com/spree/spree/issues
-  changelog_uri: https://github.com/spree/spree/releases/tag/v5.3.4
+  changelog_uri: https://github.com/spree/spree/releases/tag/v5.4.0.beta
   documentation_uri: https://docs.spreecommerce.org/
-  source_code_uri: https://github.com/spree/spree/tree/v5.3.4
+  source_code_uri: https://github.com/spree/spree/tree/v5.4.0.beta
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -88,7 +75,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements:
 - none
-rubygems_version: 4.0.3
+rubygems_version: 3.5.22
+signing_key:
 specification_version: 4
 summary: A complete open source e-commerce solution
 test_files: []