> ## Documentation Index
> Fetch the complete documentation index at: https://superflag.sh/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Core SDK overview

> Deterministic feature flag evaluation, schema validation, privacy, and OpenFeature support

# Core SDK

`@superflag-sh/core` is the dependency-free evaluation authority shared by
Superflag's control plane and SDKs. Use it directly when your application
already possesses a versioned configuration or needs schema, code generation,
inspection, migration, experiment, telemetry, or OpenFeature primitives.

```bash theme={null}
npm install @superflag-sh/core
```

## What core owns

* strict schema v1 parsing and validation;
* deterministic rules, prerequisites, segments, schedules, and weighted rollouts;
* explicit fallback and evaluation-detail semantics;
* client privacy projection and context allow-listing;
* deterministic TypeScript code generation;
* legacy configuration migration;
* OpenFeature server provider adaptation;
* conformance vectors shared by packages;
* immutable experiment iterations and assignment;
* evaluation explanations, dependency impact, and simulations; and
* opt-in, transport-independent feature-event telemetry.

Core does not synchronize remote configuration, persist caches, mount React
providers, or run background work.

## Entry points

| Import                                     | Purpose                                                             |
| ------------------------------------------ | ------------------------------------------------------------------- |
| `@superflag-sh/core`                       | Schema, evaluator, privacy, code generation, and types              |
| `/openfeature`                             | Structurally compatible server provider                             |
| `/legacy`                                  | Frozen legacy v1 migration                                          |
| `/conformance`                             | Canonical fixtures and conformance runner                           |
| `/events`                                  | Privacy-safe decision, assignment, exposure, and outcome contracts  |
| `/experiments`                             | Experiment iterations, assignment, and lifecycle validation         |
| `/inspection`                              | Explanations, segment probes, dependency impact, and simulation     |
| `/telemetry`                               | Bounded opt-in queue, retry, diagnostics, and outcome tracking      |
| `/react`, `/react-native`, `/node`, `/cli` | Pure platform helpers for callers that already own config/lifecycle |

<Card title="Evaluate a config" icon="play" href="/docs/core/evaluation">
  Define, validate, evaluate, inspect, and project a versioned configuration.
</Card>