Skip to main content

Documentation Index

Fetch the complete documentation index at: https://omniflagsdoc.omniretail.app/llms.txt

Use this file to discover all available pages before exploring further.

OmniFlags is the feature flag platform for Omniretail. Ship code continuously and control activation from the dashboard. No deployments, no infrastructure changes required.

Architecture

Flags are defined and configured in the dashboard, distributed via a CDN-backed snapshot API, and evaluated entirely within the SDK. There is no per-evaluation network call. The SDK fetches a snapshot of all flag configurations on startup, caches it locally, and runs the evaluation engine in-process on every call.
Dashboard → API → Cloudflare CDN → SDK (ETag-cached snapshot) → in-process evaluation
This means:
  • Zero evaluation latency: flag checks are pure in-memory operations.
  • No single point of failure: stale cached snapshots serve traffic even when the origin is unreachable.
  • Deterministic rollouts: the same user always lands in the same bucket, across all platforms and restarts.

Flag types

TypeReturn typeTypical use case
booleanboolFeature gates, kill switches, A/B experiments
stringstringUI variants, copy testing, configuration by name
numbernumberNumeric thresholds, price multipliers, capacity limits
objectRecord / objectStructured configuration payloads

SDK platforms

React

Hooks for React 18+ web applications

React Native

Hooks with AsyncStorage persistence and foreground refresh

.NET

Hosted service integration for ASP.NET Core 8+

Key concepts