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

# React SDK

> Integrate Kontext ads into your React app with the React SDK.

<Card title="React Demo Project" icon="github" href="https://github.com/kontextso/sdk-react-demo">
  See how easy it is to integrate high-performance ads into your React app using our lightweight SDK.
</Card>

## Requirements

* **React**: 18.0.0 or later

<Note>
  You'll need a [publisher account](/publishers#getting-started-is-easy) to obtain your `publisherToken` and placement codes.
</Note>

<CardGroup cols={2}>
  <Card title="Installation" icon="download" href="/sdk/react/installation">
    Install the npm package and prepare your app.
  </Card>

  <Card title="Showing your first ad" icon="rocket" href="/sdk/react/first-ad">
    Wrap your app in `<AdsProvider>`, feed messages, mount `<InlineAd>` — the 5-minute integration.
  </Card>

  <Card title="API reference" icon="book" href="/sdk/react/api">
    Props, hooks, components, and events.
  </Card>

  <Card title="Guides" icon="signs-post" href="/sdk/react/guides">
    Patterns and recipes: no-fill, character switching, restoring history, and more.
  </Card>

  <Card title="Example app" icon="github" href="/sdk/react/example">
    Run the Vite + React demo end-to-end against your own publisher token.
  </Card>
</CardGroup>