> ## Documentation Index
> Fetch the complete documentation index at: https://superdoc-caio-pizzol-docs-ai-core-preset.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# React API

`@superdoc-dev/react` is a first-party React wrapper for SuperDoc. It handles lifecycle management, SSR safety, and React Strict Mode compatibility so you can drop a DOCX editor into any React app.

Building your own toolbar, comments sidebar, or review panel? Pair `<SuperDocEditor>` with `superdoc/ui/react`. See [Custom UI](/editor/custom-ui/overview).

## Installation

```bash theme={null}
npm install @superdoc-dev/react
```

<Note>
  `superdoc` is included as a dependency: no need to install it separately.
</Note>

## Quick start

```jsx theme={null}
import { SuperDocEditor } from '@superdoc-dev/react';
import '@superdoc-dev/react/style.css';

function App() {
  return (
    <SuperDocEditor
      document={file}
      documentMode="editing"
      onReady={() => console.log('Editor ready!')}
    />
  );
}
```

## What the component handles

* **Mounting**: Creates a SuperDoc instance when the component mounts
* **Updates**: Rebuilds automatically when the `document` prop changes
* **Cleanup**: Destroys the instance on unmount
* **SSR**: Renders container structure on server, initializes SuperDoc after hydration
* **Strict Mode**: Internal cleanup flag prevents issues from React 18 double-invocation

## Requirements

| Requirement | Version |
| ----------- | ------- |
| React       | 16.8.0+ |
| Node.js     | 16+     |

## API structure

* **[Configuration](/editor/react/configuration)**: All props reference
* **[Methods](/editor/react/methods)**: Ref API, instance methods, and patterns
* **[Types](/editor/react/types)**: TypeScript types, framework integration, troubleshooting