Skip to main content

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.

​
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?

No MAU Pricing

Pay for what you use (config sync requests), not monthly active users. 25k requests/month/environment included.

Built for React

First-class TypeScript support with type-safe hooks for React, React Native, and Expo.

Simple API

Just useFlag('feature-name') - no complex SDKs, no heavy dependencies.

Edge-Ready

ETag-based caching keeps bandwidth minimal. Works great with Vercel, Netlify, and Cloudflare.

​
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

React (Web)

Next.js, Remix, Vite, Create React App

React Native

Expo, bare React Native

CLI

Command-line tool for automation

Quickstart

Get up and running in 2 minutes

API Reference

Full HTTP API documentation

React Hooks

Complete React SDK reference

CLI Commands

All CLI commands and options

​
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
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?

Ready to get started? Head to the Quickstart Guide →