How nayanjaiswal1/flagforge-feature-flags works
FlagForge is a multi-tenant feature-flag control plane. Application code supplies a tenant/user/environment context to an evaluation engine, which loads definitions and tenant overrides, resolves targeting and rollout rules, and returns flag values. Django and FastAPI expose framework-specific evaluation and management; storage and cache backends are pluggable, while the CLI and YAML loader support configuration. The React package fetches resolved values for frontend use. Some integrations are documented but unsampled, so their internal wiring is shown only where the README or source index supports it.
Main entry points: core/engine.py Flag engine · fastapi/storage.py Async SQL storage · django/engine.py Django integration · django/storage.py Django storage
Components 25
Evaluation core
- Evaluation context
src/flagforge/core/context.py - Flag definitions
src/flagforge/core/models.py - Flag engine
src/flagforge/core/engine.py - Rule resolver
src/flagforge/core/resolver.py
Storage and cache
- Storage interfaces
src/flagforge/storage/base.py - Memory storage
src/flagforge/storage/memory.py - Django storage
src/flagforge/contrib/django/storage.py - Async SQL storage
src/flagforge/contrib/fastapi/storage.py - Cache backends
src/flagforge/cache
Framework integrations
- Django flag models
src/flagforge/contrib/django/models.py - Async ORM models
src/flagforge/contrib/fastapi/models.py - Django integration
src/flagforge/contrib/django/engine.py - Django REST API
src/flagforge/contrib/django/views.py - Django UI helpers
src/flagforge/contrib/django - FastAPI context
src/flagforge/contrib/fastapi/context.py - FastAPI routes
src/flagforge/contrib/fastapi/router.py - FastAPI dependencies
src/flagforge/contrib/fastapi/dependencies.py - FastAPI lifespan
src/flagforge/contrib/fastapi/lifespan.py
Frontend client
- React provider
packages/flagforge-react/src/context.tsx - React components
packages/flagforge-react/src/components.tsx
Flag operations
- YAML loader
src/flagforge/storage/yaml_loader.py - CLI management
src/flagforge/cli/main.py
Other components
- Application
- Flag API
- Configured database
Connections 34
- Application → Evaluation context: builds context
README.md - Application → Flag engine: evaluates flags
README.md - Flag engine → Storage interfaces: loads flags
src/flagforge/core/engine.py - Flag engine → Rule resolver: resolves rules
src/flagforge/core/engine.py - Flag engine → Cache backends: checks cache
src/flagforge/core/engine.py - Flag engine → Evaluation context: uses context
src/flagforge/core/engine.py - Flag engine → Flag definitions: evaluates definitions
src/flagforge/core/engine.py - Memory storage → Storage interfaces: implements
src/flagforge/storage/memory.py - Django storage → Storage interfaces: implements
src/flagforge/contrib/django/storage.py - Django storage → Django flag models: reads and writes
src/flagforge/contrib/django/storage.py - Async SQL storage → Storage interfaces: implements
src/flagforge/contrib/fastapi/storage.py - Async SQL storage → Async ORM models: queries
src/flagforge/contrib/fastapi/storage.py - Django integration → Django storage: configures
src/flagforge/contrib/django/engine.py - Django integration → Flag engine: creates engine
src/flagforge/contrib/django/engine.py - Django integration → Cache backends: configures cache
src/flagforge/contrib/django/engine.py - Django REST API → Django integration: evaluates flags
- Django UI helpers → Django integration: uses evaluation
src/flagforge/contrib/django/templatetags/flagforge.py - FastAPI context → Evaluation context: creates context
src/flagforge/contrib/fastapi/context.py - FastAPI routes → FastAPI context: builds context
src/flagforge/contrib/fastapi/router.py - FastAPI routes → Flag engine: evaluates flags
src/flagforge/contrib/fastapi/router.py - FastAPI routes → Async SQL storage: manages definitions
src/flagforge/contrib/fastapi/router.py - FastAPI dependencies → FastAPI context: extracts context
src/flagforge/contrib/fastapi/dependencies.py - FastAPI dependencies → Flag engine: provides engine
src/flagforge/contrib/fastapi/dependencies.py - FastAPI dependencies → Async SQL storage: provides storage
src/flagforge/contrib/fastapi/dependencies.py - FastAPI lifespan → Async SQL storage: initializes storage
- YAML loader → Flag definitions: loads definitions
src/flagforge/storage/yaml_loader.py - CLI management → YAML loader: loads configuration
src/flagforge/cli/main.py - CLI management → Django storage: manages Django flags
src/flagforge/cli/main.py - React provider → Flag API: fetches flags
packages/flagforge-react/src/context.tsx - Flag API → Django REST API: served by
README.md - Flag API → FastAPI routes: served by
src/flagforge/contrib/fastapi/router.py - React components → React provider: consumes context
packages/flagforge-react/src/components.tsx - Configured database → Django storage: persists flags
- Configured database → Async SQL storage: persists flags
src/flagforge/contrib/fastapi/storage.py