Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?


Failed to load latest commit information.
Latest commit message
Commit time
February 15, 2023 15:10
March 20, 2023 15:20
November 12, 2021 15:58
March 21, 2023 17:36
March 21, 2023 17:36
September 13, 2019 08:58
May 10, 2021 13:00
November 29, 2021 10:39
August 25, 2022 17:05
March 20, 2023 19:09
March 17, 2023 10:19
July 22, 2012 15:43
June 12, 2020 11:27

Flipper Mark

Website | Documentation | Examples | Twitter


Beautiful, performant feature flags for Ruby.

Flipper gives you control over who has access to features in your app.

  • Enable or disable features for everyone, specific actors, groups of actors, a percentage of actors, or a percentage of time.
  • Configure your feature flags from the console or a web UI.
  • Regardless of what data store you are using, Flipper can performantly store your feature flags.
  • Use Flipper Cloud to cascade features from multiple environments, share settings with your team, control permissions, keep an audit history, and rollback.

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


Add this line to your application's Gemfile:

gem 'flipper'

You'll also want to pick a storage adapter, for example:

gem 'flipper-active_record'

And then execute:

$ bundle

Or install it yourself with:

$ gem install flipper

Subscribe & Ship

💌  Subscribe - I'll send you short and sweet emails when we release new versions.

Getting Started

Use Flipper#enabled? in your app to check if a feature is enabled.

# check if search is enabled
if Flipper.enabled? :search, current_user
  puts 'Search away!'
  puts 'No search for you!'

All features are disabled by default, so you'll need to explicitly enable them.

# Enable a feature for everyone
Flipper.enable :search

# Enable a feature for a specific actor
Flipper.enable_actor :search, current_user

# Enable a feature for a group of actors
Flipper.enable_group :search, :admin

# Enable a feature for a percentage of actors
Flipper.enable_percentage_of_actors :search, 2

Read more about getting started with Flipper and enabling features.

Flipper Cloud

Like Flipper and want more? Check out 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.

Flipper Cloud Screenshot

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


  1. Fork it
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Run the tests (bundle exec rake). Check out Docker-Compose if you need help getting all the adapters running.
  4. Commit your changes (git commit -am 'Added some feature')
  5. Push to the branch (git push origin my-new-feature)
  6. Create new Pull Request


  1. Update the version to be whatever it should be and commit.
  2. script/release
  3. Profit.

Brought To You By

pic @mention area
@jnunemaker @jnunemaker most things
@bkeepers @bkeepers most things
@dpep @dpep tbd
@alexwheeler @alexwheeler api
@thetimbanks @thetimbanks ui
@lazebny @lazebny docker