Spree Starter

This is a starter kit for Spree Commerce - the open-source e-commerce platform for Rails. It is a great starting point for any Rails developer to quickly build an e-commerce store.

This starter uses:

• Spree Commerce 4.8 which includes Admin Dashboard, API and Storefront
• Ruby 3.3 and Ruby on Rails 7.1
• Solid Queue with Mission Control UI (access only to Spree admins) for background jobs
• Solid Cache for excellent caching and performance

You don't need to install any additional tools or libraries to start developing with Spree Starter. Everything is already set up for you.

Installation

Make sure you have the following installed:

• Docker with Docker Compose - installation instructions
• Ruby 3.3 - installation instructions
• Vips - installation instructions

bin/setup

If you want to use sample data (products, categories), you can load it using the following command:

bin/rake spree_sample:load

Switching to MySQL

By default, Spree Starter uses PostgreSQL. If you want to switch to MySQL, you can do so by running the following command:

bin/rails db:system:change --to=mysql

You will also need to run bin/setup again to install the MySQL adapter and create the database.

Launch local server

bin/rails s

Deployment

Using Render

Note that sample data does not automatically get loaded when deploying to Render with the default configuration. In order to add sample data, run the following commands in the web service shell:

bin/rake spree_sample:load

Using Heroku

Other platforms

Spree Starter is a standard Rails application, so you can deploy it to any platform that supports Ruby on Rails applications. You can also use Docker to deploy it to any container-based platform. Please check Spree Guides for more information.

Troubleshooting

libvips error

If you encounter an error like the following:

LoadError: Could not open library 'vips.so.42'

Please check that libvips is installed with vips -v, and if it is not installed, follow installation instructions here.