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

# Quickstart

> Start using Renaiss as a collector or developer.

Use this page to choose the right first step. Collectors can explore the app directly. Developers can integrate the TypeScript SDK or add Renaiss SSO.

## Prerequisites

Before you begin, make sure you have the setup for your path:

* To explore the app, use a modern browser and a wallet compatible with the Renaiss app.
* To use the TypeScript SDK, use Node.js `24` or later. For wallet, pull, or buyback write workflows, use an approved builder API key.
* To add Sign in with Renaiss, request OIDC credentials and redirect URI allowlisting from the Renaiss team.

## Get started

<Steps>
  <Step title="Explore Renaiss">
    Open the app to browse collectible cards, gacha machines, and the marketplace.

    <Card title="Launch Renaiss" icon="external-link" href="https://renaiss.xyz">
      Visit the Renaiss app.
    </Card>
  </Step>

  <Step title="Choose a developer path">
    Use the TypeScript SDK for gacha and wallet workflows. Review the Builder Program for write authorization and tiers. Use SSO when you need users to authenticate with their Renaiss account.

    <Columns cols={3}>
      <Card title="TypeScript SDK" icon="code" href="/typescript-sdk">
        Build gacha discovery, wallet readiness, pull, SSE, and buyback flows.
      </Card>

      <Card title="Builder Program" icon="key-round" href="/builder-program">
        Get a builder API key for wallet, pull, and buyback write workflows.
      </Card>

      <Card title="Sign in with Renaiss" icon="key-round" href="/sso-integration">
        Add Renaiss as an OpenID Connect provider.
      </Card>
    </Columns>
  </Step>

  <Step title="Install the SDK">
    Install the SDK when you want to call Renaiss APIs from a TypeScript app.

    <CodeGroup>
      ```bash pnpm theme={null}
      pnpm add @renaiss-protocol/client@alpha viem
      ```

      ```bash npm theme={null}
      npm install @renaiss-protocol/client@alpha viem
      ```

      ```bash yarn theme={null}
      yarn add @renaiss-protocol/client@alpha viem
      ```
    </CodeGroup>
  </Step>

  <Step title="Create your first client">
    Create a public client to browse gacha machines.

    ```ts theme={null}
    import { createPublicClient } from "@renaiss-protocol/client";

    const client = createPublicClient();

    const machines = await client.listGachaMachines({ pageSize: 5 }).firstPage();
    ```
  </Step>
</Steps>

<Tip>
  Need partner credentials, redirect URI changes, or integration support? Email us at [info@renaiss.xyz](mailto:info@renaiss.xyz).
</Tip>