Skip to content


Repository files navigation



Adds Handling Fee functionality to Spree.


Add solidus_handling_fees to your Gemfile:

gem 'solidus_handling_fees', github: 'solidusio-contrib/solidus_handling_fees'

Bundle your dependencies and run the installation generator:

bundle exec rails g solidus_handling_fees:install


To create a handling fee, edit a Stock Location in the admin and apply a calculator. For example, you might use the Flat Rate calculator to set a flat fee of $3.99 on all shipments.

If you'd like to specify only certain orders to have a handling fee, override the needs_handling_charge? method in your own Spree::Order decorator.


First bundle your dependencies, then run rake. rake will default to building the dummy app if it does not exist, then it will run specs, and Rubocop static code analysis. The dummy app can be regenerated by using rake test_app.

bundle exec rake

When testing your application's integration with this extension you may use its factories. Simply add this require statement to your spec_helper:

require 'solidus_handling_fees/factories'


Your new extension version can be released using gem-release like this:

bundle exec gem bump -v VERSION --tag --push --remote upstream && gem release

Copyright (c) 2014 Brian Christian, released under the GPL V3.