SkillAgentSearch skills...

Flipt

Enterprise-ready, Git native feature management solution

Install / Use

/learn @flipt-io/Flipt

README

<img referrerpolicy="no-referrer-when-downgrade" src="https://static.scarf.sh/a.png?x-pxid=dc285028-90ba-436b-9a4a-e0d826a2c986" alt="" /> <p align=center> <img src="logo.svg" alt="Flipt" width=275 height=96 /> </p> <p align="center">The Git-native, enterprise-ready feature management platform that developers love</p> <hr /> <p align="center"> <img src=".github/images/dashboard.png" alt="Flipt Dashboard" width=600 /> </p> <br clear="both"/> <div align="center"> <!-- <a href="https://github.com/flipt-io/flipt/releases"> <img src="https://img.shields.io/github/release/flipt-io/flipt.svg?style=flat" alt="Releases" /> </a> --> <img src="https://img.shields.io/badge/status-stable-green" alt="Flipt v2 Stable" /> <a href="https://goreportcard.com/report/github.com/flipt-io/flipt"> <img src="https://goreportcard.com/badge/github.com/flipt-io/flipt" alt="Go Report Card" /> </a> <a href="https://github.com/avelino/awesome-go"> <img src="https://awesome.re/mentioned-badge.svg" alt="Mentioned in Awesome Go" /> </a> <a href="https://flipt.io/discord"> <img alt="Discord" src="https://img.shields.io/discord/960634591000014878?color=%238440f1&label=Discord&logo=discord&logoColor=%238440f1&style=flat" /> </a> <a href="https://deepwiki.com/flipt-io/flipt"> <img src="https://deepwiki.com/badge.svg" alt="Ask DeepWiki"> </a> </div> <div align="center"> <h4> <a href="https://docs.flipt.io/v2/introduction">Docs</a> • <a href="http://www.flipt.io">Website</a> • <a href="http://blog.flipt.io">Blog</a> • <a href="#contributing">Contributing</a> • <a href="https://www.flipt.io/discord">Discord</a> </h4> </div>

[!NOTE]
Looking for Flipt v1? You can find the v1 code on the main branch and documentation at docs.flipt.io.

Why Flipt v2?

Finally, feature flags that work with your existing Git workflow.

Flipt v2 is the first truly Git-native feature management platform that treats your feature flags as code. Store your flags in your own Git repositories, use your existing branching strategy, and deploy flags alongside your code using the tools you already know and trust.

🚀 Git-Native by Design

  • Own your data: Store feature flags directly in your Git repositories
  • Version control: Full history and blame for every flag change
  • Branch and merge: Test flag changes in branches before merging to production
  • Deploy together: Feature flags deploy with your code using existing CI/CD pipelines

🌍 Multi-Environment with Git Flexibility

  • Environment per branch: Map environments to Git branches for seamless workflows
  • Environment per directory: Organize flags by microservice or team within a single repo
  • Environment per repository: Separate repos for different products or security domains
  • Complete isolation: Each environment has its own namespaces, flags, and configurations

Developer Experience First

  • Zero infrastructure: No databases, no external dependencies by default
  • GitOps ready: Works with existing Git-based deployment workflows
  • Real-time updates: Server-Sent Events (SSE) streaming API for instant flag propagation to client-side SDKs without polling
  • Modern UI: Intuitive interface with full Git integration and dark mode support

🔒 Enterprise Security & Control

  • Self-hosted: Keep sensitive flag data within your infrastructure
  • Secrets management: Secure storage and retrieval of sensitive configuration data (OSS)
  • GPG commit signing: Cryptographically sign all flag changes for enhanced security (Pro feature)
  • Merge proposals: Code review workflow for flag changes (Pro feature)
  • Audit trails: Complete history of who changed what and when
  • OIDC/JWT/OAuth: Enterprise authentication methods supported
<br clear="both"/>

Flipt v1 vs v2: What's New?

| Feature | Flipt v1 | ✨ Flipt v2 | |---------|----------|----------| | Storage | Database-centric (MySQL, PostgreSQL, SQLite) | Git-native with optional SCM sync (GitHub, GitLab, BitBucket, Azure DevOps, Gitea, etc.) | | Environments | Single namespace model | Multi-environment with Git flexibility | | Branching | Not supported | Full Git branching with environment branches | | Data Ownership | Stored in a database (MySQL, PostgreSQL, SQLite) | Stored in your Git repositories alongside your code | | GitOps | Read-only Git integration | Full read/write Git integration | | Deployment | Requires database setup | Zero dependencies - single binary | | Version Control | Basic audit logs | Full Git history and blame | | Merge Process | Direct flag changes | Merge proposals with code review | | Real-time Updates | Polling required | Server-Sent Events (SSE) streaming API for instant updates | | Multi-tenancy | Manual namespace management | Environment-based isolation | | Secrets Management | None | File-based providers available in OSS, HashiCorp Vault, cloud secrets management (AWS Secrets Manager, GCP Secret Manager, Azure Key Vault) available in Pro |

