@sei-js/create-sei 1.0.1 → 2.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024-2026 Sei Labs
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -9,7 +9,7 @@
 
 **Scaffold new Sei applications with pre-configured templates and tooling**
 
-[Documentation](https://sei-js.docs.sei.io/create-sei/welcome) • [GitHub](https://github.com/sei-protocol/sei-js) • [NPM](https://www.npmjs.com/package/@sei-js/create-sei) • [Telegram](https://t.me/+LPW_1djQwRQwMzlk)
+[GitHub](https://github.com/sei-protocol/sei-js) • [NPM](https://www.npmjs.com/package/@sei-js/create-sei) • [Telegram](https://t.me/+LPW_1djQwRQwMzlk)
 
 </div>
 
@@ -19,9 +19,10 @@
 npx @sei-js/create-sei app -n my-sei-app
 ```
 
-## 📚 Documentation
+Generated applications require Bun 1.3.14 or newer. Their dependency overrides and smoke coverage are Bun-specific; using npm, Yarn, or pnpm can resolve a different, unverified security graph.
 
-For complete documentation, examples, and guides, visit:
-**[sei-js.docs.sei.io/create-sei](https://sei-js.docs.sei.io/create-sei/welcome)**
+## Release verification
 
+Pull requests run `auto` mode in the dedicated create-sei smoke workflow. It uses a local candidate when pending Changesets computes the template's exact `@sei-js/precompiles` pin, or when a Version Packages PR has already set the local manifest to that exact version. Otherwise it validates the exact published npm version. A mismatched source tree is never relabeled as an older package.
 
+After `@sei-js/precompiles` has been staged to npm, dispatch the same workflow in `registry` mode. Registry mode always leaves the generated manifest untouched and verifies npm resolves the exact template pin. Audit findings are report-only in registry mode; local candidate mode blocks only on high or critical findings while reporting lower severities.

package/dist/extensions/precompiles/src/components/default/index.tsx

@@ -1,27 +1,24 @@
-'use client';
-
-import React from 'react';
-import { CodeHighlight } from '@mantine/code-highlight';
-import { ActionIcon, Badge, Button, Card, Collapse, Container, Flex, Group, Paper, Stack, Text, ThemeIcon, Title } from '@mantine/core';
-import { notifications } from '@mantine/notifications';
-import { BANK_PRECOMPILE_ADDRESS, VIEM_BANK_PRECOMPILE_ABI } from '@sei-js/precompiles';
-import { IconBulb, IconChevronDown, IconChevronUp, IconCopy, IconDatabase } from '@tabler/icons-react';
-import { useState } from 'react';
-import { type ReadContractParameters, formatEther } from 'viem';
-import { useAccount, usePublicClient } from 'wagmi';
+"use client";
+
+import { CodeHighlight } from "@mantine/code-highlight";
+import { ActionIcon, Badge, Button, Card, Collapse, Container, Flex, Group, Paper, Stack, Text, ThemeIcon, Title } from "@mantine/core";
+import { notifications } from "@mantine/notifications";
+import { BANK_PRECOMPILE_ABI, BANK_PRECOMPILE_ADDRESS } from "@sei-js/precompiles";
+import { IconBulb, IconChevronDown, IconChevronUp, IconCopy, IconDatabase } from "@tabler/icons-react";
+import { useState } from "react";
+import { usePublicClient } from "wagmi";
 
 function Examples() {
-	const [supply, setSupply] = useState('');
+	const [supply, setSupply] = useState("");
 	const [showCode, setShowCode] = useState(false);
 
 	const publicClient = usePublicClient();
-	const { address } = useAccount();
 
 	const formatLargeSeiNumber = (num: string, decimals: number): string => {
 		if (num.length > 10) {
 			return `${(Number(num) / 1000000 / 1000000000).toLocaleString(navigator.language, {
 				minimumFractionDigits: decimals,
-				maximumFractionDigits: decimals
+				maximumFractionDigits: decimals,
 			})} B`;
 		}
 		return (Number(num) / 1000000).toLocaleString(navigator.language);
@@ -31,17 +28,17 @@ function Examples() {
 		try {
 			navigator.clipboard.writeText(text).then(() => {
 				notifications.show({
-					title: 'Copied!',
-					message: 'Code copied to clipboard',
-					color: 'green'
+					title: "Copied!",
+					message: "Code copied to clipboard",
+					color: "green",
 				});
 			});
 		} catch (err) {
-			console.error('Failed to copy text: ', err);
+			console.error("Failed to copy text: ", err);
 			notifications.show({
-				title: 'Error',
-				message: 'Failed to copy to clipboard',
-				color: 'red'
+				title: "Error",
+				message: "Failed to copy to clipboard",
+				color: "red",
 			});
 		}
 	};
@@ -51,42 +48,38 @@ function Examples() {
 			return undefined;
 		}
 
-		const readContractParams: ReadContractParameters = {
-			abi: VIEM_BANK_PRECOMPILE_ABI,
-			address: BANK_PRECOMPILE_ADDRESS,
-			functionName: 'supply',
-			args: ['usei']
-		};
-
 		try {
-			const result = await publicClient.readContract(readContractParams);
-			setSupply((result as bigint).toString());
+			const result = await publicClient.readContract({
+				abi: BANK_PRECOMPILE_ABI,
+				address: BANK_PRECOMPILE_ADDRESS,
+				functionName: "supply",
+				args: ["usei"],
+			});
+			setSupply(result.toString());
 		} catch (error) {
-			console.error('Error fetching supply:', error);
+			console.error("Error fetching supply:", error);
 			notifications.show({
-				title: 'Error',
-				message: 'Failed to fetch SEI supply',
-				color: 'red'
+				title: "Error",
+				message: "Failed to fetch SEI supply",
+				color: "red",
 			});
 		}
 	};
 
 	const codeExample = `// Sei Precompile Example - Bank Precompile
-import { BANK_PRECOMPILE_ADDRESS, VIEM_BANK_PRECOMPILE_ABI } from '@sei-js/precompiles';
+import { BANK_PRECOMPILE_ABI, BANK_PRECOMPILE_ADDRESS } from '@sei-js/precompiles';
 import { usePublicClient } from 'wagmi';
 
 const publicClient = usePublicClient();
 
 const getSeiSupply = async () => {
-  const readContractParams = {
-    abi: VIEM_BANK_PRECOMPILE_ABI,
+  const result = await publicClient?.readContract({
+    abi: BANK_PRECOMPILE_ABI,
     address: BANK_PRECOMPILE_ADDRESS,
     functionName: 'supply',
     args: ['usei'],
-  };
-
-  const result = await publicClient?.readContract(readContractParams);
-  return (result as bigint).toString();
+  });
+  return result?.toString();
 };`;
 
 	return (
@@ -95,11 +88,11 @@ const getSeiSupply = async () => {
 				{/* Header */}
 				<div>
 					<Group gap="md" align="center" mb="lg">
-						<ThemeIcon size={48} radius="md" c="orange" variant="light">
+						<ThemeIcon size={48} radius="md" variant="outline" color="seiMaroon">
 							<IconBulb size={24} />
 						</ThemeIcon>
 						<div>
-							<Title order={1} fw={700} c="gray.9">
+							<Title order={1} fw={700} c="seiMaroon.9" className="sei-heading">
 								Sei Precompiles
 							</Title>
 							<Text size="lg" c="gray.6" mt={4}>
@@ -115,7 +108,7 @@ const getSeiSupply = async () => {
 						<Flex justify="space-between" align="flex-start">
 							<Stack gap="xs">
 								<Group gap="md">
-									<ThemeIcon size={40} radius="md" color="orange" variant="light">
+									<ThemeIcon size={40} radius="md" variant="outline" color="seiMaroon">
 										<IconDatabase size={20} />
 									</ThemeIcon>
 									<Title order={3} fw={600} c="gray.9">
@@ -123,13 +116,13 @@ const getSeiSupply = async () => {
 									</Title>
 								</Group>
 								<Text size="sm" c="gray.6">
-									Query total SEI supply using Sei's native{' '}
-									<Text component="a" href="https://www.docs.sei.io/dev-interoperability/precompiles/bank" target="_blank" c="orange" td="underline">
+									Query total SEI supply using Sei's native{" "}
+									<Text component="a" href="https://docs.sei.io/evm/precompiles/cosmwasm-precompiles/bank" target="_blank" c="seiMaroon.9" td="underline">
 										Bank precompile
 									</Text>
 								</Text>
 							</Stack>
-							<Badge color="orange" variant="light" size="md" radius="md">
+							<Badge variant="outline" color="gray" size="md" radius="md">
 								precompiles
 							</Badge>
 						</Flex>
@@ -142,7 +135,7 @@ const getSeiSupply = async () => {
 								<Flex align="baseline" gap="xs">
 									{supply ? (
 										<>
-											<Text fw={700} size="xl" c="gray.9" ff="monospace">
+											<Text fw={700} size="xl" c="seiGold.9" ff="var(--sei-font-mono)">
 												{formatLargeSeiNumber(supply, 2)}
 											</Text>
 											<Text size="sm" c="gray.6" fw={500}>
@@ -162,8 +155,8 @@ const getSeiSupply = async () => {
 										</Paper>
 									)}
 								</Flex>
-								<Button onClick={getSeiSupply} size="sm" radius="md" variant="light" color="orange" leftSection={<IconDatabase size={14} />}>
-									{supply ? 'Refresh' : 'Query Supply'}
+								<Button onClick={getSeiSupply} size="sm" radius="md" variant="filled" color="seiMaroon" leftSection={<IconDatabase size={14} />}>
+									{supply ? "Refresh" : "Query Supply"}
 								</Button>
 							</Flex>
 						</Paper>
@@ -177,7 +170,7 @@ const getSeiSupply = async () => {
 								leftSection={showCode ? <IconChevronUp size={14} /> : <IconChevronDown size={14} />}
 								onClick={() => setShowCode(!showCode)}
 							>
-								{showCode ? 'Hide' : 'View'} Implementation
+								{showCode ? "Hide" : "View"} Implementation
 							</Button>
 							{showCode && (
 								<ActionIcon variant="subtle" color="gray" size="sm" radius="md" onClick={() => copyToClipboard(codeExample)}>

package/dist/main.js

@@ -1,11 +1,10 @@
 #!/usr/bin/env node
-import boxen from 'boxen';
-import inquirer from 'inquirer';
 import fs from 'node:fs';
-import path from 'node:path';
-import { dirname } from 'node:path';
+import path, { dirname } from 'node:path';
 import { fileURLToPath } from 'node:url';
+import boxen from 'boxen';
 import { Command } from 'commander';
+import inquirer from 'inquirer';
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
 const program = new Command();
@@ -15,19 +14,21 @@ const printWelcomeMessage = () => {
         padding: 1,
         margin: 1,
         borderStyle: 'double',
-        borderColor: '#932C23'
+        borderColor: '#600014'
     }));
 };
-function isValidDirectoryName(dirName) {
-    const illegalRe = /[<>:"/\\|?*]/g;
-    const windowsReservedRe = /^(con|prn|aux|nul|com[1-9]|lpt[1-9])$/i;
-    const trailingRe = /[. ]+$/;
-    const validNpmPackageRe = /^(?:@[a-z0-9-*~][a-z0-9-*._~]*)?[a-z0-9-~][a-z0-9-._~]*$/;
-    if (typeof dirName !== 'string' || dirName.length === 0) {
+const MAX_NPM_PACKAGE_NAME_LENGTH = 214;
+const validNpmProjectNameRe = /^[a-z0-9][a-z0-9._-]*$/;
+const windowsReservedNameRe = /^(?:con|prn|aux|nul|com[1-9]|lpt[1-9])(?:\.|$)/i;
+function isValidProjectName(projectName) {
+    if (typeof projectName !== 'string' || projectName.length === 0 || projectName.length > MAX_NPM_PACKAGE_NAME_LENGTH) {
         return false;
     }
-    // Check for illegal characters, Windows reserved names, trailing spaces/dots
-    if (illegalRe.test(dirName) || windowsReservedRe.test(dirName) || trailingRe.test(dirName) || !validNpmPackageRe.test(dirName)) {
+    if (projectName === 'node_modules' ||
+        projectName === 'favicon.ico' ||
+        projectName.endsWith('.') ||
+        windowsReservedNameRe.test(projectName) ||
+        !validNpmProjectNameRe.test(projectName)) {
         return false;
     }
     return true;
@@ -35,18 +36,28 @@ function isValidDirectoryName(dirName) {
 const validateOptions = (options) => {
     let valid = true;
     if (options.name) {
-        if (!isValidDirectoryName(options.name)) {
-            console.log('Invalid package name. Please use a valid npm package name.');
+        if (!isValidProjectName(options.name)) {
+            console.error('Invalid package name. Please use a valid npm package name.');
             valid = false;
         }
     }
     return valid;
 };
+const extensionsPath = path.join(__dirname, 'extensions');
+function printCliError(error) {
+    if (process.env.DEBUG && error instanceof Error) {
+        console.error(error.stack ?? error);
+        return;
+    }
+    console.error('An error occurred:', error instanceof Error ? error.message : error);
+}
+async function discoverExtensions() {
+    const extensions = await fs.promises.readdir(extensionsPath, { withFileTypes: true });
+    return extensions.filter((dirent) => dirent.isDirectory()).map((dirent) => dirent.name);
+}
 async function listExtensions() {
-    const extensionsPath = path.join(__dirname, 'extensions');
     try {
-        const extensions = await fs.promises.readdir(extensionsPath, { withFileTypes: true });
-        const extensionDirs = extensions.filter((dirent) => dirent.isDirectory()).map((dirent) => dirent.name);
+        const extensionDirs = await discoverExtensions();
         if (extensionDirs.length === 0) {
             console.log('No extensions available.');
             return;
@@ -56,15 +67,67 @@ async function listExtensions() {
             console.log(`  - ${ext}`);
         }
     }
-    catch (error) {
+    catch (_error) {
         console.log('No extensions directory found.');
     }
 }
+function isDirectChildName(name) {
+    return name.length > 0 && name !== '.' && name !== '..' && !name.includes('/') && !name.includes('\\') && !name.includes('\0');
+}
+async function resolveExtension(extension) {
+    if (!extension) {
+        return {};
+    }
+    if (!isDirectChildName(extension)) {
+        throw new Error(`Invalid extension '${extension}'. Extensions must be selected by name from list-extensions.`);
+    }
+    let extensionDirs;
+    try {
+        extensionDirs = await discoverExtensions();
+    }
+    catch (error) {
+        if (error.code !== 'ENOENT') {
+            throw error;
+        }
+        extensionDirs = [];
+    }
+    if (!extensionDirs.includes(extension)) {
+        return { warning: `Warning: Extension '${extension}' not found. Continuing with base template.` };
+    }
+    return {
+        extension: {
+            name: extension,
+            source: path.join(extensionsPath, extension)
+        }
+    };
+}
+async function copyDirectoryContents(source, destination, overwrite) {
+    const entries = await fs.promises.readdir(source, { withFileTypes: true });
+    for (const entry of entries) {
+        await fs.promises.cp(path.join(source, entry.name), path.join(destination, entry.name), {
+            recursive: true,
+            force: overwrite,
+            errorOnExist: !overwrite
+        });
+    }
+}
+async function writeProjectName(destination, projectName) {
+    const manifestPath = path.join(destination, 'package.json');
+    const manifest = JSON.parse(await fs.promises.readFile(manifestPath, 'utf8'));
+    manifest.name = projectName;
+    await fs.promises.writeFile(manifestPath, `${JSON.stringify(manifest, null, '\t')}\n`);
+}
 async function runWizard(options) {
     if (!validateOptions(options)) {
+        process.exitCode = 1;
         return;
     }
+    const extensionResolution = await resolveExtension(options.extension);
     printWelcomeMessage();
+    if (extensionResolution.warning) {
+        console.warn(extensionResolution.warning);
+    }
+    const extension = extensionResolution.extension;
     let dAppName = '';
     if (options.name) {
         dAppName = options.name;
@@ -76,7 +139,7 @@ async function runWizard(options) {
                 name: 'dAppName',
                 message: 'What is your dApp (project) name?',
                 validate: (input) => {
-                    return isValidDirectoryName(input) || 'Invalid package name. Please use a valid npm package name.';
+                    return isValidProjectName(input) || 'Invalid package name. Please use a valid npm package name.';
                 }
             }
         ]);
@@ -86,34 +149,48 @@ async function runWizard(options) {
     const templateName = 'next-template';
     const templatePath = path.join(__dirname, 'templates', templateName);
     const dst = path.join(process.cwd(), dAppName);
-    await fs.promises.cp(templatePath, dst, { recursive: true });
-    // Apply extension if specified
-    if (options.extension) {
-        const extensionPath = path.join(__dirname, 'extensions', options.extension);
+    let destinationCreated = false;
+    try {
         try {
-            await fs.promises.access(extensionPath);
-            await fs.promises.cp(extensionPath, dst, { recursive: true });
-            console.log(`Applied extension: ${options.extension}`);
+            await fs.promises.mkdir(dst);
+            destinationCreated = true;
         }
         catch (error) {
-            console.log(`Warning: Extension '${options.extension}' not found. Continuing with base template.`);
+            if (error.code === 'EEXIST') {
+                throw new Error(`Destination '${dAppName}' already exists. Choose a different project name.`);
+            }
+            throw error;
+        }
+        await copyDirectoryContents(templatePath, dst, false);
+        if (extension) {
+            await copyDirectoryContents(extension.source, dst, true);
+            console.log(`Applied extension: ${extension.name}`);
+        }
+        await fs.promises.rename(path.join(dst, 'gitignore'), path.join(dst, '.gitignore'));
+        await writeProjectName(dst, dAppName);
+    }
+    catch (error) {
+        if (destinationCreated) {
+            await fs.promises.rm(dst, { recursive: true, force: true });
         }
+        throw error;
     }
-    const extensionText = options.extension ? ` with ${options.extension} extension` : '';
+    const extensionText = extension ? ` with ${extension.name} extension` : '';
     console.log(`Project setup complete! Using template ${templateName}${extensionText}\n`);
-    console.log(`To start your app, run: \n > cd ${dAppName} \n > pnpm \n > pnpm dev\n`);
+    console.log(`To start your app, run: \n > cd "./${dAppName}" \n > bun install \n > bun run dev\n`);
 }
 program
     .command('app')
     .description('Create a new SEI dApp')
-    .option('--name <name>', 'Specify the name of your dApp. Name must be a valid package name.')
+    .option('-n, --name <name>', 'Specify the name of your dApp. Name must be a valid package name.')
     .option('--extension <extension>', 'Specify an extension to apply to the base template')
     .action(async (options) => {
     try {
         await runWizard(options);
     }
     catch (error) {
-        console.error('An error occurred:', error);
+        printCliError(error);
+        process.exitCode = 1;
     }
 });
 program
@@ -124,7 +201,8 @@ program
         await listExtensions();
     }
     catch (error) {
-        console.error('An error occurred:', error);
+        printCliError(error);
+        process.exitCode = 1;
     }
 });
-program.parse(process.argv);
+await program.parseAsync(process.argv);

package/dist/templates/next-template/.env.example

@@ -1,5 +1,5 @@
 # Chain configuration
-# Options: mainnet, testnet, devnet
+# Options: mainnet, testnet
 # Defaults to mainnet if not set; this example overrides it to testnet
 NEXT_PUBLIC_CHAIN=testnet
 

package/dist/templates/next-template/README.md

@@ -1,54 +1,84 @@
-This is a [Next.js](https://nextjs.org/) project bootstrapped with [`create-next-app`](https://github.com/vercel/next.js/tree/canary/packages/create-next-app).
+# Sei dApp starter
 
-## Getting Started
+This app was generated by `@sei-js/create-sei`. It uses Next.js, Wagmi, Viem, RainbowKit, Mantine, and Tailwind CSS.
+
+## Package manager
+
+Bun 1.3.14 or newer is required for this starter. Its security overrides and release smoke are validated with Bun; npm, Yarn, and pnpm do not share one override contract and may silently resolve a different dependency graph.
+
+The generated project intentionally does not ship a lockfile. Exact direct pins reduce drift, but transitive dependencies are resolved when you run `bun install`; the dedicated smoke validates the current graph rather than claiming every future install is byte-for-byte reproducible. Commit the resulting `bun.lock` after your first reviewed install.
+
+## Run locally
+
+Install the dependencies and start the development server:
 
-Install dependencies by running
 ```bash
 bun install
+bun run dev
 ```
 
-Then, run the development server:
+Open [http://localhost:3000](http://localhost:3000).
+
+## Check and build
+
+Run `bun run check` before building. If it reports fixable issues, run `bun run check:fix`. The build's prebuild hook runs the same check.
 
 ```bash
-bun run dev
+bun run check
+bun run build
 ```
 
-Open [http://localhost:3000](http://localhost:3000) with your browser to see the result.
+## Image handling
+
+Next.js image optimization is disabled so the generated app needs no native Sharp build. Turning it on is a template choice rather than a security tradeoff.
 
-You can start editing the page by modifying `src/app/page.tsx`. The page auto-updates as you edit the file.
+The manifest's `sharp` override is a separate matter and has to stay. The pinned Next 15 line declares Sharp `^0.34.3 || ^0.35.4`, and the `0.34.x` half of that range is still inside [GHSA-rgj7-g3m4-5g8c](https://github.com/advisories/GHSA-rgj7-g3m4-5g8c), so `0.35.4` is the advisory floor. Loosening or removing the override reintroduces a high audit finding whether or not optimization is enabled.
 
-This project uses [`next/font`](https://nextjs.org/docs/basic-features/font-optimization) to automatically optimize and load Inter, a custom Google Font.
+## Development bundler
 
-## Repository Basics
-This repository includes basic features that allow you to connect to a wallet and use the wallet to interact with the chain.
+`bun run dev` uses the Next 15 webpack default. Do not add `--turbopack`: the pinned Next 15 line cannot express the required `false` alias for MetaMask SDK's mobile-only storage import in Turbopack without adding a synthetic replacement module. The production build and smoke use the validated webpack alias in `next.config.mjs`.
 
-Additionally, basic examples and links to documentation are provided on the example homepage in `src/app/components/Homepage`.
+## Sei brand
 
-This repository uses helper methods from [@sei-js/evm/viem](https://github.com/sei-protocol/sei-js/tree/main/packages/evm/src/viem)
+The assets in `public/brand` come unchanged from the [official Sei brand kit](https://brand.sei.io). The primary lockup is used in the header, the horizontal “Powered by Sei” asset appears in the footer, and the standalone mark is reserved for app-icon metadata. Preserve their proportions and clearspace; do not redraw or recolor them.
 
-### Web3 Provider
-This component is a Sei specific wrapper around a Wagmi Provider that should wrap the application. Wrapping the application in this provider will enable it to access hooks in Wagmi. These hooks are enable connection to a wallet and interaction with the chain.
+Black and white are the base palette. `--sei-maroon` (`#600014`) is reserved for primary actions and headlines, while `--sei-gold` (`#966F22`) is reserved for large or bold data and non-text highlights, not normal-size text on light surfaces. Reusable palette and typography tokens live in `src/app/globals.css`.
 
-In addition, this app uses [RainbowKit](https://www.rainbowkit.com/docs/wallet-button) which provides wallet connect functionality out of the box.
+The Mantine theme maps `gray` to the official neutral ramp; ordinary and dimmed text resolves to `#666666` or darker for accessible contrast on white and `#F5F5F7`.
 
-To change the list of supported wallets, as well as connection configurations you can modify the `src/app/components/Web3Provider.tsx` component.
+The public brand archive does not include the proprietary Lateral or ABC Repro Mono font files, so this starter uses license-safe system fallback stacks. Teams with appropriately licensed fonts can map Lateral and ABC Repro Mono to the documented CSS font tokens.
 
-### Changing the Chain
-This application connects to the arctic-1 devnet by default, using chain configurations uploaded to viem.
+## Project structure
 
-To change the chain the app connects to, edit the `selectedChain` variable in the `chain.ts` file in `src/app/constants`
+- `src/app/layout.tsx` wraps every route with the wallet and UI providers.
+- `src/app/favicon.ico/route.ts` redirects conventional favicon requests to the unchanged official app mark.
+- `src/app/page.tsx` shows the landing page until a wallet connects, then shows the interactive examples.
+- `src/components/providers/providers.tsx` configures Wagmi, RainbowKit, and the selected Sei network. It registers the injected browser-wallet connector by default; add other wallets to its `wallets` list.
+- `src/components/shell/shell.tsx` provides the shared app shell around the landing and connected views.
+- `src/components/landing/index.tsx` contains the disconnected landing page.
+- `src/components/default/index.tsx` contains the connected wallet, balance, and transaction examples.
+- `src/app/development/page.tsx` and `src/app/resources/page.tsx` contain development notes and links.
 
-## Learn More
+## Network configuration
 
-To learn more about Next.js, take a look at the following resources:
+The app connects to Sei mainnet when `NEXT_PUBLIC_CHAIN` is unset. The included `.env.example` sets it to `testnet`, so copying that file to `.env.local` selects Sei testnet. To select testnet explicitly, add this to `.env.local`:
 
-- [Next.js Documentation](https://nextjs.org/docs) - learn about Next.js features and API.
-- [Learn Next.js](https://nextjs.org/learn) - an interactive Next.js tutorial.
+```dotenv
+NEXT_PUBLIC_CHAIN=testnet
+```
+
+WalletConnect-based wallets require a real project ID from [WalletConnect Cloud](https://cloud.walletconnect.com). Set it in `.env.local`:
 
-You can check out [the Next.js GitHub repository](https://github.com/vercel/next.js/) - your feedback and contributions are welcome!
+```dotenv
+NEXT_PUBLIC_WALLETCONNECT_PROJECT_ID=your-project-id
+```
 
-## Deploy on Vercel
+The fallback value in the template is only a placeholder, so WalletConnect-based wallets will not connect until you replace it. The bundled injected connector works without a WalletConnect project ID for installed browser wallets such as MetaMask.
 
-The easiest way to deploy your Next.js app is to use the [Vercel Platform](https://vercel.com/new?utm_medium=default-template&filter=next.js&utm_source=create-next-app&utm_campaign=create-next-app-readme) from the creators of Next.js.
+## Learn more
 
-Check out our [Next.js deployment documentation](https://nextjs.org/docs/deployment) for more details.
+- [Sei documentation](https://docs.sei.io/)
+- [Next.js documentation](https://nextjs.org/docs)
+- [Wagmi documentation](https://wagmi.sh/react/getting-started)
+- [Viem documentation](https://viem.sh/)
+- [RainbowKit documentation](https://www.rainbowkit.com/docs/introduction)

package/dist/templates/next-template/biome.json

@@ -1,5 +1,5 @@
 {
-	"$schema": "https://biomejs.dev/schemas/2.4.5/schema.json",
+	"$schema": "https://biomejs.dev/schemas/2.5.8/schema.json",
 	"root": true,
 	"assist": {
 		"actions": {
@@ -11,7 +11,7 @@
 	"linter": {
 		"enabled": true,
 		"rules": {
-			"recommended": true,
+			"preset": "recommended",
 			"style": {
 				"noNonNullAssertion": "off"
 			},
@@ -50,7 +50,6 @@
 		}
 	},
 	"files": {
-		"includes": ["src/**/*.ts", "src/**/*.tsx", "src/**/*.css", "*.json", "*.md"],
-		"ignore": ["node_modules/**", "dist/**", ".next/**", ".yarn/**"]
+		"includes": ["src/**/*.ts", "src/**/*.tsx", "src/**/*.css", "*.json", "*.md", "!**/node_modules", "!**/dist", "!**/.next", "!**/.yarn"]
 	}
 }

package/dist/templates/next-template/gitignore

@@ -0,0 +1,41 @@
+# Dependencies
+/node_modules
+/.pnp
+.pnp.*
+.yarn/*
+!.yarn/patches
+!.yarn/plugins
+!.yarn/releases
+!.yarn/versions
+
+# Tests
+/coverage
+
+# Next.js
+/.next/
+/out/
+
+# Production
+/build
+
+# Local files
+.DS_Store
+*.pem
+
+# Debug logs
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+pnpm-debug.log*
+bun-debug.log*
+
+# Environment files (keep the example)
+.env*
+!.env.example
+
+# Vercel
+.vercel
+
+# TypeScript
+*.tsbuildinfo
+next-env.d.ts