No packages found.
🛒 Solidus, the open-source eCommerce framework for industry trailblazers.
Nothing special found.
Nothing special found.
A free, open-source ecommerce platform that gives you complete control over your store.
As a community-driven project, Solidus relies on funds and time donated by developers and stakeholders who use Solidus for their businesses. If you'd like to help Solidus keep growing, please consider:
At present, Nebulab is the main code contributor and director of Solidus, providing technical guidance and coordinating community efforts and activities.
Support this project by becoming a Solidus Ambassador. Your logo will show up here with a link to your website. Become an Ambassador.
Solidus is a complete open source ecommerce solution built with Ruby on Rails.
It is a fork of Spree.
Solidus consists of several gems. When you require the
solidus gem in your
Gemfile, Bundler will install all of the following gems:
solidus_frontend(Cart and storefront)
solidus_core(Essential models, mailers, and classes)
solidus_frontend is still present in the meta-gem, it'll be removed in
Solidus v4.0. For new stores, we recommend using
All of the gems are designed to work together to provide a fully functional
ecommerce platform. However, you may only want to use the
combine it with your own custom frontend, admin interface, and API.
To add Solidus, begin with a Rails 5.2, 6 or 6.1 application and a database
configured and created.
In your application's root folder run:
bundle add solidus bin/rails g solidus:install
And follow the prompt's instructions.
Start the Rails server with the command:
For information on how to customize your store, check out the customization guides.
As part of running the above installation steps, you will be asked to set an admin email/password combination. The default values are
[email protected] and
Instead of a stable build, if you want to use the bleeding edge version of
Solidus, use this line:
gem 'solidus', github: 'solidusio/solidus'
Note: The master branch is not guaranteed to ever be in a fully functioning
state. It is too risky to use this branch in production.
By default, the installation generator (
solidus:install) will run
migrations as well as adding seed and sample data. This can be disabled using
bin/rails g solidus:install --migrate=false --sample=false --seed=false
You can always perform any of these steps later by using these commands.
bin/rails railties:install:migrations bin/rails db:migrate bin/rails db:seed bin/rails spree_sample:load
There are also options and rake tasks provided by
You may notice that your Solidus store runs slowly in development mode. This
include. This can be disabled by adding the following to
config.assets.debug = false
To gain some extra speed you may enable Turbolinks inside of Solidus admin.
gem 'turbolinks', '~> 5.0.0' into your
Gemfile (if not already present)
//= require turbolinks // // ... current file content // //= require spree/backend/turbolinks-integration.js
CAUTION Please be aware that Turbolinks can break extensions
and/or customizations to the Solidus admin. Use at your own risk.
git clone git://github.com/solidusio/solidus.git cd solidus
Note: If you're using PostgreSQL or MySQL, you'll need to install those gems through the DB environment variable.
# PostgreSQL export DB=postgresql bin/setup # MySQL export DB=mysql bin/setup
docker-compose up -d
Wait for all the gems to be installed (progress can be checked through
docker-compose logs -f app).
You can provide the ruby version you want your image to use:
docker-compose build --build-arg RUBY_VERSION=2.7 app docker-compose up -d
The rails version can be customized at runtime through
RAILS_VERSION environment variable:
RAILS_VERSION='~> 5.0' docker-compose up -d
# sqlite docker-compose exec app bin/rspec # postgres docker-compose exec app env DB=postgres bin/rspec # mysql docker-compose exec app env DB=mysql bin/rspec
Accessing the databases:
# sqlite docker-compose exec app sqlite3 /path/to/db # postgres docker-compose exec app env PGPASSWORD=password psql -U root -h postgres # mysql docker-compose exec app mysql -u root -h mysql -ppassword
In order to be able to access the sandbox application, just make
sure to provide the appropriate
--binding option to
rails server. By
3000 is exposed, but you can change it through
SANDBOX_PORT=4000 docker-compose up -d docker-compose exec app bin/sandbox docker-compose exec app bin/rails server --binding 0.0.0.0 --port 4000
Solidus is meant to be run within the context of Rails application. You can
easily create a sandbox application inside of your cloned source directory for
This sandbox includes solidus_auth_devise and generates with seed and sample
data already loaded.
You can create a sandbox with PostgreSQL or MySQL by setting the DB environment variable.
# PostgreSQL export DB=postgresql bin/sandbox # MySQL export DB=mysql bin/sandbox
Depending on your local environment, it may be necessary for you to set environment variables for your RDBMS, namely:
If you need to create a Rails 5.2 application for your sandbox, for example
if you are still using Ruby 2.4 which is not supported by Rails 6, you can
RAILS_VERSION environment variable.
export RAILS_VERSION='~> 5.2.0' bin/setup bin/sandbox
bin/railswill forward any argument to the sandbox)
Solidus uses RSpec for tests. Refer to its documentation for
more information about the testing library.
We use CircleCI to run the tests for Solidus as well as all incoming pull
requests. All pull requests must pass to be merged.
You can see the build statuses at
ChromeDriver is required to run
the backend test suites.
To execute all of the test specs, run the
bin/build script at the root of the Solidus project:
createuser --superuser --echo postgres # only the first time bin/build
bin/build script runs using PostgreSQL by default, but it can be overridden by setting the DB environment variable to
DB=mysql. For example:
env DB=mysql bin/build
If the command fails with MySQL related errors you can try creating a user with this command:
# Creates a user with the same name as the current user and no restrictions. mysql --user="root" --execute="CREATE USER '$USER'@'localhost'; GRANT ALL PRIVILEGES ON * . * TO '$USER'@'localhost';"
Each gem contains its own series of tests. To run the tests for the core project:
cd core bundle exec rspec
rspec runs the tests for SQLite 3. If you would like to run specs
against another database you may specify the database in the command:
env DB=postgresql bundle exec rspec
If you want to run the SimpleCov code
COVERAGE=true bundle exec rspec
In addition to core functionality provided in Solidus, there are a number of
ways to add features to your store that are not (or not yet) part of the core
A list can be found at extensions.solidus.io.
If you want to write an extension for Solidus, you can use the
Solidus is an open source project and we encourage contributions. Please read
CONTRIBUTING.md before contributing.