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

# Scaffold Sei

> CLI tool for scaffolding production-ready Sei applications with pre-configured templates

`@sei-js/create-sei` is a CLI tool that scaffolds production-ready Sei dApps in seconds. Quickly spin up templates with Next.js, modern wallet integration, and TypeScript support.

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

Every generated project includes wallet connections, contract interactions, TypeScript, Tailwind CSS, Mantine UI, Biome for formatting, and responsive layouts — no additional setup required.

## Quick Start

You don't need to install `@sei-js/create-sei` globally. Use it directly with npx or pnpm:

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

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

## Interactive Setup

<Steps>
  <Step title="Run the CLI">
    Execute the create-sei command with your project name:

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

  <Step title="Install and run">
    ```bash theme={"dark"}
    cd my-sei-app
    npm install
    npm run dev
    ```
  </Step>

  <Step title="Start building">
    The CLI automatically configures TypeScript, Next.js, Tailwind CSS, Biome formatting, Mantine UI components, and Git initialization.
  </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 creates a **Next.js + Wagmi (EVM)** application — a production-ready Next.js app with Wagmi for type-safe Ethereum wallet connections and blockchain interactions. Includes built-in support for MetaMask, WalletConnect, Coinbase Wallet, and other popular wallets.

**Tech Stack:** Next.js 14, Wagmi v2, Viem, TanStack Query, Tailwind CSS

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

## Extensions

Enhance your project with additional functionality using extensions.

### List Available Extensions

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

### Precompiles Extension

Add Sei precompile contract integration with examples for querying native blockchain data like token supply, staking info, and governance proposals.

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

Includes Bank precompile, Staking precompile, and Governance precompile examples.

## What's Included

After running the CLI, you'll have a fully configured Sei dApp ready for development:

* **Project structure** — Organized file structure with components, hooks, and utilities
* **Wallet integration** — Pre-configured wallet connections and hooks
* **Development tools** — TypeScript, Biome, Mantine UI, and Tailwind CSS with sensible defaults
* **Sei network integration** — Built-in network configuration and contract interaction examples

<Info>**Prerequisites:** Node.js v18 or higher is required. Use `node --version` to verify your installation.</Info>

## Troubleshooting

* **Node version conflicts** — Use `nvm use` to switch to the correct Node.js version
* **Permission errors** — Avoid using `sudo` with npm. Use `nvm` or fix npm permissions
* **Network timeouts** — Try switching to a different registry: `npm config set registry https://registry.npmjs.org/`