# Overview (/docs/sdks/react)

MonoCloud’s React SDK lets you add authentication to your React single-page application.

Use it to:

- Authenticate users
- Keep users signed in across page reloads and tabs
- Access the signed-in user anywhere in your component tree
- Conditionally render or gate UI based on authentication and group membership
- Call your protected APIs with access tokens

The SDK builds on top of [`@monocloud/auth-web-js`](/docs/sdks/web-js), reusing the same browser implementation (PKCE, redirects, popups, silent refresh, and cross-tab coordination) while providing a React provider, hooks, and components.

## Install the SDK [#install-the-sdk]

Install the SDK using your package manager:

```npm title="Terminal"
npm install @monocloud/auth-react
```

View the source on GitHub: [monocloud/auth-js](https://github.com/monocloud/auth-js)

## Get started quickly [#get-started-quickly]

Start with the quickstart to see MonoCloud in action:

- [React Quickstart](/docs/quickstarts/react)

The quickstart walks you from a new Vite + React app to a signed-in user in a few minutes.

## Before you continue [#before-you-continue]

To integrate MonoCloud into your own app:

1. Follow the [installation and configuration guide](/docs/sdks/react/installation).
1. Use the guides below to build out your app's authentication flow.

## Guides [#guides]

- [Read the authentication state](/docs/sdks/react/authentication-state) - Access the user, session, and tokens with the `useAuth()` hook
- [Sign in, sign up, and sign out](/docs/sdks/react/sign-in-out) - Trigger authentication flows with components and hook actions
- [Protected component](/docs/sdks/react/protected) - Conditionally render UI based on authentication and group membership
- [Handle sign-in and sign-out callbacks](/docs/sdks/react/handle-callbacks) - Process callbacks automatically or on a dedicated route, and integrate with a client-side router

## API Reference [#api-reference]

View all exported provider, hooks, components, and types:

- [React SDK API Reference](https://monocloud.github.io/auth-js/modules/_monocloud_auth-react.html)
