> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.growthbook.io/llms.txt
> Use this file to discover all available pages before exploring further.
# SDK Quickstart
> Get GrowthBook feature flags and experiments running in your application with just a few lines of code.
export const CodeLogos = ({name}) => {
switch (name) {
case "js":
return ;
case "react":
case "reactNative":
return ;
case "vue":
return ;
case "nextjs":
return ;
case "php":
return ;
case "node":
return ;
case "ruby":
return ;
case "python":
return ;
case "go":
return ;
case "java":
return ;
case "csharp":
return ;
case "rust":
return ;
case "elixir":
return ;
case "kotlin":
return ;
case "swift":
return ;
case "edgeCloudflare":
return ;
case "edgeFastly":
return ;
case "edgeLambda":
return ;
case "edgeUtils":
return ;
case "vercel":
return ;
case "flutter":
return ;
case "roku":
return ;
default:
return ;
}
};
Get GrowthBook running in your application in minutes.
**New to GrowthBook SDKs?**
The [SDK Overview](/lib) covers how SDKs work and helps you choose the right one for your use case.
Go to [**SDK Configuration**](https://app.growthbook.io/sdks), create a new SDK Connection, and copy the **Client Key** (starts with `sdk-`).
```bash npm theme={null}
npm install @growthbook/growthbook-react @growthbook/growthbook
```
```bash Yarn theme={null}
yarn add @growthbook/growthbook-react @growthbook/growthbook
```
```bash pnpm theme={null}
pnpm add @growthbook/growthbook-react @growthbook/growthbook
```
```bash bun theme={null}
bun add @growthbook/growthbook-react @growthbook/growthbook
```
```tsx theme={null}
import { GrowthBook, GrowthBookProvider } from "@growthbook/growthbook-react";
import { thirdPartyTrackingPlugin, autoAttributesPlugin } from "@growthbook/growthbook/plugins";
// Create a GrowthBook instance
const gb = new GrowthBook({
apiHost: "https://cdn.growthbook.io",
clientKey: "sdk-abc123", // Your SDK client key
enableDevMode: true,
plugins: [
thirdPartyTrackingPlugin(), // Optional, sends "Experiment Viewed" events via GrowthBook Managed Warehouse, Google Analytics, Google Tag Manager, and Segment.
autoAttributesPlugin(), // Optional, sets common attributes (browser, session_id, etc.)
],
});
// Load feature definitions from the GrowthBook API
gb.init();
export default function App() {
return (
);
}
```
```tsx theme={null}
import { useFeatureIsOn, useFeatureValue } from "@growthbook/growthbook-react";
function MyApp() {
const showNewFeature = useFeatureIsOn("new-feature");
const buttonColor = useFeatureValue("button-color", "blue");
return (
{showNewFeature && }
);
}
```
**Next steps:** - See the [example Next.js app](https://github.com/growthbook/examples/tree/main/next-js) - See the [React SDK docs](/lib/react)
Go to [**SDK Configuration**](https://app.growthbook.io/sdks), create a new SDK Connection, and copy the **Client Key** (starts with `sdk-`).
```bash npm theme={null}
npm install @growthbook/growthbook
```
```bash Yarn theme={null}
yarn add @growthbook/growthbook
```
```bash pnpm theme={null}
pnpm add @growthbook/growthbook
```
```bash bun theme={null}
bun add @growthbook/growthbook
```
```javascript theme={null}
import { GrowthBook } from "@growthbook/growthbook";
import { thirdPartyTrackingPlugin, autoAttributesPlugin } from "@growthbook/growthbook/plugins";
const gb = new GrowthBook({
apiHost: "https://cdn.growthbook.io",
clientKey: "sdk-abc123",
plugins: [
thirdPartyTrackingPlugin(), // Optional, sends "Experiment Viewed" events via GrowthBook Managed Warehouse, Google Analytics, Google Tag Manager, and Segment.
autoAttributesPlugin(), // Optional, sets common attributes (browser, session_id, etc.)
],
});
await gb.init();
```
```javascript theme={null}
if (gb.isOn("new-feature")) {
showNewFeature();
}
const color = gb.getFeatureValue("button-color", "blue");
```
**Next steps:** - See the [JavaScript SDK docs](/lib/js) for TypeScript, plugins, and more. - See an [example Typescript app](https://github.com/growthbook/examples/tree/main/vanilla-typescript)
Go to [**SDK Configuration**](https://app.growthbook.io/sdks), create a new SDK Connection, and copy the **Client Key** (starts with `sdk-`).
```bash npm theme={null}
npm install @growthbook/growthbook
```
```bash Yarn theme={null}
yarn add @growthbook/growthbook
```
```bash pnpm theme={null}
pnpm add @growthbook/growthbook
```
```bash bun theme={null}
bun add @growthbook/growthbook
```
```javascript theme={null}
import { GrowthBookClient } from "@growthbook/growthbook";
const gbClient = new GrowthBookClient({
apiHost: "https://cdn.growthbook.io",
clientKey: "sdk-abc123",
trackingCallback: (experiment, result, userContext) => {
const userId = userContext.attributes.id;
// Required for A/B testing
// TODO: Replace with your own tracking implementation
console.log("Viewed Experiment", userId, {
experimentId: experiment.key,
variationId: result.key
});
}
});
await gbClient.init({timeout: 3000});
```
```javascript theme={null}
// User context with attributes that feature flags can use for targeting
const userContext = {
attributes: {
id: "123",
country: "US",
// ... other attributes ...
}
}
// Boolean on/off flags
if (gbClient.isOn("my-feature", userContext)) {
console.log("My feature is on!");
}
// String, Number, or JSON flags
const value = gbClient.getFeatureValue("my-string-feature", "fallback", userContext);
console.log(value);
```
**Next steps:** - See the full [Node.js SDK docs](/lib/node) - Use the SDK in [Express middleware](/lib/node#express-middleware)
Go to [**SDK Configuration**](https://app.growthbook.io/sdks), create a new SDK Connection, and copy the **Client Key** (starts with `sdk-`).
```bash pip theme={null}
pip install growthbook
```
```python theme={null}
from growthbook import GrowthBookClient, Options, UserContext
def on_experiment_viewed(experiment, result):
# TODO: track in your analytics system
print(f"Experiment: {experiment.key}, Variation: {result.key}")
# Create and initialize client
client = GrowthBookClient(
Options(
api_host="https://cdn.growthbook.io",
client_key="sdk-abc123",
on_experiment_viewed=on_experiment_viewed,
)
)
await client.initialize()
# Create user context for targeting
user = UserContext(
attributes={
"id": "user-123",
"country": "US",
}
)
```
```python theme={null}
if await client.is_on("new-feature", user):
show_new_feature()
color = await client.get_feature_value("button-color", "blue", user)
```
**Next steps:** - See the full [Python SDK docs](/lib/python) - See the [how to integrate with FastAPI](/lib/python#async-web-framework-integration-fastapi) example.
## All SDKs
**Client**
}>
Drop-in script for any website
}>
Vanilla JS and TypeScript
}>
Hooks and providers with SSR
}>
Vue 3 composables
}>
Native Android
}>
Native iOS
}>
Cross-platform mobile
}>
Cross-platform React
**Server**
}>
Express, Fastify, etc.
}>
Flask, Django, FastAPI
}>
Rails and Ruby apps
}>
Laravel, Symfony, etc.
}>
Spring Boot and Java
}>
High-performance Go
}>
.NET Core and ASP.NET
}>
Phoenix and Elixir
}>
Actix, Axum, Rocket, and more
**Edge**
}>
Edge computing on Cloudflare
}>
WebAssembly-powered edge
}>
AWS CloudFront edge
***
## Verify your setup
After setting up your SDK, verify it's working by following these steps:
1. Create a feature flag called `test-flag` in your [GrowthBook](https://app.growthbook.io/features)
2. Set its value to `true` and enable it for your environment
3. Check that `isOn("test-flag")` returns `true` in your app
4. Toggle the flag off and verify the change is reflected
Use the [GrowthBook DevTools](/tools/chrome-extension) browser extension to inspect and test feature flags in development.