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_storefrontThen run the install generator:
bin/rails g spree:storefront:installThis 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
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