Skip to content

Commit 1be608f

Browse files
committed
Add extensions, update default template, remove vite template
- Removed vite template - Added extensions - Updated docs - Updated default templates - Updated package versions - Added mantine UI
1 parent dc92512 commit 1be608f

70 files changed

Lines changed: 12051 additions & 11661 deletions

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

.yarn/install-state.gz

-3 Bytes
Binary file not shown.

docs/create-sei/quick-start.mdx

Lines changed: 17 additions & 30 deletions
Original file line numberDiff line numberDiff line change
@@ -11,11 +11,11 @@ You don't need to install `@sei-js/create-sei` globally. Use it directly with np
1111
<CodeGroup>
1212

1313
```bash npx
14-
npx @sei-js/create-sei app
14+
npx @sei-js/create-sei app -name my-sei-app
1515
```
1616

1717
```bash pnpm
18-
pnpm create @sei-js/create-sei app
18+
pnpm create @sei-js/create-sei app -name my-sei-app
1919
```
2020

2121
</CodeGroup>
@@ -28,48 +28,35 @@ The CLI provides an interactive wizard to guide you through project setup:
2828
<Step title="Run the CLI">
2929
Execute the create-sei command with your project name:
3030
```bash
31-
npx @sei-js/create-sei app -n my-sei-app
31+
npx @sei-js/create-sei app
3232
```
3333
</Step>
3434

3535
<Step title="Choose Framework">
36-
Select your preferred frontend framework:
37-
- **Next.js** - Full-stack React framework with SSR/SSG
38-
- **Vite** - Fast build tool with React
36+
- `cd my-sei-app`
37+
- `yarn install`
38+
- `yarn dev`
39+
3940
</Step>
4041

4142
<Step title="Project Setup">
4243
The CLI automatically configures:
4344
- TypeScript configuration
45+
- Up to date NextJS
4446
- Tailwind CSS styling
45-
- ESLint configuration
46-
- Prettier formatting
47+
- Biome formatting
48+
- Mantine UI components
4749
- Git initialization
4850
</Step>
4951
</Steps>
5052

51-
## Manual CLI Usage
52-
53-
Skip the interactive setup by specifying all options directly:
54-
55-
<CodeGroup>
56-
57-
```bash Next.js + Wagmi
58-
npx @sei-js/create-sei app -n my-app -f next
59-
```
60-
61-
```bash Vite + Ethers.js
62-
npx @sei-js/create-sei app -n my-app -f vite
63-
```
64-
65-
</CodeGroup>
66-
6753
### CLI Options
6854

69-
| Flag | Long Form | Description | Options |
70-
|------|-----------|-------------|---------|
71-
| `-n` | `--name` | Project name (must be valid package name) | Any valid npm package name |
72-
| `-f` | `--framework` | Frontend framework | `vite`, `next` |
55+
- `app`: Create a new Sei dApp
56+
- `--name`: Project name (must be valid package name)
57+
- `--extension`: Add one of the optional extensions to your project
58+
59+
- `list-extensions`: List the available extensions
7360

7461
<Info>
7562
**Template Combinations**: The CLI creates different project templates based on your flag combinations. See all available combinations on the [Templates page](/create-sei/templates).
@@ -79,10 +66,10 @@ npx @sei-js/create-sei app -n my-app -f vite
7966

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

82-
- **Project Structure Created** - Organized file structure with components, hooks, and utilities properly scaffolded for your chosen framework and ecosystem.
69+
- **Project Structure Created** - Organized file structure with components, hooks, and utilities properly scaffolded.
8370

8471
- **Wallet Integration Ready** - Pre-configured wallet connections and connection hooks ready to use.
8572

86-
- **Development Tools Configured** - TypeScript, ESLint, Prettier, and Tailwind CSS automatically configured with sensible defaults and ready for immediate development.
73+
- **Development Tools Configured** - TypeScript, Biome, Mantine UI, and Tailwind CSS automatically configured with sensible defaults and ready for immediate development.
8774

8875
- **Sei Network Integration** - Built-in Sei network configuration and contract interaction examples to help you start building on Sei right away.

docs/create-sei/templates.mdx

Lines changed: 25 additions & 42 deletions
Original file line numberDiff line numberDiff line change
@@ -8,70 +8,53 @@ icon: "grid-2"
88
**New to @sei-js/create-sei?** Check out our [Quick Start guide](/create-sei/quick-start) for step-by-step instructions on getting started. This page is a reference for all available template combinations.
99
</Info>
1010

