Upgrading Spree 4.0 to 4.1

This guide covers upgrading a 4.0 Spree application to Spree 4.1.

If you have any questions or suggestions feel free to reach out through Spree slack channels

If you’re on an older version than 4.0 please follow previous upgrade guides and perform those upgrades incrementally, eg.

This is the safest and recommended method.

Update Gemfile

gem 'spree', '~> 4.1.0.rc1'
gem 'spree_gateway', '~> 3.7'

rails spree:install:migrations

rails db:migrate

Spree 4.1 comes with a completely new mobile-first ultra-fast Storefront powered by Turbolinks.

To replace your current frontend with the new Spree UI follow these steps:

Update Spree Auth Devise to 4.1 in your Gemfile
```
gem 'spree_auth_devise', '~> 4.1.0.rc1'
```
In your project root directory run:
```
rails g spree:frontend:copy_storefront
```
WARNING this will overwrite your current project templates, it’s required for the new UI, so if you’ll be asked by the generator what to do please choose A to proceed
Next, you will need to copy over two files:
- spree_storefront.rb to config/initializers/spree_storefront.rb
- spree_storefront.yml to config/spree_storefront.yml
If you overwrote any spree_frontend controllers you will need to either remove your local copies or move your custom logic to decorators
Same goes for helpers
You will also need to remove this line:
```
//= require spree/frontend/spree_auth
```
from vendor/assets/javascripts/spree/frontend.all.js file

For information about changes contained within this release, please read the 4.1.0 Release Notes.

If you have any questions or suggestions feel free to reach out through Spree slack channels