How parijatpal/flagforge works
FlagForge is a self-hosted feature-flag service. Administrators manage environment-specific flags and review audit history through the dashboard or API; applications evaluate flags directly or use the SDK’s locally cached snapshot, refreshed by SSE updates. The graph preserves flag management, validation, evaluation, audit, streaming, dashboard, and SDK responsibilities. Edges follow shown calls or README claims; unsampled dashboard/API wiring and documented capabilities are cited at the README level.
Main entry points: app.js API Routing · evaluate.js Evaluate Route · flagRepository.js Flag Repository · client.js Remote SDK Client
Components 22
Administration
- Admin Dashboard
dashboard/src/App.jsx - Dashboard API
dashboard/src/api.js
API Runtime
- API Server
api/src/server.js - API Routing
api/src/app.js - Admin Auth
api/src/middleware/auth.js - Rate Limiting
api/src/middleware/rateLimit.js - Flag Management
api/src/routes/flags.js - Flag Validation
api/src/models/flagSchema.js - Evaluate Route
api/src/routes/evaluate.js - Decision Logic
api/src/services/evaluation.js - SDK Snapshot Route
api/src/routes/sdk.js - Audit Route
api/src/routes/audit.js - SSE Stream
api/src/routes/stream.js
State and Updates
- Flag Repository
api/src/db/flagRepository.js - Audit Repository
api/src/db/auditRepository.js - Redis Client
api/src/db/redisClient.js - Redis
SDK Evaluation
- Remote SDK Client
sdk/src/client.js - Local SDK Client
sdk/src/local-client.js - SDK Decision Logic
sdk/src/evaluation.js
Other components
- Administrator
- Application
Connections 32
- Administrator → Admin Dashboard: manages flags
README.md - Admin Dashboard → Dashboard API: requests data
dashboard/src/App.jsx - Dashboard API → API Routing: calls API
README.md - API Server → API Routing: starts
api/src/server.js - API Routing → Flag Management: routes flags
api/src/app.js - API Routing → Evaluate Route: routes evaluation
api/src/app.js - API Routing → SDK Snapshot Route: routes snapshots
api/src/app.js - API Routing → Audit Route: routes audits
api/src/app.js - API Routing → SSE Stream: routes streams
api/src/app.js - API Routing → Admin Auth: guards admin routes
api/src/app.js - API Routing → Rate Limiting: limits requests
api/src/app.js - Flag Management → Flag Validation: validates flags
api/src/routes/flags.js - Flag Management → Flag Repository: manages records
api/src/routes/flags.js - Evaluate Route → Flag Repository: loads flag
api/src/routes/evaluate.js - Evaluate Route → Decision Logic: evaluates flag
api/src/routes/evaluate.js - Evaluate Route → Flag Validation: validates environment
api/src/routes/evaluate.js - SDK Snapshot Route → Flag Repository: loads snapshot
api/src/routes/sdk.js - SDK Snapshot Route → Flag Validation: validates environment
api/src/routes/sdk.js - Audit Route → Audit Repository: lists history
api/src/routes/audit.js - SSE Stream → Redis Client: subscribes updates
api/src/routes/stream.js - Flag Repository → Redis Client: reads and writes
api/src/db/flagRepository.js - Flag Repository → Audit Repository: records changes
api/src/db/flagRepository.js - Audit Repository → Redis Client: stores history
api/src/db/auditRepository.js - Redis Client → Redis: issues commands
api/src/db/redisClient.js - Application → Remote SDK Client: checks flags
README.md - Remote SDK Client → Evaluate Route: requests decisions
sdk/src/client.js - Remote SDK Client → SSE Stream: opens event stream
sdk/src/client.js - Remote SDK Client → Local SDK Client: extends client
sdk/src/local-client.js - Local SDK Client → SDK Snapshot Route: fetches snapshots
sdk/src/local-client.js - Local SDK Client → SDK Decision Logic: evaluates locally
sdk/src/local-client.js - Local SDK Client → SSE Stream: resyncs on events
sdk/src/local-client.js - Application → Evaluate Route: evaluates directly
README.md