11-
## Choose a Template
11+
## Default Template
1212

13-
<CardGroup cols={1}>
1413
<Card
1514
title="Next.js + Wagmi (EVM)"
1615
icon="react"
1716
>
1817
Production-ready Next.js application with Wagmi for type-safe Ethereum wallet connections and blockchain interactions. Includes built-in support for MetaMask, WalletConnect, Coinbase Wallet, and other popular wallets. Best for full-stack dApps requiring server-side rendering, SEO optimization, and robust wallet integration.
1918

20-
<br/>
21-
22-
**CLI Flags:** `-f next -e evm -l wagmi`
23-
2419
<br/>
2520

2621
**Tech Stack:** `Next.js 14` `Wagmi v2` `Viem` `TanStack Query` `Tailwind CSS`
2722

2823
```bash
29-
npx @sei-js/create-sei app -n my-app -f next -e evm -l wagmi
24+
npx @sei-js/create-sei app --name my-sei-app
3025
```
3126
</Card>
3227

28+
---
29+
30+
## Extensions
31+
32+
Enhance your templates with additional functionality using extensions:
33+
34+
<CardGroup cols={1}>
3335
<Card
34-
title="Vite + Wagmi (EVM)"
35-
icon="bolt"
36+
title="List Available Extensions"
37+
icon="list"
3638
>
37-
Ultra-fast development environment with Vite's instant hot module replacement and Wagmi's type-safe wallet connections. Features automatic wallet detection, connection state management, and optimized bundle sizes. Perfect for rapid prototyping, development testing, and single-page applications requiring fast iteration cycles.
38-
39-
<br/>
39+
View all available extensions that can be added to your project:
4040

41-
**CLI Flags:** `-f vite -e evm -l wagmi`
41+
```bash
42+
npx @sei-js/create-sei list-extensions
43+
```
44+
</Card>
45+
46+
<Card
47+
title="Precompiles Extension"
48+
icon="database"
49+
>
50+
Add Sei precompile contract integration with examples for querying native blockchain data like token supply, staking info, and governance proposals. Perfect for dApps that need to interact with Sei's built-in smart contracts.
4251

4352
<br/>
44-
45-
**Tech Stack:** `Vite` `React 18` `TypeScript` `Wagmi v2` `Viem` `TanStack Query`
53+
54+
**Features:** Bank precompile, Staking precompile, Governance precompile examples
4655

4756
```bash
48-
npx @sei-js/create-sei app -n my-app -f vite -e evm -l wagmi
57+
npx @sei-js/create-sei app --name my-sei-precompile-app --extension precompiles
4958
```
5059
</Card>
5160
</CardGroup>
52-
53-
---
54-
## What's Included
55-
56-
Each template includes these essential features:
57-
58-
<CardGroup cols={2}>
59-
<Card title="Wallet Connection" icon="wallet">
60-
Ready-to-use wallet connection with support for MetaMask, WalletConnect, and other popular wallets
61-
</Card>
62-
<Card title="Network Configuration" icon="network-wired">
63-
Pre-configured for Sei mainnet, Atlantic-2 testnet, and devnet environments
64-
</Card>
65-
<Card title="Type Safety" icon="shield-check">
66-
Full TypeScript support with proper type definitions for contracts and blockchain interactions
67-
</Card>
68-
<Card title="Modern Tooling" icon="wrench">
69-
ESLint, Prettier, and modern development tools configured out of the box
70-
</Card>
71-
<Card title="Responsive Design" icon="mobile">
72-
Mobile-first responsive layouts with Tailwind CSS utility classes
73-
</Card>
74-
<Card title="Error Handling" icon="exclamation-triangle">
75-
Comprehensive error boundaries and user feedback for blockchain interactions
76-
</Card>
77-
</CardGroup>

docs/create-sei/welcome.mdx

Lines changed: 4 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -6,16 +6,12 @@ icon: "hammer"
66

77
## Overview
88

9-
`@sei-js/create-sei` is a CLI tool that scaffolds production-ready Sei dApps in seconds. Choose from EVM or Cosmos templates with Next.js/Vite, modern wallet integration, and TypeScript support.
9+
`@sei-js/create-sei` is a CLI tool that scaffolds production-ready Sei dApps in seconds. Quickly spin up templates with Next.js/Vite, modern wallet integration, and TypeScript support.
1010

