Scaffold Sei

@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.


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:

npx

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

pnpm

bash pnpm create @sei-js/create-sei app --name my-sei-app

Interactive Setup

Run the CLI

Execute the create-sei command with your project name:


npx @sei-js/create-sei app

Install and run


cd my-sei-app
npm install
npm run dev

Start building

The CLI automatically configures TypeScript, Next.js, Tailwind CSS, Biome formatting, Mantine UI components, and Git initialization.

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


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

Extensions

Enhance your project with additional functionality using extensions.

List Available Extensions


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.


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

Prerequisites: Node.js v18 or higher is required. Use node --version to verify your installation.

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/