Beautiful, performant feature flags for Ruby.
Control your software — don't let it control you.
- Update and merge the most recent commit in Drop's Flipper Gemfile.lock (example)
- Once CI is finished on step 1, run the following github action to update the image in ECR (action)
- Update the flipper image tags created by the action in the respective flipper-web.yml files (example)
- Once drop is deployed, flipper should be updated.
Add this line to your application's Gemfile:
gem 'flipper'
And then execute:
$ bundle
Or install it yourself with:
$ gem install flipper
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.
If you prefer a web UI to an IRB console, you can setup the Flipper UI.
It's simple and pretty.
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.
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
A few miscellaneous docs with more info for the hungry.
- Gates - Boolean, Groups, Actors, % of Actors, and % of Time
- Adapters - Mongo, Redis, Cassandra, Active Record...
- Instrumentation - ActiveSupport::Notifications and Statsd
- Optimization - Memoization middleware and Cache adapters
- Web Interface - Point and click...
- API - HTTP API interface
- Caveats - Flipper beware! (see what I did there)
- Docker-Compose - Using docker-compose in contributing
- Fork it
- Create your feature branch (
git checkout -b my-new-feature
) - Run the tests (
bundle exec rake
) - Commit your changes (
git commit -am 'Added some feature'
) - Push to the branch (
git push origin my-new-feature
) - Create new Pull Request
- Update the version to be whatever it should be and commit.
script/release
- Profit.
pic | @mention | area |
---|---|---|
@jnunemaker | most things | |
@alexwheeler | api | |
@thetimbanks | ui | |
@lazebny | docker |