Back to Catalog
Spree Commerce logo

Spree Commerce

Open-source headless ecommerce platform with a REST API and Next.js storefront

app

Alternative to: Shopify, Magento, WooCommerce, Salesforce Commerce Cloud

Website Repository Docs
Spree Commerce screenshot
About Versions (100)
Back to Versions

v4.5.0

2022-12-01

Major features

Spree 4.5 is a technology update that lets you use Spree with the latest version of Ruby and Rails. It also comes with a new set of tools to make it easy to work with Spree as a part of complex projects - Spree CLI and Spree Platform API SDK.

Read our 4.4 to 4.5 Upgrade Doc for how to upgrade your app to the latest version.

Ruby 3 and Rails 7 support

  • If using Rails 7 with Spree 4.5, you will need to install libvips on your machine, as Rails 7 uses vips as its default variant processor. You can still use imagemagick, but you’ll need to manually set it in your Rails config.
  • Rails 6.0 is no longer supported - if you haven’t already, you’ll need to upgrade to Rails 6.1 or 7.0. The effort to upgrade to Rails 6.1 is relatively low, but brings a lot of improvements around ActiveStorage and handling of CDNs.

V1 API is now extracted into a standalone gem

V1 API is now deprecated and won’t be maintained. For new projects, please use V2 Platform API. If you need the V1 API for existing integrations, it’s still available as a standalone gem. Just add the following to your Gemfile:

gem 'spree_api_v1'

Updated admin look and feel

The admin panel got a clean look and minor usability improvements.

New Spree CLI

To help you easily create and manage projects based on Spree and one of the available storefront options, we built a new CLI to guide you through the process. To get started, simply run:

npx @spree/cli new app

Vue Storefront has feature-parity with Rails frontend

While Rails storefront (spree_frontend gem) is still available, we went one step ahead to give you an option to easily get started with a modern PWA storefront. It offers the same features as the Rails storefront, but is based on a modern Vue/Nuxt.js stack which gives a lot of performance benefits. Check out Vue Storefront here.

For details on changes made to other Spree gems as part of the 4.5.0 release, see the following:

Changelog on GitHub →