Spree Commerce Starter

A production-ready e-commerce platform built with Spree Commerce on Ruby on Rails.

What is Spree?

Spree Commerce is a complete, modular e-commerce solution built with Ruby on Rails. It offers:

• 🛍️ Full-featured shopping cart
• 🎨 Customizable products, variants, and options
• 💳 Multiple payment gateway integrations
• 📦 Advanced shipping methods configuration
• 🔍 Powerful product search and filtering
• 👥 Customer accounts and order management
• 📱 Mobile-responsive design out of the box

What's Included

This template sets up:

• A Spree Commerce application
• PostgreSQL database for data persistence
• Redis for caching and background jobs

Environment Variables

This template automatically sets up most requirements, but you can customize these variables:

# Required 
ADMIN_EMAIL
# Password is auto generated, check env tab.

# Auto-generated secrets:
SECRET_KEY_BASE
SPREE_AUTH_SECRET_KEY

# Defaults set by template:
RAILS_ENV=production
RAILS_SERVE_STATIC_FILES=true
RAILS_LOG_TO_STDOUT=true

# Optional customization:
[email protected]
SPREE_STORE_NAME="Your Store Name"

Additional Features

• Multi-Store: Support for running multiple stores from a single installation
• Multi-Currency: Built-in support for multiple currencies
• Multi-Language: Internationalization ready
• SEO-Friendly: Built-in SEO best practices
• API-First: Complete REST API for headless commerce

Security

• All necessary security configurations are pre-configured
• Environment variables for sensitive data
• Secure password management
• CSRF protection enabled
• XSS protection enabled

Customization

Spree is highly customizable. You can:

1. Install additional Spree extensions
2. Override default views
3. Customize the admin interface
4. Add custom models and controllers

Support

For issues with:

• The template itself: Open an issue in the template repository
• Spree Commerce: Visit [Spree's documentation]