Skip to content

Home

Jump to bottom
Kasun Ranasinghe edited this page Sep 8, 2025 · 2 revisions

Flux Gate Wiki

Welcome to the Flux Gate documentation! This is a powerful, enterprise-grade feature flag management system built with Rust, offering high performance and scalability for modern applications.

🚀 Overview

Flux Gate is a distributed system consisting of:

  • Backend Server: GraphQL API for management and gRPC for evaluation
  • Edge Server: High-performance evaluation endpoint with caching
  • Evaluation Engine: Fast feature flag evaluation with contextual targeting
  • PostgreSQL Database: Persistent storage with comprehensive schema
  • Web Dashboard: React-based management interface

📚 Documentation Sections

Getting Started

User Management

Core Features

Advanced Topics

Troubleshooting

🏗️ Architecture

┌─────────────────┐    ┌─────────────────┐    
│   Web Client    │    │  Micro Service  │   
└─────────────────┘    └─────────────────┘   
         │                       │            
         │ GraphQL               │ REST            
         │                       │ 
         v                       v 
┌─────────────────┐ gRPC   ┌─────────────────┐ 
│  Backend Server │───────>│  Edge Server    │
│  (Port 8080)    │        │  (Port 8081)    │
└─────────────────┘        └─────────────────┘
         │                       │
         │                       │
         v                       v
┌─────────────────────────────────────────────────────────────────┐
│                    PostgreSQL Database                          │
└─────────────────────────────────────────────────────────────────┘

🎯 Key Features

  • High Performance: Rust-based implementation for maximum throughput
  • Enterprise Security: JWT-based authentication with RBAC
  • Flexible Targeting: Context-based feature evaluation
  • Team Management: Multi-tenant architecture with team isolation
  • Pipeline Workflows: Staged deployments with approval processes
  • Multi-environment support: Manage features across development, staging, and production
  • Real-time Updates: gRPC streaming for instant flag updates
  • Edge Caching: Distributed evaluation with local caching
  • GraphQL API: Modern, type-safe API for management operations
  • Docker Ready: Complete containerization with docker-compose
  • Database Migrations: Versioned schema management with SQLx

🛠 Technical Stack

  • Frontend: Rust + React + TypeScript + Vite
  • State Management: Apollo Client + GraphQL
  • UI Components: Custom components with Tailwind CSS
  • Authentication: JWT-based with role management
  • Deployment: Docker-ready with configurable environments

🤝 Contributing

Please read our Contributing Guidelines before submitting pull requests.

📄 License

This project is licensed under the terms specified in the LICENSE file.

🆘 Support

Clone this wiki locally