Repository files navigation

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

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.
• UseFlipper 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 storageadapter, for example:

gem 'flipper-active_record'

And then execute:

$ bundle

Or install it yourself with:

$ gem install flipper

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

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

# check if search is enabledifFlipper.enabled?(:search,current_user)puts'Search away!'elseputs'No search for you!'end

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

# Enable a feature for everyoneFlipper.enable:search# Enable a feature for a specific actorFlipper.enable_actor:search,current_user# Enable a feature for a group of actorsFlipper.enable_group:search,:admin# Enable a feature for a percentage of actorsFlipper.enable_percentage_of_actors:search,2

Read more aboutgetting started with Flipper andenabling features.

Like Flipper and want more? Check outFlipper 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 aproject 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.
• 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, soour 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 afree plan that you can use forever.

1. Fork it
2. Create your feature branch (git checkout -b my-new-feature)
3. Run the tests (bundle exec rake). Check outDocker-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. Create a newGitHub Release

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