spree

An open source eCommerce platform giving you full control and customizability. Modular and API-first. Build any eCommerce solution that your business requires. Developed by @vendo-dev

OTHER License

Downloads
4
Stars
12.9K
Committers
1.1K
View Code on GitHub Visit Website View on X
Ecosystems: Ruby on Rails, Ruby

Bot releases are hidden (Show)

spree - Version 4.0.2

Published by damianlegawiec almost 5 years ago

This patch release contains bug fixes backported from the master branch. We'd like to thank all the contributors who made this happen 👍

API

spree - Version 3.7.8

Published by damianlegawiec almost 5 years ago

spree - Version 4.0.1

Published by damianlegawiec almost 5 years ago

This patch release contains bug fixes backported from the master branch. We'd like to thank all the contributors who made this happen 👍

Admin Panel

spree - Version 4.0.0

Published by damianlegawiec about 5 years ago

Major/New Features

Rails 6.0 support 💥 💥 💥

Spree 4.0 is fully compatible with Rails 6.0 and the new default Zeitwerk code autoloader.

Storefront and Admin Panel moved to Bootstrap 4.2 🎨

We've migrated both the default Spree frontend and Admin Panel from Bootstrap 3 to Bootstrap 4.2. This update brings all of the new features and fixes introduced in Bootstrap 4, 4.1 and 4.2. Accessibility and RWD were also improved in the process.

Besides the Spree Frontend and Admin Panel we've also upgraded all extensions that required fixes, that is:

If you use any of those extensions please update them along with the Spree update.

Address Book support 🏠

Previously for multiple addresses support you had to use the Spree Address Book extension. We've decided that this was an inconsistency (user account already supported multiple credit cards) and moved this code into the core Spree and improved it.

Thanks to this signed in customers can manage multiple addresses in the Checkout and Account for both Shipping and Billing.

JSON-LD structured data support 🌐

To support schema.org we've replaced the old Microdata code with the new recommended JSON-LD format. This will make your store more future proof and improve SEO in the coming months.

Installation

Add Spree gems to Gemfile

gem 'spree', '~> 4.0'
gem 'spree_auth_devise', '~> 4.0'
gem 'spree_gateway', '~> 3.6'

Run bundle install

Use the install generators to set up Spree

rails g spree:install --user_class=Spree::User
rails g spree:auth:install
rails g spree_gateway:install

Upgrade

Official Spree 3.7 to 4.0 upgrade guide

Noteworthy changes

Please review each of the noteworthy changes to ensure your customizations or extensions are not affected. If you are affected by a change and have any suggestions please submit a PR to help the next person!

Full Changelog

You can view the full changes using Github Compare.

spree - Version 3.7.6

Published by damianlegawiec about 5 years ago

