Flipper

Beautiful, performant feature flags for Ruby.

Control your software — don't let it control you.

Installation

Add this line to your application's Gemfile:

gem 'flipper'

And then execute:

$ bundle

Or install it yourself with:

$ gem install flipper

Getting Started

Flipper is built on adapters for maximum flexibility. Regardless of what data store you are using, Flipper can performantly store data in it.

To get started, pick one of our supported adapters and follow the instructions:

Or roll your own. We even provide automatic (rspec and minitest) tests for you, so you know you've built your custom adapter correctly.

Once you've selected an adapter and followed the installation instructions, you should be good to go.

Flipper UI

If you prefer a web UI to an IRB console, you can setup the Flipper UI.

It's simple and pretty.

Flipper Cloud

Or, (even better than OSS + UI) use Flipper Cloud which comes with:

everything in one place — no need to bounce around from different application UIs or IRB consoles.
permissions — grant access to everyone in your organization or lockdown each project to particular people.
multiple environments — production, staging, enterprise, by continent, whatever you need.
personal environments — no more rake scripts or manual enable/disable to get your laptop to look like production. Every developer gets a personal environment that inherits from production that they can override as they please (read more).
no maintenance — we'll keep the lights on for you. We also have handy webhooks for keeping your app in sync with Cloud, so our availability won't affect yours. All your feature flag reads are local to your app.
audit history — every feature change and who made it.
rollbacks — enable or disable a feature accidentally? No problem. You can roll back to any point in the audit history with a single click.

Cloud is super simple to integrate with Rails (demo app), Sinatra or any other framework.

Examples

Want to get a quick feel for what it looks like to work with Flipper? Check out the following example or the examples directory. You might also want to peek at the DSL and Feature classes for code/docs.

require 'flipper'

Flipper.configure do |config|
  config.default do
    # pick an adapter, this uses memory, any will do, see docs above
    adapter = Flipper::Adapters::Memory.new

    # pass adapter to handy DSL instance
    Flipper.new(adapter)
  end
end

# check if search is enabled
if Flipper.enabled?(:search)
  puts 'Search away!'
else
  puts 'No search for you!'
end

puts 'Enabling Search...'
Flipper.enable(:search)

# check if search is enabled
if Flipper.enabled?(:search)
  puts 'Search away!'
else
  puts 'No search for you!'
end