More info

Part of the Getting Started with Shoppe series

Setting up in a new application

View screencast instead? - watch this quick screencast to see how to install Shoppe into a new Rails application.

To begin, we need to create a basic Rails application for our Store. We're going to call our store Widgets Inc.

$ rails new widget_shop

Your Rails application will be created in a directory called widget_shop. Open this up and add the following to your Gemfile.


gem 'shoppe', '~> 1.0'

Once added and saved, you need to reload your bundle:

$ bundle

You now need to run a few generators which will add various content to your local Rails application.

$ rails generate shoppe:setup
$ rails generate nifty:key_value_store:migration

The first of these will add a route to your config/routes.rb file specifying that your Shoppe admin interface will be mounted at /shoppe. The second two will create database migrations used by two dependencies of Shoppe. Nifty Attachments is used to store images in your database and the Nifty Key Value Store is used to store key/values for certain Shoppe models.

Next up is adding the appropriate tables to your database and loading the initial data needed for Shoppe. You may need to migrate the database twice for it to setup the tables for Shoppe.

$ rake db:migrate shoppe:setup

Shoppe ships with a set of data which can be very useful while developing. It includes a number of products, delivery services & tax rates. We will go ahead and load this data into our datbase.

$ rake shoppe:seed

Starting your application

The Shoppe system is now added to your application. Let's start it up and confirm it's working as we would expect.

$ rails server
# => Booting WEBrick
# => Rails 4.2.0 application starting in development on
# => Run `rails server -h` for more startup options
# => Ctrl-C to shutdown server
# [2013-10-29 14:35:09] INFO  WEBrick 1.3.1
# [2013-10-29 14:35:09] INFO  ruby 2.1.5 (2014-11-13) [x86_64-darwin14.0]
# [2013-10-29 14:35:09] INFO  WEBrick::HTTPServer#start: pid=5213 port=3000

Once the server is up and running, go ahead and navigate to http://localhost:3000/shoppe. You will be asked for a username & password, enter and password. You can change these from the Users page within here however for development we can leave them as-is.