> ## 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.

# Introduction

> Server-managed feature flags with local evaluation for Omniretail services

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

| Type      | Return type       | Typical use case                                       |
| --------- | ----------------- | ------------------------------------------------------ |
| `boolean` | `bool`            | Feature gates, kill switches, A/B experiments          |
| `string`  | `string`          | UI variants, copy testing, configuration by name       |
| `number`  | `number`          | Numeric thresholds, price multipliers, capacity limits |
| `object`  | `Record / object` | Structured configuration payloads                      |

## SDK platforms

<CardGroup cols={3}>
  <Card title="React" icon="react" href="/sdks/react">
    Hooks for React 18+ web applications
  </Card>

  <Card title="React Native" icon="mobile" href="/sdks/react-native">
    Hooks with AsyncStorage persistence and foreground refresh
  </Card>

  <Card title=".NET" icon="code" href="/sdks/dotnet">
    Hosted service integration for ASP.NET Core 8+
  </Card>
</CardGroup>

## Key concepts

* [**Projects, Environments & Applications**](/concepts/platform): the resource hierarchy and how SDK keys map to environments
* [**Flags**](/concepts/flags): how flags are structured, typed, and namespaced
* [**Targeting**](/concepts/targeting): rule-based evaluation using evaluation context attributes
* [**Evaluation**](/concepts/evaluation): the complete evaluation algorithm and reason codes