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.

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:

npx

npx @sei-js/create-sei app --name my-sei-app

bunx

bunx @sei-js/create-sei app --name my-sei-app

Interactive setup

1. Run the CLI

   Run the command without --name to enter the project name interactively:

   npx @sei-js/create-sei app
   
2. Install and run

   cd your-project-name
   bun install
   bun run dev
   
3. 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.

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.

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

npx @sei-js/create-sei list-extensions

Precompiles extension

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

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

Install Node.js to run the CLI with npx, and install Bun to install and run the generated project.

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.