Skip to content
Spree is a complete open source e-commerce solution for Ruby on Rails.
Pull request Compare This branch is 2 commits ahead, 13531 commits behind spree:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.
api
core
dashboard
features
payment_gateway
promotions
sample
.gitignore
CHANGELOG
Gemfile
Gemfile.lock
INSTALL
README.md
SPREE_VERSION
sandbox_template.rb
spree.gemspec

README.md

SUMMARY

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.

QUICK START

Running the Gem

TODO

Browse Store

http://localhost:nnnn/store

Browse Admin Interface

http://localhost:nnnn/admin

Working with the edge source (latest and greatest features)

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.

  1. Clone the git repo

    git clone git://github.com/railsdog/spree.git spree
    cd spree
    
  2. Install the gem dependencies

    bundle install
    
  3. Create a sanbox rails application for testing purposes

    rails new sandbox -T -m sandbox_template.rb
    cd sandbox
    
  4. Sync the migrations and other assets in your new sandbox app

    rake spree:sync
    
  5. Bootstrap the database (run the migrations, create admin account, optionally load sample data.)

    rake db:bootstrap
    
  6. Prepare the test database (optional - only if you're going to run the tests)

    rake db:test:prepare
    
  7. Start the server

    rails server
    

Running Tests

Once you have the edge source working (see above) you can run the tests as follows

  1. Change to the directory containing the engine/gem to test

    cd core
    
  2. Run the tests

    rspec spec
    

Contributing

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.

Something went wrong with that request. Please try again.