Spree is a complete open source commerce solution for Ruby on Rails. It was developed by Sean Schofield under the original name of Rails Cart before changing its name to Spree.
Refer to the Spree ecommerce project page to learn more.
TODO
The source code is essentially a collection of gems. Spree is meant to be run within the context of Rails application. You can easily create a sandbox application inside of your cloned source directory for testing purposes.
-
Clone the git repo
git clone git://github.com/railsdog/spree.git spree cd spree
-
Install the gem dependencies
bundle install
-
Create a sanbox rails application for testing purposes
rails new sandbox -m sample/sandbox_template.rb cd sandbox
-
Generate the necessary Spree files
NOTE: We'll soon have a single convenience generator for running each of these
rails g spree_core:install
rails g spree_api:install
rails g spree_auth:install
rails g spree_dashboard:install
rails g spree_payment_gateway:install
rails g spree_promotions:install
rails g spree_sample:install
-
Bootstrap the database (run the migrations, create admin account, optionally load sample data.)
rake db:bootstrap
-
Prepare the test database (optional - only if you're going to run the tests)
rake db:test:prepare
-
Start the server
rails server
Once you have the edge source working (see above) you can run the tests as follows
-
Change to the directory containing the engine/gem to test
cd core
-
Run the tests
rspec spec
Spree is an open source project. We encourage contributions. Please see the contributors guidelines before contributing. Do not send a Github pull request - it will be ignored.