solidusio/solidus

What is it?

Key features

• 01Core eCommerce models, mailers and classes packaged as the solidus_core gem.
• 02RESTful API for storefront and integration needs via solidus_api.
• 03Admin area for managing the store via solidus_backend.
• 04Sample and seed data for trying the store locally.
• 05Supports PostgreSQL, MySQL, MariaDB and SQLite databases.
• 06Docker setup for local development and testing.

Use cases

• Building a custom online store with a Rails team that needs full control over code and data.
• Creating a headless commerce backend that a separate frontend consumes through the REST API.
• Extending an eCommerce platform with custom features through the Solidus extension ecosystem.

Quick start

1. 1

   Clone the Git repository

   git clone git://github.com/solidusio/solidus.git
2. 2

   Install the gem dependencies

   bin/setup
3. 3

   Create the sandbox application

   bin/sandbox
4. 4

   Start the Rails server and other services

   bin/dev

Things to know

• !The master branch is not guaranteed to be fully functional and is too risky for production.
• !ImageMagick must be installed because Paperclip requires it.
• !Solidus is meant to run inside a Rails application, so you must build or extend a store around it.

In collections

Topics

FAQ

What is solidus?

An open-source eCommerce framework built on Ruby on Rails for developers who want to build and fully control their own online store. Solidus is a Ruby on Rails eCommerce platform that provides the core models, mailers, admin area and RESTful API needed to run an online store. It is a fork of Spree and is distributed as a set of gems: solidus_core for essential models and classes, solidus_api for the REST API, solidus_backend for the admin interface, and solidus_sample for sample data. Requiring the solidus gem installs all of them.

Is solidus free to use? What license does it have?

solidus is open source under the BSD-3-Clause license. Check the license terms before using it in commercial products.

Is solidus still maintained?

Actively maintained. The last commit to solidus was on Oct 23, 2026.

What can I use solidus for?

Building a custom online store with a Rails team that needs full control over code and data. Creating a headless commerce backend that a separate frontend consumes through the REST API. Extending an eCommerce platform with custom features through the Solidus extension ecosystem.

How do I install solidus?

Clone the Git repository: git clone git://github.com/solidusio/solidus.git Install the gem dependencies: bin/setup Create the sandbox application: bin/sandbox Start the Rails server and other services: bin/dev

Where can I get solidus?

The source code and installation instructions are on GitHub: https://github.com/solidusio/solidus