0.1
There's a lot of open issues
A long-lived project that still receives updates
Spree Commerce Storefront built with Rails and Turbo/Hotwire
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Project Readme

Spree Rails Frontend

This is the Spree Storefront extracted from Spree < 4.3 which was upgraded to Turbo and Hotwire. It is based on Bootstrap 4. It is battle tested and is used in production by many stores.

This storefront includes also Checkout and Cart functionality providing a complete shopping experience.

Developed by

Vendo - Start your own multi-brand marketplace

Spark Solutions - Ruby on Rails and Spree Commerce developers

Installation

Run

bundle add 'spree_frontend'

Make sure that the spree_frontend gem is before spree_auth_devise.

Run:

bundle install
bin/rails g spree:frontend:install

Development

You can easily import all storefront templates to your application by running:

bin/rails g spree:frontend:copy_storefront

This will allow you to easily customize the look and feel of your storefront.

Troubleshooting

Disabled 'Add to Cart' Button Issue

If you notice that the 'Add to Cart' button is disabled on product pages, try the following:

bin/rails turbo:install
bin/rails g spree:frontend:install
bundle exec rake assets:clean assets:precompile

This issue may come up if you switch the source of your spree_frontend in your Gemfile, e.g. from github to a local path, etc.

Checkout without logging in results in 500 error

When you navigate to checkout without logging in first, you may get a a 500 error notifying you that "yourdomain.com redirected you too many times."

This error results from the routes defined in spree_frontend and spree_auth_devise not being built in the correct order. Make sure the spree_frontend gem is listed before spree_auth_devise in your main project's gemfile, then try again.

Running Tests

To run tests locally, first run bundle exec rake test_app, then bundle exec rspec.

Troubleshooting

If you are running on a Mac with an M1 processor, you may run into the following error when running tests:

Webdrivers::NetworkError:
Net::HTTPServerException: 404 "Not Found"

If so, update your gemfile locally to get version 5.0 or higher for the web drivers gem:

gem 'webdrivers', '~> 5.0'

Customization

Developer documentation