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

# Quick Start

> Get started with Crefy Connect in minutes

# Quick Start

Get Crefy Connect integrated into your application in just a few steps.

## Installation

Install Crefy Connect from npm:

```bash theme={null}
npm install crefy-connect
```

or

```bash theme={null}
yarn add crefy-connect
```

or

```bash theme={null}
pnpm add crefy-connect
```

or

```bash theme={null}
bun add crefy-connect
```

## 🪪 Get Your Crefy Connect App ID

Before integrating Crefy Connect, you'll need an App ID - this uniquely identifies your project when connecting users and managing authentication.

<Steps>
  <Step title="Visit Crefy Connect Dashboard">
    Visit [Crefy Connect Dashboard](https://connect.crefy.xyz/) to get started.
  </Step>

  <Step title="Sign Up or Sign In">
    Create a new account or sign in to your existing account.
  </Step>

  <Step title="Create New Application">
    Click on "Create New Application" in your dashboard.
  </Step>

  <Step title="Fill Application Details">
    Fill in your application details (name, description, etc.).
  </Step>

  <Step title="Copy Your App ID">
    Once created, copy your App ID - you'll use it inside the `CrefyConnectProvider`.
  </Step>
</Steps>

## Usage

### 1️⃣ Vite.js + TypeScript

**main.tsx**

```tsx theme={null}
import React from "react";
import ReactDOM from "react-dom/client";
import App from "./App";
import { CrefyConnectProvider } from "crefy-connect";
import "./index.css";

ReactDOM.createRoot(document.getElementById("root")!).render(
  <React.StrictMode>
    <CrefyConnectProvider
      appId="<YOUR_CREFY_ID>"
      chain="sepolia"
      loginMethods={["google", "wallet", "email"]}
    >
      <App />
    </CrefyConnectProvider>
  </React.StrictMode>
);
```

**App.tsx**

```tsx theme={null}
import { AuthModal } from "crefy-connect";

export default function App() {
  return (
    <div>
      <h1>Crefy Connect Example</h1>
      <AuthModal />
    </div>
  );
}
```

### 2️⃣ Next.js 13+ (App Router)

**app/layout.tsx**

```tsx theme={null}
"use client";

import { CrefyConnectProvider } from "crefy-connect";
import "./globals.css";

export default function RootLayout({
  children,
}: {
  children: React.ReactNode;
}) {
  return (
    <html lang="en">
      <body>
        <CrefyConnectProvider
          appId="<YOUR_CREFY_ID>"
          chain="sepolia"
          loginMethods={["google", "wallet", "email"]}
        >
          {children}
        </CrefyConnectProvider>
      </body>
    </html>
  );
}
```

**app/page.tsx**

```tsx theme={null}
"use client";

import { AuthModal } from "crefy-connect";

export default function Home() {
  return (
    <main>
      <h1>Crefy Connect Example</h1>
      <AuthModal />
    </main>
  );
}
```

## Next Steps

<CardGroup cols={2}>
  <Card title="CrefyConnectProvider" icon="settings" href="/api-reference/provider">
    Learn about provider configuration and props.
  </Card>

  <Card title="AuthModal" icon="user" href="/api-reference/auth-modal">
    Customize the authentication modal component.
  </Card>

  <Card title="useCrefy Hook" icon="code" href="/api-reference/use-crefy">
    Access authentication state and user details.
  </Card>

  <Card title="Send Transactions" icon="send" href="/api-reference/use-send-eth">
    Send ETH and interact with the blockchain.
  </Card>
</CardGroup>

<Note>
  **Need help?** Check our [GitHub Issues](https://github.com/crefy/crefy-connect/issues) or join our [Discord](https://discord.gg/crefy).
</Note>
