Skip to content


Subversion checkout URL

You can clone with
Download ZIP
Spree Commerce extension to list your retail store locations.
Ruby JavaScript

Spree Retailers Build Status

Spree Retailers is a Spree extension for listing your company's retail stores on your web site.


As usual, add 'spree_retailers' to your Gemfile and run bundle install:

# Spree 1.1.x
gem 'spree_retailers', :git => 'git://'

# Spree 1.0.x
gem 'spree_retailers', ''

# Spree 0.70.x
gem 'spree_retailers', ''

# Spree 0.50.x, 0.60.x
gem 'spree_retailers', ''

# Spree 0.40.x 
gem 'spree_retailers', ''

# install from source
gem 'spree_retailers', :git => 'git://'

Next, copy the migration file to your project:

# Spree 0.40.x, 0.50.x and 0.60.x
rake spree_retailers:install

# 0.70.x and above
rails g spree_retailers:install

Now, migrate your database with:

rake db:migrate

CSV Import

To import retailers via a CSV:

rake spree_retailers:import FILE=international_distributors.csv TYPE=Distributors SKIP_VALIDATION=true

Where the CSV file contains headers with the following names:
name, address, city, state, country, zipcode, phone, email, url, logo. SKIP_VALIDATION is only really helpful when you importing data that is missing the address fields


If you'd like to run tests:

git clone git://
cd spree_retailers
bundle install
bundle exec dummier
bundle exec rake


If you'd like a demo of spree_retailers:

git clone git://
cd spree_retailers
cp test/dummy_hooks/after_migrate.rb.sample test/dummy_hooks/after_migrate.rb
bundle install
bundle exec dummier
cd test/dummy
rails s


If you'd like to help out feel free to fork and send me pull requests!

To Do

  • Google map integration (we're already geocoding, so why not?)
  • Add (better) International Support


Copyright (c) 2011 - 2012 Spencer Steffen and Citrus, released under the New BSD License All rights reserved.

Something went wrong with that request. Please try again.