spree_multi_store 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: e04a1b3c2537beca45a3f71d694ab398b4beb627a8b1a7df529d2219720053fd
+  data.tar.gz: 3faad6a5bf518fa4a3939bee2475ee0799a5d545fed6dedd0b72521ef9c0ffae
+SHA512:
+  metadata.gz: '0508c322500915fcd34e1c8f1d004020d2075c7abd27615b5b607a08374ced3eb074a64ab4fe1fbe4a764f4d46ebd64d65be80dc0b08c2147115a7c7f601eda5'
+  data.tar.gz: 4746391eeae2143b67e1fca2d70fac6853b00db0c8acc172f66fba4e7d84b94a2d1dd48cabbe8f6f723e63231f3d1ea4f04b46fd0217c3b8b151f648bfc4fdba

data/LICENSE.md

@@ -0,0 +1,14 @@
+Copyright (c) 2026 Vendo Connect Inc. Vendo Sp. z o.o.
+
+This program is free software: you can redistribute it and/or modify
+it under the terms of the GNU Affero General Public License as published by
+the Free Software Foundation, either version 3 of the License, or
+(at your option) any later version.
+
+This program is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+GNU Affero General Public License for more details.
+
+You should have received a copy of the GNU Affero General Public License
+along with this program.  If not, see <https://www.gnu.org/licenses/>.

data/README.md