This patch release contains bug fixes backported from master to allow smoother Spree 4 migration process (#9545 and #9527 issues). We'd like to thank all the contributors who made this happen 👍

spree - Version 3.7.5

Published by damianlegawiec about 5 years ago

This patch release contains bug fixes backported from master. We'd like to thank all the contributors who made this happen 👍

API

spree - Version 3.7.4

Published by damianlegawiec about 5 years ago

This patch release contains bug fixes backported from master. We'd like to thank all the contributors who made this happen 👍

Core

API v2

spree - Version 3.7.3

Published by damianlegawiec over 5 years ago

This patch release contains bug fixes backported from master. We'd like to thank all the contributors who made this happen 👍

Core

API

Admin Panel

spree - Version 3.7.0 (with API v2, SOA refactor and Dependencies system)

Published by damianlegawiec over 5 years ago

Major/New Features

3.7 release is our last 3.x line release bridging the gap between 3.x and Spree 4.0. This is a big release packed with several amazing features and a huge number of bug fixes (over 700 commits by 17 contributors!). Upgrading to 3.7 guarantees a smooth and easy migration to Spree 4.0 (April 2019 with Rails 6.0 support).

Spree 3.7 requires Rails 5.2.2 and Ruby 2.3.3 (or higher).

Storefront API v2

We've worked hard over the last few months to deliver a completely new, easy to work with and lightweight REST API for building amazing customer interfaces with modern JavaScript libraries (React, Vue, Angular) and for native mobile apps. New Storefront API v2 is fast, easy to use and extend. It's also well documented in OpenAPI 3.0 (Swagger) format which you can import into Postman app.

New API is based on JSON API spec and uses blazing fast Netflix fast_json_api serializer library. Authentication is based on Oauth using doorkeeper library. Besides that there are no additional dependencies making it lightweight and future-proof.

Storefront API v2 consists of:

All of the endpoints support JSON API's Sparse Fieldsets to fix usual Over-Fetching issues and Related Resources to reduce the number of API queries you need to perform.

Service Oriented Architecture

While building the API v2 we've also refactored a huge portion of Spree internals by introducing modular Service Oriented Architecture to the codebase.

We're in the process of moving domain-specific code from models to Service Objects with a well-defined scope and predictable return values. All service objects include Service Module which unifies how those classes handle arguments and what they return.

Also, we're moving away from ransack library by introducing Finders and Sorters classes for simpler fetching resources and collections.

This makes Spree codebase easier to read and learn. It also makes any customizations way easier. At the same time, public APIs won't change a lot as providing backward compatibility is one of our top priorities.

Dependencies system

We're introducing a new painless way of customizing Spree without the need of decorators. With Dependencies you can easily replace parts of Spree internals with your custom classes. You can replace Services, Abilities and Serializers. More will come in the future. We hope using Dependencies will remove the need for creating decorators at all!

See Documentation

Removing Coffee Script

CoffeeScript a few years back ago was a really great JavaScript enhancement. Nowadays with ES6 and TypeScript around it became obsolete. That's why we've converted all of the CoffeeScript assets in Spree and extensions to plain JavaScript and removed CoffeeScript dependency.

Improved MySQL support

A lot of merchants were using Spree with MySQL for years now, but development of the platform was mainly focused on PostgreSQL support. We've changed that and all of our CI builds are tested and verified against both PostgreSQL and MySQL. We've also fixed all MySQL-related bugs.

Installation

Add Spree gems to Gemfile

gem 'spree', '~> 3.7.0'
gem 'spree_auth_devise', '~> 3.5'
gem 'spree_gateway', '~> 3.4'

Run bundle install

Use the install generators to set up Spree

rails g spree:install --user_class=Spree::User
rails g spree:auth:install
rails g spree_gateway:install

Upgrade

Spree 3.6 to 3.7 upgrade guide

Noteworthy changes

Please review each of the noteworthy changes to ensure your customizations or extensions are not affected. If you are affected by a change, and have any suggestions please submit a PR to help the next person!

Full Changelog

You can view the full changes using Github Compare.

spree - Version 3.7.0.rc3

Published by damianlegawiec over 5 years ago

spree - Version 3.2.9

Published by damianlegawiec over 5 years ago

  • Updated Paperclip dependency to 5.2 to fix CVE-2017-0889 SSRF vulnerability
spree - Version 3.1.14

Published by damianlegawiec over 5 years ago

  • Updated Paperclip dependency to 5.2 to fix CVE-2017-0889 SSRF vulnerability
spree - Version 3.7.0.rc2

Published by damianlegawiec over 5 years ago

spree - Version 3.7.0.rc1

Published by damianlegawiec almost 6 years ago

Major/New Features

3.7 release is our last 3.x line release bridging the gap between 3.x and Spree 4.0. This is a big release packed with several amazing features and a huge number of bug fixes (over 700 commits by 17 contributors!). Upgrading to 3.7 guarantees a smooth and easy migration to Spree 4.0 (April 2019 with Rails 6.0 support).

Spree 3.7 requires Rails 5.2.2 and Ruby 2.3.3 (or higher).

Storefront API v2

We've worked hard over the last few months to deliver a completely new, easy to work with and lightweight REST API for building amazing customer interfaces with modern JavaScript libraries (React, Vue, Angular) and for native mobile apps. New Storefront API v2 is fast, easy to use and extend. It's also well documented in OpenAPI 3.0 (Swagger) format which you can import into Postman app.

New API is based on JSON API spec and uses blazing fast Netflix fast_json_api serializer library. Authentication is based on Oauth using doorkeeper library. Besides that there are no additional dependencies making it lightweight and future-proof.

Storefront API v2 consists of:

All of the endpoints support JSON API's Sparse Fieldsets to fix usual Over-Fetching issues and Related Resources to reduce the number of API queries you need to perform.

Service Oriented Architecture

While building the API v2 we've also refactored a huge portion of Spree internals by introducing modular Service Oriented Architecture to the codebase.

We're in the process of moving domain-specific code from models to Service Objects with a well-defined scope and predictable return values. All service objects include Service Module which unifies how those classes handle arguments and what they return.

Also, we're moving away from ransack library by introducing Finders and Sorters classes for simpler fetching resources and collections.

This makes Spree codebase easier to read and learn. It also makes any customizations way easier. At the same time, public APIs won't change a lot as providing backward compatibility is one of our top priorities.

Removing Coffee Script

CoffeeScript a few years back ago was a really great JavaScript enhancement. Nowadays with ES6 and TypeScript around it became obsolete. That's why we've converted all of the CoffeeScript assets in Spree and extensions to plain JavaScript and removed CoffeeScript dependency.

Improved MySQL support

A lot of merchants were using Spree with MySQL for years now, but development of the platform was mainly focused on PostgreSQL support. We've changed that and all of our CI builds are tested and verified against both PostgreSQL and MySQL. We've also fixed all MySQL-related bugs.

Installation

Add Spree gems to Gemfile

gem 'spree', '~> 3.7.0.rc1'
gem 'spree_auth_devise', '~> 3.4'
gem 'spree_gateway', '~> 3.4'

Run bundle install

Use the install generators to set up Spree

rails g spree:install --user_class=Spree::User
rails g spree:auth:install
rails g spree_gateway:install

Upgrade

Spree 3.6 to 3.7 upgrade guide

Noteworthy changes

Please review each of the noteworthy changes to ensure your customizations or extensions are not affected. If you are affected by a change, and have any suggestions please submit a PR to help the next person!

Full Changelog

You can view the full changes using Github Compare.

spree - Version 3.7.0.beta

Published by damianlegawiec almost 6 years ago

Package Rankings
Top 0.96% on Rubygems.org
Top 3.46% on Proxy.golang.org
Top 17.05% on Npmjs.org
Related Projects
spree_admin_roles_and_access

Admin Roles And Access for Spree

23 Jul 2013 43
workarea

Workarea is an enterprise-grade Ruby on Rails commerce platform

21 Aug 2019 327