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

# Introduction

> Feature flags and remote config for React, React Native, and Expo apps

# Welcome to Superflag

Superflag is a simple, developer-first feature flag and remote config system designed for modern React and React Native applications.

## Why Superflag?

<CardGroup cols={2}>
  <Card title="No MAU Pricing" icon="ban">
    Pay for what you use (config sync requests), not monthly active users. 25k requests/month/environment included.
  </Card>

  <Card title="Built for React" icon="react">
    First-class TypeScript support with type-safe hooks for React, React Native, and Expo.
  </Card>

  <Card title="Simple API" icon="sparkles">
    Just `useFlag('feature-name')` - no complex SDKs, no heavy dependencies.
  </Card>

  <Card title="Edge-Ready" icon="bolt">
    ETag-based caching keeps bandwidth minimal. Works great with Vercel, Netlify, and Cloudflare.
  </Card>
</CardGroup>

## Key Features

* **Type-safe hooks** - `useFlag<T>()` with TypeScript generics
* **Smart caching** - ETag-based HTTP caching reduces bandwidth by 90%+
* **Offline-first** - Apps work even when offline using cached configs
* **Platform support** - React (web), React Native, Expo, Next.js, Remix
* **CLI included** - Manage flags from your terminal or CI/CD
* **Zero config** - Just add your client key and start using flags

## Supported Platforms

<CardGroup cols={3}>
  <Card title="React (Web)" icon="globe" href="/react/installation">
    Next.js, Remix, Vite, Create React App
  </Card>

  <Card title="React Native" icon="mobile" href="/react-native/installation">
    Expo, bare React Native
  </Card>

  <Card title="CLI" icon="terminal" href="/cli/installation">
    Command-line tool for automation
  </Card>
</CardGroup>

## Quick Links

<CardGroup cols={2}>
  <Card title="Quickstart" icon="rocket" href="/quickstart">
    Get up and running in 2 minutes
  </Card>

  <Card title="API Reference" icon="code" href="/api-reference/overview">
    Full HTTP API documentation
  </Card>

  <Card title="React Hooks" icon="hook" href="/react/api-reference">
    Complete React SDK reference
  </Card>

  <Card title="CLI Commands" icon="terminal" href="/cli/commands">
    All CLI commands and options
  </Card>
</CardGroup>

## How It Works

1. **Create flags** in the Superflag dashboard or via CLI
2. **Install the SDK** for your platform (React, React Native, or CLI)
3. **Use flags** in your code with type-safe hooks
4. **Deploy changes** instantly without app updates

```tsx theme={null}
import { SuperflagProvider, useFlag } from '@superflag-sh/react'

function App() {
  return (
    <SuperflagProvider clientKey="pub_...">
      <MyComponent />
    </SuperflagProvider>
  )
}

function MyComponent() {
  const newFeature = useFlag('new-feature', false)

  return newFeature ? <NewUI /> : <OldUI />
}
```

## Need Help?

* Check out the [Quickstart Guide](/quickstart) to get started
* Browse [React SDK docs](/react/installation) for web apps
* Read [React Native SDK docs](/react-native/installation) for mobile apps
* Explore [CLI documentation](/cli/installation) for automation

Ready to get started? Head to the [Quickstart Guide](/quickstart) →