@@ -0,0 +1,50 @@
+# Spree Multi-Store
+
+Multi-store switching, custom domains, and store resolution for [Spree Commerce](https://spreecommerce.org).
+
+## Features
+
+- **Multi-Store Management** — create and manage multiple storefronts from a single Spree installation
+- **Custom Domains** — map custom domain names to individual stores
+- **Store Resolution** — automatically detect the current store based on request URL or custom domain
+- **Resource Scoping** — scope products, promotions, and payment methods to specific stores
+- **Store Creation Wizard** — admin UI for creating new stores with product/payment method imports
+
+# Multi-store vs Multi-tenant
+
+* Multi-Store setup is recommended for running multiple brands or multiple language versions of the same store
+* Multi-Tenant allows you to create a SaaS application with multiple tenants, each of them with their own Spree instance
+
+> [!TIP]
+> For a full [Multi-Tenant](https://spreecommerce.org/multi-tenant-white-label-ecommerce/) solution please [contact us](https://spreecommerce.org/get-started/) to obtain commercial license.
+
+## Installation
+
+Add to your Gemfile:
+
+```ruby
+gem 'spree_multi_store'
+```
+
+Then run:
+
+```bash
+bundle install
+```
+
+## Configuration
+
+Set your root domain for automatic subdomain-based store URLs:
+
+```ruby
+# config/initializers/spree.rb
+Spree.root_domain = ENV.fetch('SPREE_ROOT_DOMAIN', 'lvh.me')
+```
+
+## License
+
+Copyright (c) 2026 Vendo Connect Inc., Vendo Sp. z o.o.
+
+Licensed under the [GNU Affero General Public License v3.0 or later (AGPL-3.0-or-later)](LICENSE.md).
+
+For commercial licensing options, contact [sales@getvendo.com](mailto:sales@getvendo.com).

data/Rakefile

@@ -0,0 +1,23 @@
+require 'bundler'
+Bundler::GemHelper.install_tasks
+
+require 'rspec/core/rake_task'
+require 'spree/testing_support/extension_rake'
+
+RSpec::Core::RakeTask.new
+
+task :default do
+  if Dir['spec/dummy'].empty?
+    Rake::Task[:test_app].invoke
+    Dir.chdir('../../')
+  end
+  Rake::Task[:spec].invoke
+end
+
+desc 'Generates a dummy app for testing'
+task :test_app do
+  ENV['LIB_NAME'] = 'spree_multi_store'
+  Rake::Task['extension:test_app'].execute(
+    install_admin: true
+  )
+end

data/app/controllers/spree/admin/custom_domains_controller.rb

@@ -0,0 +1,21 @@
+module Spree
+  module Admin
+    class CustomDomainsController < ResourceController
+      include Spree::Admin::SettingsConcern
+
+      protected
+
+      def collection_url
+        spree.admin_custom_domains_path
+      end
+
+      def location_after_save
+        spree.admin_custom_domains_path
+      end
+
+      def permitted_resource_params
+        params.require(:custom_domain).permit(Spree::PermittedAttributes.custom_domain_attributes)
+      end
+    end
+  end
+end

data/app/controllers/spree/admin/multi_store/base_controller_decorator.rb

@@ -0,0 +1,13 @@
+module Spree
+  module Admin
+    module MultiStore
+      module BaseControllerDecorator
+        def self.prepended(base)
+          base.helper 'spree/admin/multi_store'
+        end
+      end
+    end
+
+    BaseController.prepend(MultiStore::BaseControllerDecorator)
+  end
+end

data/app/controllers/spree/admin/multi_store/stores_controller.rb

@@ -0,0 +1,35 @@
+module Spree
+  module Admin
+    module MultiStore
+      class StoresController < Spree::Admin::BaseController
+        def new
+          @store = Spree::Store.new(default_country_iso: 'US')
+          render :new, layout: 'spree/admin_wizard'
+        end
+
+        def create
+          @store = Spree::Store.new(permitted_store_params)
+          @store.mail_from_address = current_store.mail_from_address
+
+          if @store.save
+            # Move/copy all existing users (staff) to the new store
+            current_store.role_users.each do |role_user|
+              @store.add_user(role_user.user, role_user.role)
+            end
+
+            flash[:success] = flash_message_for(@store, :successfully_created)
+            redirect_to spree.admin_getting_started_url(host: @store.url), allow_other_host: true
+          else
+            render :new, status: :unprocessable_content, layout: 'spree/admin_wizard'
+          end
+        end
+
+        protected
+
+        def permitted_store_params
+          params.require(:store).permit(permitted_store_attributes)
+        end
+      end
+    end
+  end
+end

data/app/finders/spree/stores/find_current.rb

@@ -0,0 +1,28 @@
+module Spree
+  module Stores
+    class FindCurrent
+      def initialize(scope: nil, url: nil)
+        @scope = scope || Spree::Store
+        @url = url
+      end
+
+      def execute
+        store = by_url(scope) || scope.default
+        return if store.nil?
+
+        Spree::Current.store = store
+        store
+      end
+
+      protected
+
+      attr_reader :scope, :url
+
+      def by_url(scope)
+        return if url.blank?
+
+        scope.by_custom_domain(url).or(scope.by_url(url)).first
+      end
+    end
+  end
+end

data/app/helpers/spree/admin/multi_store_helper.rb

@@ -0,0 +1,11 @@
+module Spree
+  module Admin
+    module MultiStoreHelper
+      def available_stores
+        scope = Spree::Store.accessible_by(current_ability, :manage).includes(:logo_attachment)
+        scope = scope.includes(:default_custom_domain) if Spree::Store.reflect_on_association(:default_custom_domain)
+        @available_stores ||= scope
+      end
+    end
+  end
+end

data/app/models/concerns/spree/multi_store_resource.rb

@@ -0,0 +1,33 @@
+module Spree
+  module MultiStoreResource
+    extend ActiveSupport::Concern
+
+    included do
+      scope :for_store, ->(store) { joins(:stores).where(Store.table_name => { id: store.id }) }
+
+      before_validation :set_default_store, if: :new_record?
+
+      validate :must_have_one_store, unless: :disable_store_presence_validation?
+    end
+
+    protected
+
+    def must_have_one_store
+      return if stores.any?
+
+      errors.add(:stores, Spree.t(:must_have_one_store))
+    end
+
+    def set_default_store
+      return if disable_store_presence_validation?
+      return if stores.any?
+
+      stores << Spree::Store.default
+    end
+
+    # this can be overridden on model basis
+    def disable_store_presence_validation?
+      Spree::Config[:disable_store_presence_validation]
+    end
+  end
+end

data/app/models/concerns/spree/store/multi_store_class_overrides.rb

@@ -0,0 +1,15 @@
+module Spree
+  module Store::MultiStoreClassOverrides
+    def current(url = nil)
+      if url.present?
+        Spree.current_store_finder.new(url: url).execute
+      else
+        Spree::Current.store
+      end
+    end
+
+    def available_locales
+      Spree::Store.all.map(&:supported_locales_list).flatten.uniq
+    end
+  end
+end

data/app/models/concerns/spree/store/multi_store_methods.rb

@@ -0,0 +1,108 @@
+module Spree
+  module Store::MultiStoreMethods
+    extend ActiveSupport::Concern
+
+    RESERVED_CODES = %w(
+      admin default app api www cdn files assets checkout account auth login user
+    )
+
+    included do
+      has_many :custom_domains, class_name: 'Spree::CustomDomain', dependent: :destroy
+      has_one :default_custom_domain, -> { where(default: true) }, class_name: 'Spree::CustomDomain'
+
+      attribute :import_products_from_store_id, :string, default: nil
+      attribute :import_payment_methods_from_store_id, :string, default: nil
+
+      attr_accessor :skip_validate_not_last
+
+      validates :code, uniqueness: { case_sensitive: false, conditions: -> { with_deleted } },
+                       exclusion: Spree::Store::MultiStoreMethods::RESERVED_CODES
+
+      before_validation :set_url
+      after_create :import_products_from_store, if: -> { import_products_from_store_id.present? }
+      after_create :import_payment_methods_from_store, if: -> { import_payment_methods_from_store_id.present? }
+      after_commit :handle_code_changes, on: :update, if: -> { code_previously_changed? }
+      before_destroy :validate_not_last, unless: :skip_validate_not_last
+      before_destroy :pass_default_flag_to_other_store
+
+      scope :by_custom_domain, ->(url) { left_joins(:custom_domains).where("#{Spree::CustomDomain.table_name}.url" => url) }
+      scope :by_url, ->(url) { where(url: url).or(where("#{table_name}.url like ?", "%#{url}%")) }
+
+      # Re-configure FriendlyId to use :history for code tracking across renames
+      friendly_id :slug_candidates, use: [:slugged, :history], slug_column: :code, routes: :normal
+    end
+
+    def formatted_custom_domain
+      return unless default_custom_domain
+
+      @formatted_custom_domain ||= if Rails.env.development? || Rails.env.test?
+        URI::Generic.build(
+          scheme: Rails.application.routes.default_url_options[:protocol] || 'http',
+          host: default_custom_domain.url,
+          port: Rails.application.routes.default_url_options[:port]
+        ).to_s
+      else
+        URI::HTTPS.build(host: default_custom_domain.url).to_s
+      end
+    end
+
+    def can_be_deleted?
+      self.class.where.not(id: id).any?
+    end
+
+    def import_products_from_store
+      store = Spree::Store.find(import_products_from_store_id)
+      product_ids = store.products.pluck(:id)
+
+      return if product_ids.empty?
+
+      Spree::StoreProduct.insert_all(product_ids.map { |product_id| { store_id: id, product_id: product_id } })
+    end
+
+    def import_payment_methods_from_store
+      store = Spree::Store.find(import_payment_methods_from_store_id)
+      payment_method_ids = store.payment_method_ids
+
+      return if payment_method_ids.empty?
+
+      Spree::StorePaymentMethod.insert_all(payment_method_ids.map { |payment_method_id| { store_id: id, payment_method_id: payment_method_id } })
+    end
+
+    private
+
+    def validate_not_last
+      unless can_be_deleted?
+        errors.add(:base, :cannot_destroy_only_store)
+        throw(:abort)
+      end
+    end
+
+    def pass_default_flag_to_other_store
+      if default? && can_be_deleted?
+        self.class.where.not(id: id).first.update!(default: true)
+        self.default = false
+      end
+    end
+
+    def handle_code_changes
+      # hook for custom logic on code changes
+    end
+
+    # Auto-assign internal URL for stores based on code + root domain
+    def set_url
+      return if url_changed?
+      return unless code_changed?
+      return unless Spree.root_domain.present?
+
+      self.url = [code, Spree.root_domain].join('.')
+    end
+
+    def slug_candidates
+      []
+    end
+
+    def should_generate_new_friendly_id?
+      false
+    end
+  end
+end

data/app/models/concerns/spree/store/multi_store_overrides.rb

@@ -0,0 +1,39 @@
+module Spree
+  module Store::MultiStoreOverrides
+    def url_or_custom_domain
+      default_custom_domain&.url || url
+    end
+
+    def formatted_url_or_custom_domain
+      formatted_custom_domain || formatted_url
+    end
+
+    def can_be_deleted?
+      self.class.where.not(id: id).any?
+    end
+
+    private
+
+    # Override core's simple set_default_code with full code generation logic
+    def set_default_code
+      self.code = if code.present?
+                    code.parameterize.strip
+                  elsif name.present?
+                    name.parameterize.strip
+                  end
+
+      return if self.code.blank?
+
+      # ensure code is unique
+      self.code = [name.parameterize, rand(9999)].join('-') while Spree::Store.with_deleted.where(code: self.code).exists?
+    end
+
+    def should_generate_new_friendly_id?
+      false
+    end
+
+    def slug_candidates
+      []
+    end
+  end
+end

data/app/models/spree/custom_domain.rb

@@ -0,0 +1,61 @@
+module Spree
+  class CustomDomain < Spree::Base
+    has_prefix_id :domain
+
+    include Spree::SingleStoreResource
+    include Spree::Metafields
+    include Spree::Metadata
+
+    normalizes :url, with: ->(value) { value&.to_s&.squish&.presence }
+
+    #
+    # Associations
+    #
+    belongs_to :store, class_name: 'Spree::Store', inverse_of: :custom_domains, touch: true
+
+    #
+    # Validations
+    #
+    validates :url, presence: true, uniqueness: true, format: {
+      with: %r{\A(?:[a-z0-9](?:[a-z0-9-]*[a-z0-9])?\.)+[a-z0-9](?:[a-z0-9-]*[a-z0-9])?\z}i
+    }, length: { in: 1..63 }
+    validate :url_is_valid
+
+    #
+    # Callbacks
+    #
+    before_validation :sanitize_url
+    after_save :ensure_has_one_default
+    after_validation :ensure_default, on: :create
+
+    def url_is_valid
+      return if url.blank?
+      parts = url.split('.')
+
+      errors.add(:url, 'use domain or subdomain') if parts.size > 4 || parts.size < 2
+    end
+
+    def ensure_default
+      self.default = store.custom_domains.count.zero?
+    end
+
+    def ensure_has_one_default
+      store.custom_domains.where.not(id: id).update_all(default: false) if default?
+    end
+
+    def active?
+      true
+    end
+
+    def name
+      url
+    end
+
+    private
+
+    # remove https:// and http:// from the url
+    def sanitize_url
+      self.url = url&.gsub(%r{https?://}, '')
+    end
+  end
+end

data/app/models/spree/multi_store/payment_method_decorator.rb

@@ -0,0 +1,11 @@
+module Spree
+  module MultiStore
+    module PaymentMethodDecorator
+      def self.prepended(base)
+        base.include Spree::MultiStoreResource
+      end
+    end
+  end
+
+  PaymentMethod.prepend(MultiStore::PaymentMethodDecorator)
+end

data/app/models/spree/multi_store/product_decorator.rb

@@ -0,0 +1,11 @@
+module Spree
+  module MultiStore
+    module ProductDecorator
+      def self.prepended(base)
+        base.include Spree::MultiStoreResource
+      end
+    end
+  end
+
+  Product.prepend(MultiStore::ProductDecorator)
+end

data/app/models/spree/multi_store/promotion_decorator.rb

@@ -0,0 +1,11 @@
+module Spree
+  module MultiStore
+    module PromotionDecorator
+      def self.prepended(base)
+        base.include Spree::MultiStoreResource
+      end
+    end
+  end
+
+  Promotion.prepend(MultiStore::PromotionDecorator)
+end

data/app/models/spree/multi_store/store_decorator.rb

@@ -0,0 +1,13 @@
+module Spree
+  module MultiStore
+    module StoreDecorator
+      def self.prepended(base)
+        base.include Spree::Store::MultiStoreMethods
+        base.singleton_class.prepend Spree::Store::MultiStoreClassOverrides
+      end
+    end
+  end
+
+  Store.prepend(MultiStore::StoreDecorator)
+  Store.prepend(Store::MultiStoreOverrides)
+end

data/app/views/spree/admin/custom_domains/_custom_domain.html.erb

@@ -0,0 +1,11 @@
+<tr id="<%= spree_dom_id custom_domain %>">
+  <td><%= custom_domain.url %></td>
+  <td>
+    <%= active_badge(custom_domain.active?) %>
+  </td>
+
+  <td><%= active_badge(custom_domain.default?) %></td>
+  <td class="actions">
+    <%= link_to_edit(custom_domain, no_text: true, url: spree.edit_admin_custom_domain_path(custom_domain), data: { turbo: false }) %>
+  </td>
+</tr>

data/app/views/spree/admin/custom_domains/_custom_domains.html.erb

@@ -0,0 +1,19 @@
+<% if current_store.custom_domains.any? %>
+  <div class="table-responsive rounded-lg  mt-4 border">
+    <table class="table">
+      <thead>
+        <tr>
+          <th scope="col"><%= sort_link @search, :name, Spree.t(:name) %></th>
+          <th scope="col"><%= Spree.t(:active) %>?</th>
+          <th scope="col"><%= Spree.t(:default) %>?</th>
+          <th scope="col"></th>
+        </tr>
+      </thead>
+      <tbody>
+        <%= render collection: current_store.custom_domains, partial: 'spree/admin/custom_domains/custom_domain', cached: spree_base_cache_scope %>
+      </tbody>
+    </table>
+  </div>
+<% else %>
+  <%= render 'spree/admin/shared/no_resource_found' %>
+<% end %>

data/app/views/spree/admin/custom_domains/_form.html.erb

@@ -0,0 +1,7 @@
+<div class="card mb-6">
+  <div class="card-body">
+    <%= f.spree_text_field :url, label: Spree.t(:domain), prepend: 'https://', autofocus: f.object.new_record?, required: true %>
+
+    <%= f.spree_check_box :default, help: 'We will use this domain in emails to customers.' %>
+  </div>
+</div>

data/app/views/spree/admin/custom_domains/edit.html.erb

@@ -0,0 +1 @@
+<%= render 'spree/admin/shared/edit_resource' %>

data/app/views/spree/admin/custom_domains/index.html.erb

@@ -0,0 +1,65 @@
+<%= content_for(:page_title) do %>
+  <%= Spree.t(:domains) %>
+<% end %>
+
+<% content_for :page_actions do %>
+  <%= render_admin_partials(:custom_domains_actions_partials) %>
+<% end %>
+
+<%= render_admin_partials(:custom_domains_header_partials) %>
+
+<div class="card-lg p-6">
+  <h5 class="mb-2">Internal URL</h5>
+  <div class="grid grid-cols-12 gap-6 mb-6">
+    <div class="col-span-12 lg:col-span-4">
+      <p class="text-gray-600">
+        This is your internal Admin URL.
+      </p>
+    </div>
+    <div class="col-span-12 lg:col-span-7 lg:col-start-6">
+      <%= form_for current_store, url: spree.admin_store_path, data: { turbo: false, controller: 'enable-button', 'enable-button-disable-when-not-changed-value': true } do |f| %>
+        <% if Spree.root_domain.present? %>
+          <div class="flex items-center gap-6">
+            <div class="input-group pr-2 grow <% if current_store.custom_domains.any? %>disabled<% end %>">
+              <span class="text-gray-400 pl-3 pr-0">https://</span>
+              <%= f.text_field :code, class: 'border-0 focus:ring-0 focus:outline-none grow rounded-lg text-base pl-0', data: { enable_button_target: 'input' }, required: true, disabled: current_store.custom_domains.any? %>
+              <span>.<%= Spree.root_domain %></span>
+
+              <%= clipboard_component(current_store.formatted_url) %>
+            </div>
+            <% unless current_store.custom_domains.any? %>
+              <%= turbo_save_button_tag %>
+            <% end %>
+          </div>
+        <% else %>
+          <div class="flex items-center gap-6">
+            <div class="input-group pr-2 grow">
+              <span class="text-gray-400 pl-3 pr-0">https://</span>
+              <%= f.text_field :url, class: 'border-0 focus:ring-0 focus:outline-none grow rounded-lg text-base pl-0', required: true, data: { enable_button_target: 'input' } %>
+              <%= clipboard_component(current_store.formatted_url) %>
+            </div>
+            <%= turbo_save_button_tag %>
+          </div>
+        <% end %>
+      <% end %>
+    </div>
+  </div>
+  <hr class="my-12" />
+  <h5 class="mb-2"><%= Spree.t(:custom_domains) %></h5>
+  <div class="grid grid-cols-12 gap-6">
+    <div class="col-span-12 lg:col-span-4">
+      <p class="text-gray-600">
+        Connect your domain or subdomain to your storefront.
+      </p>
+    </div>
+    <div class="col-span-12 lg:col-span-7 lg:col-start-6">
+      <div class="text-right">
+        <%= link_to Spree.t(:new_domain), spree.new_admin_custom_domain_path, class: "btn btn-primary" %>
+      </div>
+
+      <%= turbo_frame_tag 'admin_custom_domains_index' do %>
+        <%= render 'custom_domains' %>
+      <% end %>
+    </div>
+  </div>
+</div>

data/app/views/spree/admin/custom_domains/new.html.erb

@@ -0,0 +1 @@
+<%= render 'spree/admin/shared/new_resource' %>

data/app/views/spree/admin/multi_store/stores/new.html.erb

@@ -0,0 +1,122 @@
+<%= form_for @store, url: spree.admin_stores_path, data: { turbo: false, controller: 'enable-button' } do |f| %>
+  <div class="container mx-auto px-4 pt-8">
+    <h1 class="mb-6"><%= Spree.t(:new_store) %></h1>
+
+    <%= render partial: 'spree/admin/shared/error_messages', locals: { target: @store } %>
+    <div class="grid grid-cols-12 gap-16">
+      <div class="col-span-12 lg:col-span-6">
+          <div class="form-group">
+            <%= f.label :name %>
+            <%= f.text_field :name, class: 'form-input',
+                                  placeholder: Spree.t(:store_name),
+                                  required: true,
+                                  autofocus: true,
+                                  data: {
+                                    enable_button_target: 'input',
+                                  } %>
+          </div>
+
+          <div class="form-group">
+            <%= f.label :default_country_iso, Spree.t(:country) %>
+            <%= f.collection_select :default_country_iso, Spree::Country.order(:name), :iso, :name, { }, { data: { controller: 'autocomplete-select', enable_button_target: 'input' } } %>
+          </div>
+
+          <% if available_stores.any? %>
+            <div class="form-group">
+              <%= f.label :import_products_from_store_id, Spree.t(:import_products_from) %>
+              <%= f.select :import_products_from_store_id,
+                          options_for_select(available_stores.pluck(:name, :id)),
+                          { include_blank: Spree.t(:do_not_import) },
+                          {
+                            data: { controller: 'autocomplete-select' }
+                            } %>
+            </div>
+
+            <div class="form-group">
+              <%= f.label :import_payment_methods_from_store_id, Spree.t(:import_payment_methods_from) %>
+              <%= f.select :import_payment_methods_from_store_id,
+                          options_for_select(available_stores.pluck(:name, :id)),
+                          { include_blank: Spree.t(:do_not_import) },
+                          {
+                            data: { controller: 'autocomplete-select' }
+                            } %>
+            </div>
+          <% end %>
+        </div>
+        <div class="col-span-12 lg:col-span-5 lg:col-start-8">
+          <h5 class="mb-2">What will be shared with this new store:</h5>
+          <ul class="list-none p-0">
+            <li>
+              <%= icon('check', class: 'text-green-700') %>
+              <%= Spree.t(:products) %>, <%= Spree.t(:stock_locations) %> & <%= Spree.t(:inventory) %><br>
+              <em class="ml-5 text-gray-600 text-sm">you can select which ones will be available for this store</em>
+            </li>
+            <li>
+              <%= icon('check', class: 'text-green-700') %>
+              <%= Spree.t(:customers) %>
+            </li>
+            <li>
+              <%= icon('check', class: 'text-green-700') %>
+              <%= Spree.t(:shipping_methods) %>
+            </li>
+            <li>
+              <%= icon('check', class: 'text-green-700') %>
+              <%= Spree.t(:payment_methods) %><br>
+              <em class="ml-5 text-gray-600 text-sm">you can select which ones will be available for this store</em>
+            </li>
+            <li>
+              <%= icon('check', class: 'text-green-700') %>
+              Admin user privileges
+            </li>
+          </ul>
+
+          <h5 class="mt-6 mb-2">What will not be shared with this new store:</h5>
+          <ul class="list-none p-0">
+            <li>
+              <%= icon('x', class: 'text-danger') %>
+              <%= Spree.t(:orders) %>
+            </li>
+            <li>
+              <%= icon('x', class: 'text-danger') %>
+              <%= Spree.t(:shipments) %>
+            </li>
+            <li>
+              <%= icon('x', class: 'text-danger') %>
+              <%= Spree.t(:payments) %>
+            </li>
+            <li>
+              <%= icon('x', class: 'text-danger') %>
+              <%= Spree.t(:refunds) %>
+            </li>
+            <li>
+              <%= icon('x', class: 'text-danger') %>
+              <%= Spree.t(:store_credits) %>
+            </li>
+            <li>
+              <%= icon('x', class: 'text-danger') %>
+              <%= Spree.t(:gift_cards) %>
+            </li>
+            <li>
+              <%= icon('x', class: 'text-danger') %>
+              <%= Spree.t(:blogs_posts) %>
+            </li>
+            <li>
+              <%= icon('x', class: 'text-danger') %>
+              <%= Spree.t(:markets) %>
+            </li>
+            <li>
+              <%= icon('x', class: 'text-danger') %>
+              <%= Spree.t(:themes) %> & <%= Spree.t(:pages) %>
+            </li>
+            <li>
+              <%= icon('x', class: 'text-danger') %>
+              <%= Spree.t(:integrations) %> eg. Google Analytics, Meta Pixel, etc.
+            </li>
+          </ul>
+      </div>
+    </div>
+  </div>
+  <footer id="footer" class="fixed bottom-0 left-0 w-full border-t border-gray-200 px-6 py-4 bg-gray-25 flex items-center justify-end gap-4 z-[1000]">
+    <%= turbo_save_button_tag Spree.t('actions.create'), data: { admin_target: 'save' } %>
+  </footer>
+<% end %>

data/app/views/spree/admin/multi_store/stores/new.turbo_stream.erb

@@ -0,0 +1 @@
+<%= render template: 'spree/admin/stores/new', formats: [:html] %>

data/app/views/spree/admin/products/form/_stores.html.erb

@@ -0,0 +1,29 @@
+<% if available_stores.count > 1 %>
+  <div class="card mb-6">
+    <div class="card-header">
+      <h5 class="card-title">
+        <%= Spree.t(:stores) %>
+      </h5>
+    </div>
+    <div class="card-body">
+      <div class="form-group">
+        <% if can? :modify, Spree::StoreProduct %>
+          <p class="form-text"><%= Spree.t('admin.products.stores.choose_stores') %>.</p>
+
+          <%= f.collection_check_boxes :store_ids, available_stores, :id, :name do |b| %>
+            <div class="custom-control form-checkbox mb-1">
+              <%= b.check_box(class: 'custom-control-input') %>
+              <%= b.label(class: 'custom-control-label') %>
+            </div>
+          <% end %>
+        <% elsif @product.stores.any? %>
+          <ul class="text_list">
+            <% @product.stores.pluck(:name).each do |store_name| %>
+              <li><%= store_name %></li>
+            <% end %>
+          </ul>
+        <% end %>
+      </div>
+    </div>
+  </div>
+<% end %>

data/app/views/spree/admin/shared/sidebar/_store_dropdown.html.erb

@@ -0,0 +1,55 @@
+<div class="store-dropdown" id="store-menu">
+  <%= dropdown do %>
+    <%= dropdown_toggle class: 'store-dropdown-button dropdown-toggle' do %>
+      <%= store_admin_icon(current_store, height: 32, width: 32) %>
+      <span class="store-name hidden lg:block">
+        <%= truncate(current_store.name, length: 10) %>
+      </span>
+    <% end %>
+    <%= dropdown_menu do %>
+      <%= link_to current_store.formatted_url_or_custom_domain, class: 'dropdown-item', target: '_blank' do %>
+        <%= icon 'eye' %>
+        <%= Spree.t(:view_store) %>
+      <% end %>
+      <%= link_to spree.edit_admin_theme_path(current_store.default_theme), class: 'dropdown-item', data: { turbo_prefetch: false } do %>
+        <%= icon 'tools' %>
+        <%= Spree.t('admin.edit_theme') %>
+      <% end if current_store.respond_to?(:default_theme) && current_store.default_theme && can?(:manage, Spree::Theme) %>
+
+      <% if available_stores.count > 1 %>
+        <div class="dropdown-divider"></div>
+        <h6 class="dropdown-header">
+          <%= Spree.t(:switch_store) %>
+        </h6>
+        <div class="store-chooser">
+          <% available_stores.each do |store| %>
+            <% if store.id == current_store.id %>
+              <div class="store-chooser-item active">
+                <%= store_admin_icon(store, height: 32, width: 32) %>
+                <span class="flex flex-col mr-2">
+                  <%= store.name %>
+                  <small class="text-gray-600">
+                    <%= store.url_or_custom_domain %>
+                  </small>
+                </span>
+                <%= icon('check', class: 'ml-auto') %>
+              </div>
+            <% else %>
+              <%= link_to spree.admin_dashboard_url(host: store.url), class: 'store-chooser-item' do %>
+                <%= store_admin_icon(store, height: 32, width: 32) %>
+                <span class="flex flex-col">
+                  <%= store.name %>
+                  <small class="text-gray-600">
+                    <%= store.url_or_custom_domain %>
+                  </small>
+                </span>
+              <% end %>
+            <% end %>
+          <% end %>
+        </div>
+      <% end %>
+    <% end %>
+  <% end %>
+
+  <%= render 'spree/admin/shared/new_item_dropdown' %>
+</div>

data/config/initializers/spree_multi_store.rb

@@ -0,0 +1,19 @@
+Rails.application.config.after_initialize do
+  Spree::Dependencies.current_store_finder = 'Spree::Stores::FindCurrent'
+
+  Spree.metafields.enabled_resources << Spree::CustomDomain
+
+  Spree::PermittedAttributes.store_attributes.push(
+    :import_products_from_store_id,
+    :import_payment_methods_from_store_id
+  )
+
+  if defined?(Spree::Admin)
+    Spree.admin.partials.product_form_sidebar << 'spree/admin/products/form/stores'
+  end
+
+  # Multi-store setup
+  # You need to set a wildcard `root_domain` on the store to enable multi-store setup
+  # all new stores will be created in a subdomain of the root domain, eg. store1.localhost, store2.localhost, etc.
+  Spree.root_domain = ENV.fetch('SPREE_ROOT_DOMAIN', 'localhost')
+end

data/config/initializers/spree_multi_store_navigation.rb

@@ -0,0 +1,14 @@
+Rails.application.config.after_initialize do
+  next unless defined?(Spree::Admin)
+
+  settings_nav = Spree.admin.navigation.settings
+
+  # Domains
+  settings_nav.add :domains,
+          label: :domains,
+          url: :admin_custom_domains_path,
+          icon: 'world-www',
+          position: 60,
+          active: -> { controller_name == 'custom_domains' },
+          if: -> { can?(:manage, Spree::CustomDomain) }
+end

data/config/locales/en.yml

@@ -0,0 +1,5 @@
+---
+en:
+  spree:
+    multi_store:
+      name: "Multi-Store"

data/config/routes.rb

@@ -0,0 +1,6 @@
+Spree::Core::Engine.add_routes do
+  namespace :admin, path: Spree.admin_path do
+    resources :stores, only: [:new, :create], controller: 'multi_store/stores'
+    resources :custom_domains, except: :show
+  end
+end

data/lib/spree/multi_store/engine.rb

@@ -0,0 +1,22 @@
+module Spree
+  module MultiStore
+    class Engine < ::Rails::Engine
+      isolate_namespace Spree
+      engine_name 'spree_multi_store'
+
+      # Rails 7.1 introduced a new feature that raises an error if a callback action is missing.
+      # We need to disable it as we use a lot of concerns that add callback actions.
+      initializer 'spree.multi_store.disable_raise_on_missing_callback_actions' do |app|
+        app.config.action_controller.raise_on_missing_callback_actions = false
+      end
+
+      def self.activate
+        Dir.glob(File.join(File.dirname(__FILE__), '../../../app/**/*_decorator*.rb')) do |c|
+          Rails.configuration.cache_classes ? require(c) : load(c)
+        end
+      end
+
+      config.to_prepare(&method(:activate).to_proc)
+    end
+  end
+end

data/lib/spree/multi_store/version.rb

@@ -0,0 +1,5 @@
+module Spree
+  module MultiStore
+    VERSION = '1.0.0'
+  end
+end

data/lib/spree/multi_store.rb

@@ -0,0 +1,3 @@
+require 'spree_core'
+require 'spree/multi_store/version'
+require 'spree/multi_store/engine'

data/lib/spree_multi_store.rb

@@ -0,0 +1 @@
+require 'spree/multi_store'

metadata

@@ -0,0 +1,134 @@
+--- !ruby/object:Gem::Specification
+name: spree_multi_store
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+platform: ruby
+authors:
+- Vendo Connect Inc.
+- Vendo Sp. z o.o.
+bindir: bin
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: spree
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 5.4.0.beta
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 5.4.0.beta
+- !ruby/object:Gem::Dependency
+  name: spree_admin
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 5.4.0.beta
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 5.4.0.beta
+- !ruby/object:Gem::Dependency
+  name: spree_dev_tools
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Adds multi-store switching, custom domains, and store resolution to Spree
+  Commerce
+email: hello@spreecommerce.org
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE.md
+- README.md
+- Rakefile
+- app/controllers/spree/admin/custom_domains_controller.rb
+- app/controllers/spree/admin/multi_store/base_controller_decorator.rb
+- app/controllers/spree/admin/multi_store/stores_controller.rb
+- app/finders/spree/stores/find_current.rb
+- app/helpers/spree/admin/multi_store_helper.rb
+- app/models/concerns/spree/multi_store_resource.rb
+- app/models/concerns/spree/store/multi_store_class_overrides.rb
+- app/models/concerns/spree/store/multi_store_methods.rb
+- app/models/concerns/spree/store/multi_store_overrides.rb
+- app/models/spree/custom_domain.rb
+- app/models/spree/multi_store/payment_method_decorator.rb
+- app/models/spree/multi_store/product_decorator.rb
+- app/models/spree/multi_store/promotion_decorator.rb
+- app/models/spree/multi_store/store_decorator.rb
+- app/views/spree/admin/custom_domains/_custom_domain.html.erb
+- app/views/spree/admin/custom_domains/_custom_domains.html.erb
+- app/views/spree/admin/custom_domains/_form.html.erb
+- app/views/spree/admin/custom_domains/edit.html.erb
+- app/views/spree/admin/custom_domains/index.html.erb
+- app/views/spree/admin/custom_domains/new.html.erb
+- app/views/spree/admin/multi_store/stores/new.html.erb
+- app/views/spree/admin/multi_store/stores/new.turbo_stream.erb
+- app/views/spree/admin/products/form/_stores.html.erb
+- app/views/spree/admin/shared/sidebar/_store_dropdown.html.erb
+- config/initializers/spree_multi_store.rb
+- config/initializers/spree_multi_store_navigation.rb
+- config/locales/en.yml
+- config/routes.rb
+- lib/spree/multi_store.rb
+- lib/spree/multi_store/engine.rb
+- lib/spree/multi_store/version.rb
+- lib/spree_multi_store.rb
+homepage: https://github.com/spree/spree_multi_store
+licenses:
+- AGPL-3.0-or-later
+metadata:
+  bug_tracker_uri: https://github.com/spree/spree_multi_store/issues
+  changelog_uri: https://github.com/spree/spree_multi_store/releases/tag/v1.0.0
+  documentation_uri: https://docs.spreecommerce.org/
+  source_code_uri: https://github.com/spree/spree_multi_store/tree/v1.0.0
+post_install_message: |
+  --------------------------------------------------------------
+  Thank you for installing Spree Multi-Store!
+
+  This gem is licensed under AGPL-3.0-or-later.
+  To obtain a commercial license for your project,
+  check out Spree Enterprise:
+
+    https://spreecommerce.org/enterprise/
+
+  --------------------------------------------------------------
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '3.2'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements:
+- none
+rubygems_version: 4.0.2
+specification_version: 4
+summary: Multi-store switching and resolution for Spree Commerce
+test_files: []