Saucy is a Rails engine for monthly subscription-style SaaS apps.

Example scenarios covered by Saucy:

  • I sign up for "Free" plan under new account "thoughtbot"
  • I am an admin and can be reached at "[email protected]"
  • I create a project "Hoptoad"
  • I upgrade to the "Basic" plan and my credit card is charged
  • I now have permissions to add users and projects to the "thoughtbot" account
  • I invite "[email protected]" to "Hoptoad"
  • I create a project "Trajectory"
  • I invite "[email protected]" to "Trajectory"


In your Gemfile:

gem "saucy", :git => '[email protected]:thoughtbot/saucy.git'

After you bundle, run the generators:

rails generate saucy:install
rails generate saucy:views

You will want to include the ensure_active_account before_filter in any controller actions that you want to protect if the user is using an past due paid account.

You will want to customize the from email address on billing and invite emails:

Saucy::Configuration.mailer_sender = "[email protected]"

If you have an account with Braintree with multiple merchant accounts you'll want to configure the merchant account for this application:

Saucy::Configuration.merchant_account_id = 'your merchant account id'

In addition, there are a number of strings such as application name, support url, etc. that are provided and customized with i18n translations. You can customize these in your app, and you can see what they are by looking at config/locales/en.yml in saucy.

There is a saucy:daily rake task which should be run on a regular basis to send receipts and payment processing problem emails.

Saucy accounts become "activated" once an initial setup step is complete. This could be creating the first bug for a bug tracker, or setting up a client gem for a server API. Once the application detects that the account is activate, it should set "activated" to true on the account. This will prevent followup emails being sent to users that have already set up their accounts.

Development environment

Plans need to exist for users to sign up for. In db/seeds.rb:

%w(free expensive mega-expensive).each do |plan_name|

Then run: rake db:seed

Test environment

Generate the Braintree Fake for your specs:

rails generate saucy:specs

Generate feature coverage:

rails generate saucy:features

To use seed data in your Cucumber, add this to features/support/seed.rb:

require Rails.root.join('db','seeds')


By default Saucy uses and provides a saucy.html.erb layout. To change the layout for a controller inside of saucy, add a line like this to your config/application.rb:

config.saucy.layouts.accounts.index = "custom"

In addition to just the normal yield, your layout should yield the following items in order to get everything from saucy views:

  • :header
  • :subnav

To extend the ProjectsController:

class ProjectsController < ApplicationController
  include Saucy::ProjectsController

  def edit
    @deleters = @project.deleters

To define additional limit meters, or override existing limit meters, create the partials:



Make sure you don't do this in ApplicationController:

before_filter :authenticate

Saucy's internal controllers don't skip any before filters.