flipt: A Go repository from aratik711

An open-source, on-prem feature flag solution

Documentation | Features | Values | Examples | Enterprise

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 applications
Simple REST API
Modern UI and debug console
Support for multiple databases (Postgres, MySQL, SQLite)
Data import and export to allow storing your flags 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.
⛔ Privacy - No telemetry data is collected or sent by Flipt. Ever.
👍 Compatibility - REST, GRPC, MySQL, Postgres, SQLite.. Flipt supports it all.

Examples

Check out the examples to see how Flipt works.

Here's a basic one to get started!

Try It

Try Flipt out yourself with 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.

Licensing

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

Client License
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

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

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!

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 💻