flipt

An open-source, on-prem feature flag solution

---

Flipt is an open source, on-prem feature flag application that allows you to run experiments across services in your environment.

Flipt can be deployed within your existing infrastructure so that you don't have to worry about your information being sent to a third party or the latency required to communicate across the internet.

Flipt supports use cases such as:

• Simple on/off feature flags to toggle functionality in your applications
• Rolling out features to a percentage of your customers
• Using advanced segmentation to target and serve users based on custom properties that you define

Features

• Fast. Written in Go. Optimized for performance
• Stand alone, easy to run and configure
• Ability to create advanced distribution rules to target segments of users
• Native GRPC client SDKs to integrate with your existing applications easily
• Powerful REST API
• Modern, mobile friendly 📱 UI and debug console
• Support for multiple databases (Postgres, MySQL, SQLite)
• Data import and export to allow storing your data as code

Values

• 🔒 Security - HTTPS support. No data leaves your servers and you don't have to open your systems to the outside world to communicate with Flipt. It all runs within your existing infrastructure.
• 🚀 Speed - Since Flipt is co-located with your existing services, you do not have to communicate across the internet which can add excessive latency and slow down your applications.
• ✅ Simplicity - Flipt is a single binary with no external dependencies by default.
• 👍 Compatibility - REST, GRPC, MySQL, Postgres, SQLite.. Flipt supports it all.

Try It

Try the latest version of Flipt out for yourself.

Sandbox

Try Flipt in a deployed environment!

Note: The database gets cleared every 30 minutes in this sandbox environment!

Docker

❯ docker run --rm -p 8080:8080 -p 9000:9000 -t markphelps/flipt:latest

Flipt UI will now be reachable at http://127.0.0.1:8080/.

For more permanent methods of running Flipt, see the Installation section.

Integration

Checkout the integration docs for more info on how to integrate Flipt into your existing application.

REST API

Flipt is equipped with a fully functional REST API. In fact, the Flipt UI is completely backed by this same API. This means that anything that can be done in the Flipt UI can also be done via the REST API.

The Flipt REST API can also be used with any language that can make HTTP requests.

Official GRPC Client Libraries

• Go
• Ruby

Third-Party Client Libraries

Client libraries built by awesome people from the Open Source community:

Library	Language	Author	Desc
flipt-grpc-python	Python	@getsentry	Python GRPC bindings for Flipt
rflipt	React	@christopherdiehl	Components/example project to control React features backed by Flipt
flipt-php	PHP	@fetzi	Package for evaluating feature flags via the Flipt REST API using HTTPlug
flipt-js	Javascript	@betrybe	Flipt library for JS that allows rendering components based on Feature Flags 🎉

Generate Your Own

If a client in your language is not available for download, you can easily generate one yourself using the existing protobuf definition. The GRPC documentation has extensive examples on how to generate GRPC clients in each supported language.

Examples

Check out the examples to see how Flipt works.

Here's a basic one to get started!

Licensing

There are currently two types of licenses in place for Flipt:

1. Client License
2. Server License

Client License

All of the code required to generate GRPC clients in other languages as well as the existing GRPC Go client are licensed under the MIT License.

This code exists in the rpc/ directory.

The client code is the code that you would integrate into your applications, which is why a more permissive license is used.

Server License

The server code is licensed under the GPL 3.0 License.

See LICENSE.

Logos

Paradigm

Rokt

Using Flipt at your company? Open a PR and add your logo here!

Sponsors

If you use Flipt at your company, please consider becoming a sponsor today.

Enterprise

Need more features or support using Flipt within your Enterprise?

Please help me prioritize an Enterprise version of Flipt by filling out this short survey!

Community

For help and discussion around Flipt, feature flag best practices, and more, join us on Discord.

Author

Mark Phelps

Contributing

I would love your help! Before submitting a PR, please read over the Contributing guide.

No contribution is too small, whether it be bug reports/fixes, feature requests, documentation updates, or anything else that can help drive the project forward.

Contributors ✨

Thanks goes to these wonderful people (emoji key):

Aaron Raff 💻	Rodrigo Chacon 💻	Christopher Diehl 💻	Andrew Z Allen 📖	Sebastien Armand 💻	Dat Tran 💻	Jon Perl ⚠️ 💻
Or Elimelech 💻	giddel 💻	Eduardo 📖 💻	Itai Schwartz 💻	Ikko Ashimine 📖	Márk Sági-Kazár 💻	Dan Piet 💻
Amay Shah 💻	kevin-ip 💻	albertchae 💻

This project follows the all-contributors specification. Contributions of any kind welcome!