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

# Quick start

> Get up and running with Embedded Banking components in minutes.

This quickstart covers integrating Tesouro's React components with widget-token authentication. Calling the REST API directly from your backend and owning the UI yourself? Follow the [Server-side quickstart](/embedded-banking/guides/quickstart/server-side) instead.

<Steps>
  <Step title="Get your credentials">
    Your client ID, client secret, and widget secret are provided by Tesouro during onboarding. To request access, have your designated team lead submit an [access request](https://d92rm.share.hsforms.com/2rxMT-N-nQ-atFj2t5ODm2w).
  </Step>

  <Step title="Set up a widget token endpoint">
    Embedded components authenticate users via short-lived, user-scoped widget tokens. Your backend exposes an endpoint that receives `{ userId, userEmail }` and returns `{ widgetToken }`, encrypted using your `TESOURO_WIDGET_SECRET`.

    See the full implementation in the [React integration guide](/embedded-banking/guides/embedded-components/react#2-set-up-a-widget-token-endpoint).
  </Step>

  <Step title="Wrap your app and drop in a component">
    ```tsx lines theme={null}
    import { EmbeddedProvider, BalancesWidget } from '@tesouro/embedded-components-react';

    export default function DashboardPage() {
      return (
        <EmbeddedProvider
          userId={currentUser.id}
          userEmail={currentUser.email}
          widgetTokenRefreshUrl="/api/widget-token"
        >
          <BalancesWidget />
        </EmbeddedProvider>
      );
    }
    ```

    Prefer a framework-agnostic approach? Use the [web components](/embedded-banking/guides/embedded-components/web-components) option instead.
  </Step>
</Steps>

## Next steps

* [React integration guide](/embedded-banking/guides/embedded-components/react) — full `EmbeddedProvider` setup, NavigationAdapter, and style overrides
* [Browse all components](/embedded-banking/guides/embedded-components/onboarding) — onboarding, balances, transfers, and more
* [Authentication](/embedded-banking/guides/authentication/overview) — learn about available auth methods