Solidus logo

Solidus

Full‑featured Ruby on Rails e‑commerce platform with complete store control

Solidus delivers a robust, customizable e‑commerce solution built on Ruby on Rails, offering API, admin UI, core models, and sample data—all as modular gems for flexible integration.

Solidus banner

Overview

Overview

Solidus is a full‑featured e‑commerce framework built on Ruby on Rails, targeting developers and businesses that require complete control over their online store. The platform ships as a set of modular gems—solidus_core for essential models and mailers, solidus_backend for a ready‑made admin interface, solidus_api for a RESTful API, and solidus_sample for seed data—allowing you to pick only what you need and replace any component with a custom implementation.

Capabilities

Out of the box you get product catalogues, order processing, payment integration, and a configurable admin dashboard. The REST API enables headless commerce, while the sample data gem lets you spin up a demo store instantly. Performance can be tuned by disabling asset debugging in development or adding Turbolinks to the admin UI.

Deployment

Installation is as simple as adding the solidus gem to a new Rails app and running bin/rails g solidus:install. You can customize the install with flags to skip migrations, seeds, or sample data. For consistent environments, Solidus provides a Docker‑compose setup that lets you choose Ruby, Rails, and database versions via build arguments and environment variables. Community support is available through the official guides, Slack channel, and an active contributor base led by Nebulab.

Highlights

Modular gem architecture (core, backend, API, sample)
Full RESTful API for headless commerce
Extensible admin dashboard out of the box
Sample data gem for instant demo stores

Pros

  • Built on mature Ruby on Rails framework
  • Highly customizable at every layer
  • Active community and corporate backing (Nebulab)
  • Docker support simplifies development setup

Considerations

  • Requires Ruby/Rails expertise to configure
  • Development mode can be slower due to asset loading
  • No hosted SaaS option; self‑hosting required
  • Master branch may be unstable for production

Managed products teams compare with

When teams consider Solidus, these hosted platforms usually appear on the same shortlist.

Adobe Commerce logo

Adobe Commerce

Enterprise e-commerce platform (formerly Magento Commerce) for building customizable online storefronts with rich features

BigCommerce logo

BigCommerce

Cloud-based SaaS e-commerce platform for creating and scaling online stores across B2C and B2B

commercetools logo

commercetools

Headless commerce platform (MACH) for building custom storefronts

Looking for a hosted option? These are the services engineering teams benchmark against before choosing open source.

Fit guide

Great for

  • Teams with existing Rails expertise seeking full control
  • Businesses needing a custom storefront or headless API
  • Projects that want open‑source flexibility and extensibility
  • Companies that prefer self‑hosting for data compliance

Not ideal when

  • Non‑technical merchants looking for turnkey solutions
  • Small shops preferring hosted platforms like Shopify
  • Organizations without Ruby development resources
  • Projects that need immediate production‑ready stability from master branch

How teams use it

Launch a custom storefront

Develop a unique front‑end while reusing Solidus core models and API.

Integrate e‑commerce into an existing Rails app

Add solidus_core gem to provide product, order, and payment logic without replacing current UI.

Rapid prototyping with sample data

Use solidus_sample to seed a demo store for client presentations.

Containerized development with Docker

Spin up a full development environment via docker‑compose, simplifying setup across OSes.

Tech snapshot

Ruby83%
HTML12%
JavaScript3%
SCSS1%
Handlebars1%
Shell1%

Tags

railsecommerceecommerce-frameworkhacktoberfeststorefrontsolidusecommerce-platformruby

Frequently asked questions

What Ruby version is supported?

Solidus works with recent Ruby versions; you can specify the version via your Gemfile or Docker build arguments.

Can I use Solidus without the admin UI?

Yes, you can include only solidus_core and build your own admin interface or use a third‑party solution.

How do I improve performance in development?

Disable asset debugging (`config.assets.debug = false`) and optionally enable Turbolinks in the admin area.

Is there a hosted version of Solidus?

No, Solidus is a self‑hosted framework; you deploy it on your own servers or cloud provider.

Where can I get community support?

Join the Solidus Slack (#support channel) and consult the guides at guides.solidus.io.

Project at a glance

Active
Stars
5,258
Watchers
5,258
Forks
1,363
Repo age10 years old
Last commit2 weeks ago
Primary languageRuby

Last synced 2 hours ago