1111
```bash
12-
npx @sei-js/create-sei app -n my-sei-app -f next
12+
npx @sei-js/create-sei app --name my-sei-app
1313
```
1414

15-
<Warning>
16-
**Cosmos Deprecation**: Per [SIP-3](https://github.com/sei-protocol/sei-improvement-proposals/blob/main/SIPS/sip-3.md), Sei is transitioning to EVM only. Use EVM templates for new projects.
17-
</Warning>
18-
1915
<CardGroup cols={2}>
2016
<Card title="EVM Templates" icon="ethereum">
2117
Modern Ethereum-compatible development with Wagmi/Viem or Ethers.js
@@ -24,10 +20,10 @@ npx @sei-js/create-sei app -n my-sei-app -f next
2420
Next.js for full-stack apps, Vite for lightweight builds
2521
</Card>
2622
<Card title="Production Ready" icon="rocket">
27-
TypeScript, Tailwind CSS, ESLint, wallet connections included
23+
TypeScript, Tailwind CSS, Mantine, Biome, and wallet connections included
2824
</Card>
2925
</CardGroup>
3026

3127
## What's Included
3228

33-
Every project includes wallet connections, contract interactions, TypeScript, Tailwind CSS, ESLint, and responsive layouts. No additional setup required.
29+
Every project includes wallet connections, contract interactions, TypeScript, Tailwind CSS, Biome for formatting, and responsive layouts. No additional setup required.

docs/sei-global-wallet/dynamic-nextjs.mdx

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -470,7 +470,7 @@ const nextConfig = {
470470
removeConsole: process.env.NODE_ENV === 'production',
471471
},
472472
webpack: (config) => {
473-
config.externals.push('pino-pretty', 'lokijs', 'encoding');
473+
config.externals.push('lokijs', 'encoding');
474474
return config;
475475
},
476476
};
@@ -502,7 +502,7 @@ module.exports = nextConfig;
502502
**Solution:** Add webpack externals to your `next.config.js`:
503503
```javascript
504504
webpack: (config) => {
505-
config.externals.push('pino-pretty', 'lokijs', 'encoding');
505+
config.externals.push('lokijs', 'encoding');
506506
return config;
507507
}
508508
```
346 KB
Binary file not shown.
Lines changed: 44 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,44 @@
1+
{
2+
"name": "template-next-create-sei-app-precompiles",
3+
"version": "0.1.0",
4+
"private": true,
5+
"scripts": {
6+
"dev": "next dev",
7+
"build": "next build",
8+
"start": "next start",
9+
"lint": "biome lint .",
10+
"lint:fix": "biome lint --write .",
11+
"format": "biome format --write .",
12+
"format:check": "biome format .",
13+
"check": "biome check .",
14+
"check:fix": "biome check --write .",
15+
"deploy": "vercel --prod"
16+
},
17+
"dependencies": {
18+
"@mantine/code-highlight": "^8.2.5",
19+
"@mantine/core": "^8.2.5",
20+
"@mantine/hooks": "^8.2.5",
21+
"@mantine/notifications": "^8.2.5",
22+
"@rainbow-me/rainbowkit": "^2.2.8",
23+
"@sei-js/precompiles": "^2.1.2",
24+
"@tabler/icons-react": "^3.34.1",
25+
"@tailwindcss/postcss": "^4.1.12",
26+
"@tanstack/react-query": "^5.85.3",
27+
"ethers": "^6.15.0",
28+
"next": "15.4.7",
29+
"pino-pretty": "^13.1.1",
30+
"react": "^19.1.1",
31+
"react-dom": "^19.1.1",
32+
"viem": "^2.34.0",
33+
"wagmi": "^2.16.4"
34+
},
35+
"devDependencies": {
36+
"@types/node": "^24.3.0",
37+
"@types/react": "^19.1.10",
38+
"@types/react-dom": "^19.1.7",
39+
"autoprefixer": "^10.4.21",
40+
"postcss": "^8.4.45",
41+
"tailwindcss": "^4.1.12",
42+
"typescript": "^5.9.2"
43+
}
44+
}

0 commit comments

Comments
 (0)