Spree Rails Storefront

A modern, fully-featured Ruby on Rails storefront for Spree Commerce, with an integrated visual page builder for creating custom pages and managing themes.

This repository contains two gems:

• spree_storefront — Responsive storefront with product catalog, cart, checkout, and customer accounts
• spree_page_builder — Visual page builder and theme management for the storefront

• Ruby on Rails
• Tailwind CSS v4 — Responsive, mobile-first design
• Turbo / Hotwire — Fast, SPA-like navigation
• StimulusJS — JavaScript controllers for interactivity
• Importmaps - NodeJS not required

Add the storefront gem to your Spree application (this automatically installs the page builder):

bundle add spree_storefront

Then run the install generator:

bin/rails g spree:storefront:install

This will set up the storefront views, Tailwind CSS configuration, and page builder migrations.

You will also need to create your first theme:

Spree::Store.default.send(:create_default_theme)

• Product catalog with filtering and search
• Shopping cart with guest persistence
• Multi-step checkout (address, shipping, payment)
• Customer accounts, order history, wishlists
• SEO optimization with meta tags and structured data
• Automatically cropping, resizing, and optimizing images for performance, CDN-ready

• Visual editor for creating custom pages
• Theme management with multiple themes per store
• 23+ pre-built page sections (headers, footers, product grids, image banners, etc.)
• Content blocks (text, images, buttons, navigation)
• Live preview with in-place editing

• Storefront Customization
• Theming Guide
• Page Builder
• CSS Customization

Check out our Next.js Starter with React 19, TypeScript and Tailwind CSS.

You can also use the Spree API and SDK to build your own storefront or mobile app.

# Run storefront tests
cd storefront
bundle install
bundle exec rake test_app
bundle exec rspec

# Run page builder tests
cd page_builder
bundle install
bundle exec rake test_app
bundle exec rspec

• spree_storefront is licensed under the MIT License
• spree_page_builder is licensed under the AGPL-3.0-or-later License