> For the complete documentation index, see [llms.txt](https://pollz.gitbook.io/pollz/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://pollz.gitbook.io/pollz/tooling/react.md).

# React

The package `pollz-react` has been develop to integrate the Node.js SDK easily within a React app.

```
npm install pollz-react
```

```
yarn add pollz-react
```

The `PollzProvider` component wraps your React application, providing access to the Pollz SDK functionalities through React context. It initializes the SDK with the specified `appId` and `appSecret` and makes the SDK instance available to all child components.

#### `useAnonymousPoll`

* Fetches an anonymous poll using the provided `pollToken`.
* Returns the poll object and a function to refetch the poll.

#### `usePollTypes`

* Fetches all available poll types.
* Returns the list of poll types.

#### `usePoll`

* Fetches a specific poll using the provided `pollId`.
* Optionally listens for real-time updates on the poll.
* Returns the poll object and a function to refetch the poll.

#### `usePolls`

* Fetches a paginated list of all polls.
* Returns the list of polls and a function to refetch the list.

#### `usePollz`

* Retrieves the Pollz SDK instance and initialization status.
* Ensures that the component is wrapped within the `PollzProvider`.

### Usage Example:

```jsx
import React from 'react';
import { PollzProvider, usePolls, usePollz } from 'pollz-react';

const App = () => {
  const { polls, refetch: refetchPolls } = usePolls();
  const { initialized } = usePollz();

  if (!initialized) {
    return <div>Loading...</div>;
  }

  return (
    <div>
      <h1>Pollz React App</h1>
      <button onClick={() => refetchPolls()}>Refetch Polls</button>
      {/* Render your components using the fetched data */}
    </div>
  );
};

const PollzApp = () => (
  <PollzProvider appId="your-app-id" appSecret="your-app-secret">
    <App />
  </PollzProvider>
);

export default PollzApp;
```

This package provides a clean and convenient way for React developers to integrate Pollz functionality into their applications. If you have specific questions or need further assistance, feel free to let me know!