Introduction
Quick Start Guide
Build your first Sei application in under 10 minutes with @sei-js
Prerequisites
Before you begin, ensure you have the following installed:Node.js & Package Management
Node.js & Package Management
Required for running @sei-js applications:
- Node.js (v18 or higher) - Required for npx and package management
- nvm (Node Version Manager) - Recommended for managing Node.js versions
Verify your installation:
node --version should output v18.0.0 or higherCode Editor
Code Editor
Traditional Editors:
- VS Code - Popular, lightweight with excellent TypeScript support
- WebStorm - Full-featured IDE with advanced debugging and refactoring
- Cursor - VS Code fork with built-in AI coding assistance
- Windsurf - AI-first development environment with intelligent code generation
All editors work great with @sei-js projects. Choose based on your preference for AI assistance and feature requirements.
Create your first Sei application
1
Initialize your project
Generate a new Sei application using our CLI tool:
Expected outcome: A new project directory with TypeScript configuration, testing setup, and example code.
The CLI will ask you to choose a template. Select “React + Wagmi” for a full-featured web application, or “Node.js” for backend/script development.
2
Navigate and install dependencies
Move into your project directory and install dependencies:
Expected outcome: All dependencies installed successfully without errors.
Troubleshooting installation issues
Troubleshooting installation issues
Common issues and solutions:
- Node version conflicts: Use
nvm useto switch to the correct Node.js version - Permission errors: Avoid using
sudowith npm. Usenvmor fix npm permissions - Network timeouts: Try switching to a different registry:
npm config set registry https://registry.npmjs.org/
3
Start your development server
Launch your application in development mode:Your browser should automatically open to show your new Sei application with:
Expected outcome: Development server running at
http://localhost:3000 with hot reload enabled.- Wallet connection button
- Network status display
- Example interactions ready to test
What you can build
Your new Sei application comes with examples and patterns for common blockchain interactions:Connect Wallets
Connect to any Sei-compatible wallet including MetaMask, Compass, and more using the built-in wallet integration
Check Balances
Fetch and display wallet balances for SEI and other tokens with real-time updates
Query Blockchain Data
Access blockchain information like total SEI supply using precompile contracts
Smart Contract Interactions
Deploy and interact with smart contracts including simple examples like counters and token transfers