# Flipper Cloud

> Feature flags for Ruby. Beautiful, performant, and simple. Used by GitHub, Shopify, Dropbox, and thousands of Ruby applications.

## Docs

### Open Source

- [Get Started with Flipper](https://www.flippercloud.io/docs/introduction): The official docs for the Flipper gem and Flipper Cloud.
- [What can Flipper do?](https://www.flippercloud.io/docs/uses): Feature flags provide an incredible amount of flexibility for shipping code as well as controlling other aspects of your app's code.
- [Getting Started](https://www.flippercloud.io/docs/get-started): Setting up Flipper takes only a few minutes.
- [Get Started with Flipper Cloud on Rails](https://www.flippercloud.io/docs/get-started/cloud): Connect a Rails app to Flipper Cloud in a few minutes: add the gem, set FLIPPER_CLOUD_TOKEN, and gate any code path with a feature flag.
- [Get Started with Flipper Cloudless on Rails](https://www.flippercloud.io/docs/get-started/self-hosted): Set up open source Flipper in a Rails app without Cloud: add the gem and an adapter, run the generator, and gate any code path with a feature flag.
- [Adapters](https://www.flippercloud.io/docs/adapters): Flipper is built on adapters for maximum flexibility. Regardless of what data store you are using, Flipper can performantly store data in it.
- [ActiveRecord Adapter](https://www.flippercloud.io/docs/adapters/active-record): An ActiveRecord adapter for Flipper to use in production Rails applications.
- [ActiveSupportCacheStore Adapter](https://www.flippercloud.io/docs/adapters/active-support-cache-store): An ActiveSupportCacheStore adapter for Flipper.
- [Failsafe Adapter](https://www.flippercloud.io/docs/adapters/failsafe): Wraps another adapter and fails safely when an exception is raised. This prevents issues like network hiccups from taking down an application using Flipper.
- [HTTP Adapter](https://www.flippercloud.io/docs/adapters/http): HTTP adapter for use with the Flipper API.
- [Moneta Adapter](https://www.flippercloud.io/docs/adapters/moneta): A Moneta adapter for Flipper.
- [Mongo Adapter](https://www.flippercloud.io/docs/adapters/mongo): A MongoDB adapter for Flipper.
- [Create a New Adapter](https://www.flippercloud.io/docs/adapters/new): If you would like to make your own adapter, there are shared adapter specs (RSpec) and tests (MiniTest) that you can use to verify that you have everything working correctly.
- [Pstore Adapter](https://www.flippercloud.io/docs/adapters/pstore): A Pstore adapter for Flipper.
- [Read-only Adapter](https://www.flippercloud.io/docs/adapters/read-only): A read-only adapter for Flipper.
- [Redis Adapter](https://www.flippercloud.io/docs/adapters/redis): A Redis adapter for Flipper.
- [Rollout Adapter](https://www.flippercloud.io/docs/adapters/rollout): A Rollout adapter for importing Rollout data into Flipper.
- [Sequel Adapter](https://www.flippercloud.io/docs/adapters/sequel): A Sequel adapter for Flipper.
- [Strict Adapter](https://www.flippercloud.io/docs/adapters/strict): Catch typos and missing feature flags early by raising errors or warnings when an unknown feature is checked.
- [Features](https://www.flippercloud.io/docs/features): Features are the heart of Flipper. They allow you to control code execution by enabling features in certain conditions.
- [Boolean](https://www.flippercloud.io/docs/features/boolean): Boolean features are either enabled or disable for all users.
- [Actors](https://www.flippercloud.io/docs/features/actors): Enable features for a specific user, organization, or any other unique record. These are all called "Actors" in Flipper.
- [Percentage of Actors](https://www.flippercloud.io/docs/features/percentage-of-actors): Enable features for a percentage of actors.
- [Percentage of Time](https://www.flippercloud.io/docs/features/percentage-of-time): Enable features for a percentage of time.
- [Groups](https://www.flippercloud.io/docs/features/groups): Enable features for a set of actors that share a common trait, which is determined by a configurable block at runtime.
- [Expressions](https://www.flippercloud.io/docs/features/expressions): Enable features by defining rules that evaluate against properties of an actor and a feature context.
- [Testing](https://www.flippercloud.io/docs/testing): Advice and insights related to best practices for testing feature flags in your application.
- [Flipper UI](https://www.flippercloud.io/docs/ui): Flipper UI is a self-hosted web interface that gives you access to the basics but does not offer the full functionality of Flipper Cloud.
- [Flipper::Api](https://www.flippercloud.io/docs/api): See how the Flipper API works and how to use it.

### Cloud

- [Flipper Cloud](https://www.flippercloud.io/docs/cloud): Hosted feature flag management with audit history, environments, permissions, and integrations.
- [Configuration](https://www.flippercloud.io/docs/configuration): Flipper Cloud offers a variety of configuration options as well as adapters so you can be confident it works smoothly with your application.
- [Environments](https://www.flippercloud.io/docs/cloud/environments): Model your development lifecycle with production, personal, and custom environments in Flipper Cloud.
- [Permissions](https://www.flippercloud.io/docs/cloud/permissions): Control access to your Flipper Cloud organization, projects, and environments with role-based permissions.
- [Organizing Features](https://www.flippercloud.io/docs/cloud/organizing): Keep your feature flags organized with longevity, owners, and tags in Flipper Cloud.
- [Audit History](https://www.flippercloud.io/docs/cloud/audit-history): Track every feature flag change with a complete audit trail and one-click rollbacks in Flipper Cloud.
- [Telemetry](https://www.flippercloud.io/docs/cloud/telemetry): Monitor feature flag usage with real-time telemetry in Flipper Cloud.
- [Webhooks](https://www.flippercloud.io/docs/cloud/webhooks): Keep your application in sync with Flipper Cloud using webhooks for instant feature flag updates.
- [Slack Integration](https://www.flippercloud.io/docs/cloud/slack): Receive Slack notifications when feature flags change in your Flipper Cloud environments.
- [Search](https://www.flippercloud.io/docs/search): Use Command+K to quickly navigate Flipper Cloud
- [Cloud API](https://www.flippercloud.io/docs/cloud/api): Flipper Cloud API reference including features, gates, audits, and telemetry endpoints.

### Pro

- [Flipper Pro](https://www.flippercloud.io/docs/pro): Self-hosted feature flag administration. Flipper Cloud's polished UI on your infrastructure.
- [Flipper Pro Features](https://www.flippercloud.io/docs/pro/features): Self-hosted admin dashboard, expressions UI, audit log, call sites, multi-database support, and large actor sets.
- [Installing Flipper Pro](https://www.flippercloud.io/docs/pro/installation): Install Flipper Pro in your Rails app. Gemfile, migrations, engine mount, authentication, multi-database support.
- [Flipper Pro Pricing](https://www.flippercloud.io/docs/pro/pricing): Simple, flat rate per organization.
- [Flipper Pro FAQ](https://www.flippercloud.io/docs/pro/faq): Common questions about Flipper Pro. Phone-home behavior, databases, license, upgrades, trials.
- [Flipper Pro EULA](https://www.flippercloud.io/docs/pro/eula): End-user license agreement for Flipper Pro 0.2.6.

### Guides

- [Naming Conventions for Feature Flags](https://www.flippercloud.io/docs/guides/naming): Learn how to structure and name your feature flags for maximum clarity and consistency.
- [Using Flags to Launch New Features](https://www.flippercloud.io/docs/guides/launch): Learn how to use feature flags to build and launch new functionality with advice for the development process and iteratively expanding the size of the audience that has access to the new functionality.
- [Upgrade from Open Source to Cloud](https://www.flippercloud.io/docs/guides/migration): Learn how to safely upgrade from only using the self-hosted version of Flipper to using Flipper Cloud to manage your feature flags.
- [Let People Opt-in to New Features](https://www.flippercloud.io/docs/guides/opt-in): Learn how to user feature flags to let end users opt-in to new functionality on their terms instead of forcing them to adapt on your timeline.
- [Using Circuit Breaker Feature Flags](https://www.flippercloud.io/docs/guides/circuit-breakers): Learn how to use feature flags as circuit breakers for both internal and external services to mitigate downtime.
- [Feature Flags for Backup Providers](https://www.flippercloud.io/docs/guides/backup-providers): Learn how to use feature flags to prevent downtime by switching to a backup service provider in real time.

### Reference

- [CLI](https://www.flippercloud.io/docs/cli): Since 1.2.0, Flipper comes with a CLI to inspect the current state of your feature flags, and to enable or disable them.
- [Optimization](https://www.flippercloud.io/docs/optimization): Learn the various options for optimizing the performance of feature flag checks based on your application's configuration and performance requirements.
- [Instrumentation](https://www.flippercloud.io/docs/instrumentation): Learn how to instrument Flipper to be notified of feature operations and events.

### Product

- [Feature flags aren't just for features any more.](https://www.flippercloud.io/product/benefits/flexibility): Remove the friction from countless development tasks and tools with controls for anything in personal development environments.
- [Seamlessly Organize and Manage Feature Flags](https://www.flippercloud.io/product/benefits/organization): Projects, environments, and permissions that ensure you control the feature flags rather than having them control you.
- [Your feature flag data and no blocking requests.](https://www.flippercloud.io/product/benefits/resiliency): Flipper is designed to never take your app down—even if Flipper Cloud goes offline temporarily.
- [Launches and deploys can be much less stressful.](https://www.flippercloud.io/product/benefits/safety): Roll out new features gradually over time, and roll back instantly and effortlessly if something goes wrong.
- [Strategically release new features and functionality.](https://www.flippercloud.io/product/benefits/strategies): Roll out new features on your schedule—not just when the code is deployed. And if something is off, roll it back without redeploying either.

## Pricing

- [Plans](https://www.flippercloud.io/pricing): Free plan available, paid plans with 14-day free trial

## Code

- [GitHub Repository](https://github.com/flippercloud/flipper): Open source gem with 3,900+ stars
- [RubyGems](https://rubygems.org/gems/flipper): Install via `gem install flipper`

## Optional

- [Blog](https://www.flippercloud.io/blog): Product updates and feature flag best practices