Website | Documentation | Examples | Chat | Twitter | Ruby.social

Flipper

Beautiful, performant feature flags for Ruby and Rails.

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, rollback, and let AI assistants find flags ready to remove.

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

Installation

Rails

bundle add flipper-active_record
bin/rails g flipper:setup
bin/rails db:migrate

flipper-active_record brings in flipper and stores your features in your database. flipper:setup creates config/initializers/flipper.rb and the migration. Prefer Redis, Sequel, or something else? Pick another adapter. Add flipper-ui for a web UI.

To move your features to Flipper Cloud later (free plan, no token needed to start):

bundle exec flipper cloud migrate

Cloud support is built into the flipper gem; the separate flipper-cloud gem is deprecated.

Other Ruby apps

Add this line to your application's Gemfile:

gem 'flipper'

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

gem 'flipper-redis'

And then execute:

$ bundle

Or install it yourself with:

$ gem install flipper

Subscribe & Ship

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

Merch

Do you deploy on Fridays? 👕 Get the tee.

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!'
else
  puts 'No search for you!'
end

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:

• multiple environments — production, staging, per continent, whatever you need. Every environment inherits from production by default and every project comes with a project overview page that shows each feature and its status in each environment.
• personal environments — everyone on your team gets a personal environment (that inherits from production) which they can modify however they want without stepping on anyone else's toes.
• permissions — grant access to everyone in your organization or lockdown each project to particular people. You can even limit access to a particular environment (like production) to specific people.
• 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.
• MCP server — connect Claude Code, Codex, Cursor, or any other AI assistant to your flags with our MCP server. Ask "Which Flipper flags can we remove?" and it checks every environment, your telemetry, and your audit history, then tells you which flags are done and why.
• maintenance — we'll keep the lights on for you. We also have handy webhooks and background polling 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.
• everything in one place — no need to bounce around from different application UIs or IRB consoles.

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

We also have a free plan that you can use forever.

This is the beginning of the README. Read the rest at the original. Read the full README ↗