> ## Documentation Index
> Fetch the complete documentation index at: https://seilabs-docs-incorporate-sei-js-changes.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Scaffold Sei

> Create a Next.js dApp with wallet integration and Sei network configuration

`@sei-js/create-sei` creates a Next.js dApp with TypeScript, wallet integration, and Sei network configuration.

```bash theme={"dark"}
npx @sei-js/create-sei app --name my-sei-app
```

The generated project includes Wagmi, Viem, RainbowKit, TypeScript, Tailwind CSS, Mantine UI, and Biome.

## Quick start

You do not need to install `@sei-js/create-sei` globally:

<Tabs>
  <Tab title="npx">
    ```bash theme={"dark"}
    npx @sei-js/create-sei app --name my-sei-app
    ```
  </Tab>

  <Tab title="bunx">
    ```bash theme={"dark"}
    bunx @sei-js/create-sei app --name my-sei-app
    ```
  </Tab>
</Tabs>

## Interactive setup

<Steps>
  <Step title="Run the CLI">
    Run the command without `--name` to enter the project name interactively:

    ```bash theme={"dark"}
    npx @sei-js/create-sei app
    ```
  </Step>

  <Step title="Install and run">
    ```bash theme={"dark"}
    cd your-project-name
    bun install
    bun run dev
    ```
  </Step>

  <Step title="Start building">
    Open `http://localhost:3000`. The generated dApp connects to Pacific-1 by default. Set `NEXT_PUBLIC_CHAIN=testnet` in `.env.local` to use Atlantic-2.
  </Step>
</Steps>

### CLI options

| Command                 | Description                                           |
| ----------------------- | ----------------------------------------------------- |
| `app`                   | Create a new Sei dApp                                 |
| `app --name <name>`     | Specify a project name (must be a valid package name) |
| `app --extension <ext>` | Add an optional extension to your project             |
| `list-extensions`       | List available extensions                             |

## Default template

The default template is a Next.js EVM dApp. Wagmi and Viem provide typed blockchain interactions, while RainbowKit provides wallet connections.

It currently uses Next.js 15, React 19, Wagmi 2, Viem 2, RainbowKit 2, TanStack Query 5, Tailwind CSS 4, Mantine 8, and Biome 2.

```bash theme={"dark"}
npx @sei-js/create-sei app --name my-sei-app
```

## Extensions

Use an extension to add an example to the base template.

### List available extensions

```bash theme={"dark"}
npx @sei-js/create-sei list-extensions
```

### Precompiles extension

Add a Bank precompile example that queries the native SEI supply:

```bash theme={"dark"}
npx @sei-js/create-sei app --name my-sei-precompile-app --extension precompiles
```

## Included configuration

* Next.js App Router project structure
* Wallet connections through Wagmi and RainbowKit
* Pacific-1 and Atlantic-2 chain configuration
* TypeScript, Biome, Mantine UI, and Tailwind CSS

<Info>Install [Node.js](https://nodejs.org/) to run the CLI with `npx`, and install [Bun](https://bun.sh/docs/installation) to install and run the generated project.</Info>

## Troubleshooting

* For Node.js version conflicts, use `nvm` to switch versions.
* For npm permission errors, do not use `sudo`. Use `nvm` or fix your npm permissions.
* For registry timeouts, run `npm config set registry https://registry.npmjs.org/` before retrying `npx`.