<br clear="both"/>

Use Cases

Perfect for engineering teams that want to:

  • Ship faster with confidence: Deploy flags with your code using existing Git workflows
  • Enable trunk-based development: Merge incomplete features behind flags without risk
  • Implement proper GitOps: Treat infrastructure and feature flags as code
  • Maintain security compliance: Keep sensitive flag data within your infrastructure
  • Scale with multiple environments: Manage flags across dev, staging, and production seamlessly
  • Enable team collaboration: Use familiar Git workflows for flag reviews and approvals
<br clear="both"/>

Quick Start

See our quickstart guide for more details.

Local

# Install Flipt
curl -fsSL https://get.flipt.io/v2 | sh

# Wizard-driven setup to get you started quickly
flipt quickstart

# Run Flipt server
flipt server

Docker

docker run --rm -p 8080:8080 -p 9000:9000 -t docker.flipt.io/flipt/flipt:v2

Flipt UI will be available at http://127.0.0.1:8080/.

Nightly Builds

[!WARNING]
Nightly builds are automatically generated from the latest v2 branch and should not be considered stable for production use.

To run the latest nightly build:

docker run --rm -p 8080:8080 -p 9000:9000 -t docker.flipt.io/flipt/flipt:v2-nightly

Nightly builds include the latest features and bug fixes but may contain untested changes. Use them for testing new features or verifying bug fixes before the next stable release.

Configuration Example

# config.yml - Git-native setup with secrets management
secrets:
  providers:
    # File-based secrets (OSS)
    file:
      enabled: true
      base_path: "/etc/flipt/secrets"
    # HashiCorp Vault (Pro feature)
    vault:
      enabled: true
      address: "https://vault.example.com"
      auth_method: "token"
      token: "hvs.your_token"
      mount: "secret"

storage:
  type: git
  git:
    repository: "https://github.com/your-org/feature-flags.git"
    ref: "main"
    poll_interval: "30s"
    signature:
      enabled: true
      type: "gpg"
      key_ref:
        provider: "vault"  # Requires Pro license
        path: "flipt/signing-key"
        key: "private_key"
      name: "Flipt Bot"
      email: "bot@example.com"

environments:
  default:
    storage: git
  staging:
    storage: git
    directory: "staging"

For more setup options, see our configuration documentation.

<br clear="both"/>

Core Values

  • 🔒 Security - HTTPS, OIDC, JWT, OAuth, K8s Service Token, and API Token authentication methods supported out of the box
  • 🗝️ Secrets Management - Secure storage and retrieval of sensitive data with file-based providers (OSS) and HashiCorp Vault, AWS Secrets Manager, GCP Secret Manager, Azure Key Vault (Pro features)
  • 🎛️ Control - Your data stays in your Git repositories within your infrastructure
  • 🚀 Speed - Co-located with your services, no external API calls required
  • Simplicity - Single binary with no external dependencies by default
  • 🔄 GitOps Ready - Native Git integration that works with your existing workflows
  • 👍 Compatibility - GRPC, REST, Redis, Prometheus, ClickHouse, OpenTelemetry, and more
<br clear="both"/>

Key Features

Git-Native Storage

  • Store flags directly in Git repositories alongside your code
  • Full version control with Git history, blame, and diff support
  • Integrates with your SCM (GitHub, GitLab, BitBucket, Azure DevOps, Gitea, etc.)
  • GPG commit signing for cryptographic verification of changes

Multi-Environment Management

  • Environment per Git branch, directory, or repository
  • Complete environment isolation with independent configurations
  • Seamless environment promotion workflows

Secrets Management & Security

  • Multi-provider secrets management: File-based providers available in OSS, HashiCorp Vault, AWS Secrets Manager, GCP Secret Manager, and Azure Key Vault (Pro features)
  • GPG Commit Signing: Cryptographically sign all flag changes with keys from secret providers (Pro feature)
  • Secure key storage: Private keys and sensitive data stored securely in Vault or local files
  • Multiple auth methods: Token, Kubernetes, and AppRole authentication for Vault

Advanced Flag Management

  • Complex targeting rules and user segmentation
  • Percentage-based rollouts
  • Real-time flag evaluation with Server-Sent Events (SSE) streaming updates for instant synchronization

Developer Experience

  • Modern UI with Git integration and dark mode 🌙
  • Declarative flag configuration with JSON/YAML schemas

Related Skills

View on GitHub
GitHub Stars4.8k
CategoryOperations
Updated3h ago
Forks280

Languages

Go

Security Score

85/100

Audited on Mar 24, 2026

No findings